이 문서는 영어 원문을 자동 번역한 것으로, 내용이 원문과 다를 수 있습니다.영어 원문 보기

벡터 스토어 검색

자연어 쿼리로 벡터 스토어를 검색합니다.

POST

/vector_stores/{vector_store_id}/search

인증

`Authorization`
필수
Bearer <token>

위치: header

요청 본문

application/json필수

`query`
필수
string | array<string>

자연어 검색 쿼리입니다. 단일 문자열 또는 문자열 배열을 허용합니다.

참고: 다중 쿼리는 현재 OpenAI 호환성을 위해 배열 형식의 요청을 받기만 하는 임시 처리입니다. 배열을 전달하면 첫 번째 요소만 검색 임베딩 생성에 사용하고 이후 요소는 무시합니다. 이 경우 서버에 경고를 기록합니다. 다중 쿼리가 정식 지원되기 전까지는 예측 가능한 결과를 위해 단일 문자열을 전달하세요.

`max_num_results`integer

반환할 최대 결과 수입니다(1~20).

기본값: 5최솟값: 1최댓값: 20

`filters`object

검색 결과의 필터 조건입니다.

`ranking_options`object

입력은 허용하지만 시스템 기본 순위 지정 방식을 사용합니다.

`rewrite_query`boolean

입력은 허용하지만 시스템 기본 동작을 사용합니다.

경로 파라미터

`vector_store_id`
필수
string

벡터 스토어 ID입니다.

예시

요청

curl -X POST https://api.upstage.ai/v2/vector_stores/vs_abc123def456/search \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "How do I configure the system?",
    "max_num_results": 5
  }'

응답

{
  "object": "vector_store.search_results.page",
  "search_query": ["How do I configure the system?"],
  "data": [
    {
      "file_id": "file_xyz789",
      "filename": "product-guide.pdf",
      "score": 0.892,
      "attributes": {},
      "content": [
        {"type": "text", "text": "The matched text content from the document..."}
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

다중 쿼리 요청

query 필드는 OpenAI 요청 형식과의 호환성을 위해 문자열 배열을 허용하지만, 현재 검색 임베딩 생성에는 첫 번째 요소만 사용됩니다. 이후 요소는 무시되며 서버에 경고가 기록됩니다. 다중 쿼리가 정식 지원되기 전까지는 예측 가능한 결과를 위해 단일 문자열을 전달하세요.

curl -X POST https://api.upstage.ai/v2/vector_stores/vs_abc123def456/search \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": ["How do I configure the system?", "What are the default settings?"],
    "max_num_results": 5
  }'

위 요청은 "How do I configure the system?"만 전달한 경우와 동일하게 동작합니다. 두 번째 쿼리는 무시됩니다.

이 문서는 영어 원문을 자동 번역한 것으로, 내용이 원문과 다를 수 있습니다.영어 원문 보기

벡터 스토어 검색

자연어 쿼리로 벡터 스토어를 검색합니다.

POST

/vector_stores/{vector_store_id}/search

인증

`Authorization`
필수
Bearer <token>

위치: header

요청 본문

application/json필수

`query`
필수
string | array<string>

자연어 검색 쿼리입니다. 단일 문자열 또는 문자열 배열을 허용합니다.

`max_num_results`integer

반환할 최대 결과 수입니다(1~20).

기본값: 5최솟값: 1최댓값: 20

`filters`object

검색 결과의 필터 조건입니다.

`ranking_options`object

입력은 허용하지만 시스템 기본 순위 지정 방식을 사용합니다.

`rewrite_query`boolean

입력은 허용하지만 시스템 기본 동작을 사용합니다.

경로 파라미터

`vector_store_id`
필수
string

벡터 스토어 ID입니다.

예시

요청

curl -X POST https://api.upstage.ai/v2/vector_stores/vs_abc123def456/search \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "How do I configure the system?",
    "max_num_results": 5
  }'

응답

{
  "object": "vector_store.search_results.page",
  "search_query": ["How do I configure the system?"],
  "data": [
    {
      "file_id": "file_xyz789",
      "filename": "product-guide.pdf",
      "score": 0.892,
      "attributes": {},
      "content": [
        {"type": "text", "text": "The matched text content from the document..."}
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

다중 쿼리 요청

curl -X POST https://api.upstage.ai/v2/vector_stores/vs_abc123def456/search \
  -H "Authorization: Bearer $UPSTAGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": ["How do I configure the system?", "What are the default settings?"],
    "max_num_results": 5
  }'

위 요청은 "How do I configure the system?"만 전달한 경우와 동일하게 동작합니다. 두 번째 쿼리는 무시됩니다.

벡터 스토어 검색

인증

`Authorization`
필수
Bearer <token>

요청 본문

`query`
필수
string | array<string>

`max_num_results`integer

`filters`object

`ranking_options`object

`rewrite_query`boolean

경로 파라미터

`vector_store_id`
필수
string

예시

요청

응답

다중 쿼리 요청

이 페이지에서

벡터 스토어 검색

인증

`Authorization`
필수
Bearer <token>

요청 본문

`query`
필수
string | array<string>

`max_num_results`integer

`filters`object

`ranking_options`object

`rewrite_query`boolean

경로 파라미터

`vector_store_id`
필수
string

예시

요청

응답

다중 쿼리 요청

이 페이지에서

경로

본문

Authorization필수Bearer <token>

query필수string | array<string>

객체 1

max_num_resultsinteger

filtersobject

ranking_optionsobject

rewrite_queryboolean

vector_store_id필수string

응답

이 페이지에서

경로

본문

Authorization필수Bearer <token>

query필수string | array<string>

객체 1

max_num_resultsinteger

filtersobject

ranking_optionsobject

rewrite_queryboolean

vector_store_id필수string

응답

이 페이지에서

`Authorization`
필수
Bearer <token>

`query`
필수
string | array<string>

`max_num_results`integer

`filters`object

`ranking_options`object

`rewrite_query`boolean

`vector_store_id`
필수
string

`Authorization`
필수
Bearer <token>

`query`
필수
string | array<string>

`max_num_results`integer

`filters`object

`ranking_options`object

`rewrite_query`boolean

`vector_store_id`
필수
string