Documents - Graph
엣지 리스트 그래프 프로파일을 가진 인덱스에 대한 그래프 쿼리를 실행합니다.
POST {endpoint}/indexes('{indexName}')/docs/search.graph?api-version=2026-11-01-preview
URI 매개 변수
| 속성 | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
검색 서비스의 엔드포인트 URL입니다. |
|
index
|
path | True |
string |
인덱스의 이름입니다. |
|
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
요청 헤더
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다. |
|
| Accept |
Accept 헤더입니다. |
||
| x-ms-query-source-authorization |
string (password) |
쿼리가 실행되는 사용자를 식별하는 토큰입니다. 이 토큰은 문서에 보안 제한을 적용하는 데 사용됩니다. |
|
| x-ms-enable-elevated-read |
boolean |
쿼리 연산에 대한 문서 수준 권한 검사를 우회하는 상위 읽기를 가능하게 하는 값입니다. |
요청 본문
| 속성 | 필수 | 형식 | Description |
|---|---|---|---|
| gql | True |
string minLength: 1 |
바인딩하고 실행할 비어 있지 않은 GQL 쿼리입니다. |
| executionMode |
쿼리를 기본적으로 실행합니다. planOnly는 백엔드 쿼리 실행 없이 계획을 구축하며 최소 한 단계의 설명 단계를 필요로 합니다. |
||
| explain |
대응에 포함할 진단 계획 단계들. 계획 표현은 실행 가능한 클라이언트 계약이 아니라 진단 정보입니다. |
||
| filter |
string |
그래프 실행 전반에 걸쳐 그래프 인덱스 필드에 적용되는 OData 필터. |
|
| includeDiagnostics |
boolean |
정보 진단을 포함할지 여부. 이 설정과 관계없이 오류와 경고가 반환됩니다. |
|
| includeStatistics |
boolean |
그래프 실행 통계를 포함할지 여부. 기본값은 true입니다. |
|
| provenance |
유한한 주장 증거와 선택적 소스-문서 수화를 제어합니다. |
||
| search |
string |
그래프 백엔드 요청을 제한하는 데 사용되는 전체 텍스트 검색 텍스트. |
|
| vectorQueries | VectorQuery[]: |
그래프의 백엔드 검색을 제한하는 데 사용되는 벡터 쿼리. |
응답
| 속성 | 형식 | Description |
|---|---|---|
| 200 OK |
요청이 성공했습니다. |
|
| Other Status Codes |
예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string |
보안
api-key
형식:
apiKey
In(다음 안에):
header
OAuth2Auth
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize
범위
| 속성 | Description |
|---|---|
| https://search.azure.com/.default |
예제
SearchIndexGraphDocuments
샘플 요청
POST https://typespecpreviewexampleservice.search.windows.net/indexes('people-graph')/docs/search.graph?api-version=2026-11-01-preview
{
"gql": "MATCH (p:Person)-[r:worksFor]->(o:Organization) WHERE p.id = 'person:ada' RETURN o.name AS organization",
"filter": "graph_name eq 'contoso-people'",
"includeStatistics": false,
"provenance": {
"kind": "ids",
"maxEvidencePerRow": 5
}
}
샘플 응답
{
"@odata.count": 1,
"value": [
{
"@search.graphProvenance": {
"kind": "ids",
"evidenceCount": {
"value": 1,
"relation": "exact"
},
"evidence": [
{
"edgeId": "assertion-1",
"chunkId": "people-chunk-1",
"parentId": "people-document-1"
}
]
},
"organization": "Contoso"
}
]
}
정의
| 속성 | Description |
|---|---|
| Accept |
Accept 헤더입니다. |
|
Balanced |
순수 벡터 유사성과 다양성 인식 회상을 결합합니다. 다양성과 관련성을 균형 있게 맞추는 기본 설정을 권장합니다. |
|
Diverse |
주제 그래프를 사용하여 다양한 검색을 수행합니다. |
|
Error |
리소스 관리 오류 추가 정보 |
|
Error |
오류 세부 정보입니다. |
|
Graph |
그래프 계획 또는 실행 진단. |
|
Graph |
그래프 쿼리 진단을 생성한 단계입니다. |
|
Graph |
그래프 쿼리 진단의 중요성. |
|
Graph |
표준 검색 오류 정보와 선택적 그래프 진단이 포함된 실패한 그래프 요청입니다. |
|
Graph |
출처 주장 식별자와 신뢰 값은 그래프 증거로 유지됩니다. |
|
Graph |
이를 뒷받침하는 주장에 기록된 신뢰도(confidence) 값. |
|
Graph |
수집이 완전했는지 여부를 나타내는 관계식 증거 수. |
|
Graph |
증거 집계의 완전성. |
|
Graph |
그래프 쿼리가 실행되는지 아니면 계획만 수행되는지 여부. |
|
Graph |
그래프 쿼리를 검사할 때 사용할 수 있는 진단 단계. |
|
Graph |
graphProfile.provenanceIndexName으로 구성된 소스 인덱스에서 필드를 선택합니다. |
|
Graph |
그래프 행으로 돌아오는 주장 증거와 같은 종류의 증거. |
|
Graph |
그래프 쿼리를 위한 bounded provenance collection 옵션. |
|
Graph |
인덱스의 graphProfile에 매핑된 논리 그래프를 쿼리하기 위한 필드를 요청합니다. |
|
Graph |
그래프 쿼리의 예측 행과 선택적 실행 정보. |
|
Graph |
선택적으로 유한 주장 증거가 포함된 동적 그래프 투영 행. |
|
Graph |
한 개의 예측된 그래프 행을 뒷받침하는 주장 증거. |
|
Graph |
그래프 쿼리의 실행 통계; 카운터는 결과 행 횟수가 아니라 수행된 작업을 설명합니다. |
|
None |
주제 그래프 다양성 검색 없이 일반 벡터 탐색을 사용합니다. |
|
Query |
이 매개변수는 쿼리 유형 |
|
Search |
벡터 쿼리 결과는 ' |
|
Vectorizable |
벡터화해야 하는 이미지의 base 64로 인코딩된 이진 파일이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다. |
|
Vectorizable |
벡터화해야 하는 이미지 값을 나타내는 URL이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다. |
|
Vectorizable |
벡터화해야 하는 텍스트 값이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다. |
|
Vectorized |
원시 벡터 값이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다. |
|
Vector |
수행 중인 벡터 쿼리의 종류입니다. |
|
Vector |
어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지. |
|
Vector |
벡터 쿼리의 결과는 벡터 유사성 메트릭에 따라 필터링됩니다. 이는 'distance' 버전이 아니라 유사성 메트릭의 정식 정의입니다. 임계값 방향(크거나 작음)은 필드에서 사용하는 메트릭에 따라 자동으로 선택됩니다. |
|
Vector |
벡터 쿼리를 필터링하는 데 사용되는 임계값의 종류입니다. |
Accept
Accept 헤더입니다.
| 값 | Description |
|---|---|
| application/json;odata.metadata=none |
BalancedVectorQueryTopicGraph
순수 벡터 유사성과 다양성 인식 회상을 결합합니다. 다양성과 관련성을 균형 있게 맞추는 기본 설정을 권장합니다.
| 속성 | 형식 | Description |
|---|---|---|
| kind |
string:
balanced |
어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지. |
| minDiversityPoolSize |
integer (int32) minimum: 250maximum: 10000 |
주제 그래프 샘플링 전에 검색해야 할 최소 벡터 후보 수. 기본값은 1,000입니다. |
DiverseVectorQueryTopicGraph
주제 그래프를 사용하여 다양한 검색을 수행합니다.
| 속성 | 형식 | Description |
|---|---|---|
| diversityFactor |
number (float) minimum: 0maximum: 1 |
주제 그래프 다양성 검색에 사용되는 다양성 계수. 생략하면 주제 그래프 프로필에 설정된 기본값이 사용됩니다. |
| kind |
string:
diverse |
어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지. |
| minDiversityPoolSize |
integer (int32) minimum: 250maximum: 10000 |
주제 그래프 샘플링 전에 검색해야 할 최소 벡터 후보 수. 기본값은 1,000입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보
| 속성 | 형식 | Description |
|---|---|---|
| info |
추가 정보입니다. |
|
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| 속성 | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보 |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상. |
GraphQueryDiagnostic
그래프 계획 또는 실행 진단.
| 속성 | 형식 | Description |
|---|---|---|
| code |
string |
안정적인 기계 판독 가능한 진단 식별자. |
| message |
string |
사람이 읽을 수 있는 설명; 애플리케이션은 이 텍스트를 파싱하기보다는 코드를 사용해야 합니다. |
| phase |
진단을 만들어낸 단계. |
|
| severity |
진단의 중요성. |
|
| span |
string |
진단과 연관된 선택적 소스 범위 설명. |
| suggestions |
string[] |
제안된 수정 사항이나 대안. |
GraphQueryDiagnosticPhase
그래프 쿼리 진단을 생성한 단계입니다.
| 값 | Description |
|---|---|
| parse |
쿼리 구문과 구문 분석. |
| bind |
변수, 매개변수, 함수, 그리고 의미론적 바인딩. |
| validation |
요청 옵션 검증. |
| planning |
지원되지 않는 쿼리 도형 및 쿼리 폭 제한 등 쿼리 계획. |
| execution |
런타임 평가, 실행 제한 경고, 실행 요약. |
GraphQueryDiagnosticSeverity
그래프 쿼리 진단의 중요성.
| 값 | Description |
|---|---|
| error |
쿼리가 거부되었거나 성공적으로 평가할 수 없었습니다. |
| warning |
실행 시 결과는 실행 또는 출처 제한과 같은 조건이 붙었습니다. |
| info |
선택적 실행 요약과 같은 정보 진단 기능. |
GraphQueryError
표준 검색 오류 정보와 선택적 그래프 진단이 포함된 실패한 그래프 요청입니다.
| 속성 | 형식 | Description |
|---|---|---|
| @odata.count |
integer (int64) |
이 응답에서 투영된 행의 수, 무한한 그래프 모집단의 크기가 아닙니다. |
| @search.graphDiagnostics |
구조화된 오류, 경고, 요청된 정보 진단. |
|
| @search.graphExplain |
Graph |
요청된 진단 단계. 빠진 단계는 생략됩니다. |
| @search.graphProvenanceDocuments |
object |
문서 ID로 키팅된 수분 처리 소스 문서, 결과 행 간에 공유됩니다. |
| @search.graphStats |
요청 시 실행 통계 제공. |
|
| error |
표준 검색 오류 정보. 그래프 쿼리 거부는 InvalidRequestParameter를 사용하며, 그래프 진단에서 해당 코드를 보존합니다. |
|
| value |
쿼리 투영 행. planOnly는 빈 컬렉션을 반환합니다. |
GraphQueryEvidence
출처 주장 식별자와 신뢰 값은 그래프 증거로 유지됩니다.
| 속성 | 형식 | Description |
|---|---|---|
| chunkId |
string |
소스 문서 조회에 사용되는 소스 청크 식별자. |
| confidence |
주장 및 그 구성 요소와 관련된 신뢰도(confidence) 값. |
|
| edgeId |
string |
그래프 인덱스의 주장 문서 식별자. |
| parentId |
string |
상위 소스 문서 식별자. |
GraphQueryEvidenceConfidence
이를 뒷받침하는 주장에 기록된 신뢰도(confidence) 값.
| 속성 | 형식 | Description |
|---|---|---|
| edge |
number (double) |
완전한 관계에 대한 자신감. |
| object |
number (double) |
대상에 대한 확신. |
| predicate |
number (double) |
술어 정렬에 대한 신뢰. |
| subject |
number (double) |
주제에 대한 자신감. |
GraphQueryEvidenceCount
수집이 완전했는지 여부를 나타내는 관계식 증거 수.
| 속성 | 형식 | Description |
|---|---|---|
| relation |
값이 정확한 카운트인지 하한인지입니다. |
|
| value |
integer (int32) |
관찰된 증빙 증거 항목 수. |
GraphQueryEvidenceCountRelation
증거 집계의 완전성.
| 값 | Description |
|---|---|
| exact |
모든 뒷받침 증거가 집계되었습니다. |
| lowerBound |
적어도 이 정도의 뒷받침 항목이 존재한다; 컬렉션은 제한이 있었다. |
GraphQueryExecutionMode
그래프 쿼리가 실행되는지 아니면 계획만 수행되는지 여부.
| 값 | Description |
|---|---|
| execute |
그래프 계획을 만들고 실행하세요. |
| planOnly |
백엔드 검색을 실행하지 않고 그래프 계획을 작성하세요. |
GraphQueryExplainStage
그래프 쿼리를 검사할 때 사용할 수 있는 진단 단계.
| 값 | Description |
|---|---|
| syntax |
파싱된 쿼리 구문. |
| semanticIr |
바인드 의미 중간 표현. |
| logicalPlan |
최적화 전에 논리적인 계획을 세우세요. |
| optimizedLogicalPlan |
최적화 후 논리적인 계획. |
| physicalPlan |
물리적 실행 계획. |
| requestAttributions |
백엔드 요청의 실행 계획 노드 귀속. |
| full |
모든 진단 단계가 제공됩니다. |
GraphQueryProvenanceHydrateDocumentsParameters
graphProfile.provenanceIndexName으로 구성된 소스 인덱스에서 필드를 선택합니다.
| 속성 | 형식 | Description |
|---|---|---|
| select |
string |
반환할 쉼표로 구분된 소스 문서 필드; 생략은 서비스의 기본 검색 가능한 필드를 선택합니다. |
GraphQueryProvenanceKind
그래프 행으로 돌아오는 주장 증거와 같은 종류의 증거.
| 값 | Description |
|---|---|
| ids |
출처 문서 없이 증거 식별자를 반환하세요. |
| hydrate |
프로필 구성된 출처 인덱스에서 증거 식별자와 선택된 문서를 반환합니다. |
GraphQueryProvenanceParameters
그래프 쿼리를 위한 bounded provenance collection 옵션.
| 속성 | 형식 | Description |
|---|---|---|
| hydrateDocuments |
소스 문서 선택 옵션. 친절한 사람이 수분 공급을 할 때 필요하다. |
|
| kind |
증거 식별자를 반환할지, 아니면 출처 문서를 다시 정리할지 여부도 중요합니다. |
|
| maxEvidencePerRow |
integer (int32) minimum: 1 |
결과 행당 수집된 최대 증거 항목. 한이 있을 경우, 응답은 증거 수가 정확한지 하한인지 나타낸다. |
GraphQueryRequest
인덱스의 graphProfile에 매핑된 논리 그래프를 쿼리하기 위한 필드를 요청합니다.
| 속성 | 형식 | Default value | Description |
|---|---|---|---|
| executionMode | execute |
쿼리를 기본적으로 실행합니다. planOnly는 백엔드 쿼리 실행 없이 계획을 구축하며 최소 한 단계의 설명 단계를 필요로 합니다. |
|
| explain |
대응에 포함할 진단 계획 단계들. 계획 표현은 실행 가능한 클라이언트 계약이 아니라 진단 정보입니다. |
||
| filter |
string |
그래프 실행 전반에 걸쳐 그래프 인덱스 필드에 적용되는 OData 필터. |
|
| gql |
string minLength: 1 |
바인딩하고 실행할 비어 있지 않은 GQL 쿼리입니다. |
|
| includeDiagnostics |
boolean |
False |
정보 진단을 포함할지 여부. 이 설정과 관계없이 오류와 경고가 반환됩니다. |
| includeStatistics |
boolean |
True |
그래프 실행 통계를 포함할지 여부. 기본값은 true입니다. |
| provenance |
유한한 주장 증거와 선택적 소스-문서 수화를 제어합니다. |
||
| search |
string |
그래프 백엔드 요청을 제한하는 데 사용되는 전체 텍스트 검색 텍스트. |
|
| vectorQueries | VectorQuery[]: |
그래프의 백엔드 검색을 제한하는 데 사용되는 벡터 쿼리. |
GraphQueryResult
그래프 쿼리의 예측 행과 선택적 실행 정보.
| 속성 | 형식 | Description |
|---|---|---|
| @odata.count |
integer (int64) |
이 응답에서 투영된 행의 수, 무한한 그래프 모집단의 크기가 아닙니다. |
| @search.graphDiagnostics |
구조화된 오류, 경고, 요청된 정보 진단. |
|
| @search.graphExplain |
Graph |
요청된 진단 단계. 빠진 단계는 생략됩니다. |
| @search.graphProvenanceDocuments |
object |
문서 ID로 키팅된 수분 처리 소스 문서, 결과 행 간에 공유됩니다. |
| @search.graphStats |
요청 시 실행 통계 제공. |
|
| value |
쿼리 투영 행. planOnly는 빈 컬렉션을 반환합니다. |
GraphQueryRow
선택적으로 유한 주장 증거가 포함된 동적 그래프 투영 행.
| 속성 | 형식 | Description |
|---|---|---|
| @search.graphProvenance |
이 예상 논쟁을 뒷받침하는 주장 증거. |
GraphQueryRowProvenance
한 개의 예측된 그래프 행을 뒷받침하는 주장 증거.
| 속성 | 형식 | Description |
|---|---|---|
| evidence |
이 결과 행에 대한 경계 있는 증거 항목. |
|
| evidenceCount |
이를 뒷받침하는 주장의 수와 그 카운트의 완전성 관계. |
|
| kind |
쿼리가 증거 ID를 요청했는지, 아니면 소스 수분 공급을 요청했는지. |
GraphQueryStatistics
그래프 쿼리의 실행 통계; 카운터는 결과 행 횟수가 아니라 수행된 작업을 설명합니다.
| 속성 | 형식 | Description |
|---|---|---|
| documentsFetched |
integer (int32) |
실행 중에 가져오는 백엔드 주장 문서. |
| executionMode |
요청이 실행되었는지, 아니면 단지 계획만 생성했는지. |
|
| isEstimated |
boolean |
실행이 추정 결과를 보고하는지 여부. |
| planningMs |
integer (int64) |
쿼리 계획을 생성하는 데 소요되는 시간(밀리초 단위). |
| queryCount |
integer (int32) |
그래프 쿼리가 수행하는 백엔드 검색 요청. |
| searchMs |
integer (int64) |
보고된 검색 시간은 밀리초 단위입니다. |
| totalMs |
integer (int64) |
총 실행 시간을 밀리초 단위로 보고했습니다. |
NoneVectorQueryTopicGraph
주제 그래프 다양성 검색 없이 일반 벡터 탐색을 사용합니다.
| 속성 | 형식 | Description |
|---|---|---|
| kind |
string:
none |
어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지. |
QueryRewritesType
이 매개변수는 쿼리 유형 semantic이 인 경우에만 유효합니다. QueryRewrites가 로 설정 generative되면 쿼리 용어가 생성 모델로 전송되어 요청 재현율을 높이는 데 도움이 되도록 10개(기본값) 재작성을 생성합니다. 요청된 개수는 파이프 문자 | 뒤에 count-<number of rewrites> 옵션(예 generative|count-3: )을 추가하여 구성할 수 있습니다. 기본값은 None입니다.
| 값 | Description |
|---|---|
| none |
이 쿼리에 대한 추가 쿼리 재작성을 생성하지 마십시오. |
| generative |
대체 쿼리 용어를 생성하여 검색 요청의 재현율을 높입니다. |
SearchScoreThreshold
벡터 쿼리 결과는 '
| 속성 | 형식 | Description |
|---|---|---|
| kind |
string:
search |
임계값 종류. |
| value |
number (double) |
임계값은 ' |
VectorizableImageBinaryQuery
벡터화해야 하는 이미지의 base 64로 인코딩된 이진 파일이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다.
| 속성 | 형식 | Description |
|---|---|---|
| base64Image |
string |
벡터 검색 쿼리를 수행하기 위해 벡터화할 이미지의 기본 64로 인코딩된 바이너리입니다. |
| exhaustive |
boolean |
true이면 벡터 인덱스 내의 모든 벡터에서 K-가장 가까운 전체 인접 검색을 트리거합니다. 정확한 일치 항목이 중요한 시나리오(예: 접지 진리 값 결정)에 유용합니다. |
| fields |
string |
검색된 벡터에 포함할 컬렉션(Edm.Single) 형식의 벡터 필드입니다. |
| filterOverride |
string |
이 특정 벡터 쿼리에 적용할 OData 필터 식입니다. 벡터 수준에서 정의된 필터 식이 없으면 최상위 필터 매개 변수에 정의된 식이 대신 사용됩니다. |
| k |
integer (int32) |
상위 적중 횟수로 반환할 가장 가까운 이웃의 수입니다. |
| kind |
string:
image |
쿼리 유형입니다. |
| oversampling |
number (double) |
오버샘플링 요소입니다. 최솟값은 1입니다. 인덱스 정의에 구성된 'defaultOversampling' 매개 변수를 재정의합니다. 'rerankWithOriginalVectors'가 true인 경우에만 설정할 수 있습니다. 이 매개 변수는 압축 메서드가 기본 벡터 필드에 사용되는 경우에만 허용됩니다. |
| perDocumentVectorLimit |
integer (int32) |
벡터 검색 쿼리의 각 문서에서 일치시킬 수 있는 벡터 수를 제어합니다. 1로 설정하면 문서당 최대 하나의 벡터가 일치하여 고유한 문서에서 결과가 나올 수 있습니다. 0(무제한)으로 설정하면 동일한 문서의 여러 관련 벡터를 일치시킬 수 있습니다. 기본값은 0입니다. |
| threshold | VectorThreshold: |
벡터 쿼리에 사용되는 임계값입니다. 모든 '필드'가 동일한 유사성 메트릭을 사용하는 경우에만 설정할 수 있습니다. |
| topicGraph | VectorQueryTopicGraph: |
주제 그래프 벡터 검색 옵션. |
| weight |
number (float) |
다른 벡터 쿼리 및/또는 동일한 검색 요청 내의 텍스트 쿼리와 비교할 때 벡터 쿼리의 상대적 가중치입니다. 이 값은 여러 벡터 쿼리 및/또는 텍스트 쿼리를 통해 검색된 결과에 의해 생성된 여러 순위 목록의 결과를 결합할 때 사용됩니다. 가중치가 높을수록 해당 쿼리와 일치하는 문서가 최종 순위에 있습니다. 기본값은 1.0이며 값은 0보다 큰 양수여야 합니다. |
VectorizableImageUrlQuery
벡터화해야 하는 이미지 값을 나타내는 URL이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다.
| 속성 | 형식 | Description |
|---|---|---|
| exhaustive |
boolean |
true이면 벡터 인덱스 내의 모든 벡터에서 K-가장 가까운 전체 인접 검색을 트리거합니다. 정확한 일치 항목이 중요한 시나리오(예: 접지 진리 값 결정)에 유용합니다. |
| fields |
string |
검색된 벡터에 포함할 컬렉션(Edm.Single) 형식의 벡터 필드입니다. |
| filterOverride |
string |
이 특정 벡터 쿼리에 적용할 OData 필터 식입니다. 벡터 수준에서 정의된 필터 식이 없으면 최상위 필터 매개 변수에 정의된 식이 대신 사용됩니다. |
| k |
integer (int32) |
상위 적중 횟수로 반환할 가장 가까운 이웃의 수입니다. |
| kind |
string:
image |
쿼리 유형입니다. |
| oversampling |
number (double) |
오버샘플링 요소입니다. 최솟값은 1입니다. 인덱스 정의에 구성된 'defaultOversampling' 매개 변수를 재정의합니다. 'rerankWithOriginalVectors'가 true인 경우에만 설정할 수 있습니다. 이 매개 변수는 압축 메서드가 기본 벡터 필드에 사용되는 경우에만 허용됩니다. |
| perDocumentVectorLimit |
integer (int32) |
벡터 검색 쿼리의 각 문서에서 일치시킬 수 있는 벡터 수를 제어합니다. 1로 설정하면 문서당 최대 하나의 벡터가 일치하여 고유한 문서에서 결과가 나올 수 있습니다. 0(무제한)으로 설정하면 동일한 문서의 여러 관련 벡터를 일치시킬 수 있습니다. 기본값은 0입니다. |
| threshold | VectorThreshold: |
벡터 쿼리에 사용되는 임계값입니다. 모든 '필드'가 동일한 유사성 메트릭을 사용하는 경우에만 설정할 수 있습니다. |
| topicGraph | VectorQueryTopicGraph: |
주제 그래프 벡터 검색 옵션. |
| url |
string |
벡터 검색 쿼리를 수행하기 위해 벡터화할 이미지의 URL입니다. |
| weight |
number (float) |
다른 벡터 쿼리 및/또는 동일한 검색 요청 내의 텍스트 쿼리와 비교할 때 벡터 쿼리의 상대적 가중치입니다. 이 값은 여러 벡터 쿼리 및/또는 텍스트 쿼리를 통해 검색된 결과에 의해 생성된 여러 순위 목록의 결과를 결합할 때 사용됩니다. 가중치가 높을수록 해당 쿼리와 일치하는 문서가 최종 순위에 있습니다. 기본값은 1.0이며 값은 0보다 큰 양수여야 합니다. |
VectorizableTextQuery
벡터화해야 하는 텍스트 값이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다.
| 속성 | 형식 | Description |
|---|---|---|
| exhaustive |
boolean |
true이면 벡터 인덱스 내의 모든 벡터에서 K-가장 가까운 전체 인접 검색을 트리거합니다. 정확한 일치 항목이 중요한 시나리오(예: 접지 진리 값 결정)에 유용합니다. |
| fields |
string |
검색된 벡터에 포함할 컬렉션(Edm.Single) 형식의 벡터 필드입니다. |
| filterOverride |
string |
이 특정 벡터 쿼리에 적용할 OData 필터 식입니다. 벡터 수준에서 정의된 필터 식이 없으면 최상위 필터 매개 변수에 정의된 식이 대신 사용됩니다. |
| k |
integer (int32) |
상위 적중 횟수로 반환할 가장 가까운 이웃의 수입니다. |
| kind |
string:
text |
쿼리 유형입니다. |
| oversampling |
number (double) |
오버샘플링 요소입니다. 최솟값은 1입니다. 인덱스 정의에 구성된 'defaultOversampling' 매개 변수를 재정의합니다. 'rerankWithOriginalVectors'가 true인 경우에만 설정할 수 있습니다. 이 매개 변수는 압축 메서드가 기본 벡터 필드에 사용되는 경우에만 허용됩니다. |
| perDocumentVectorLimit |
integer (int32) |
벡터 검색 쿼리의 각 문서에서 일치시킬 수 있는 벡터 수를 제어합니다. 1로 설정하면 문서당 최대 하나의 벡터가 일치하여 고유한 문서에서 결과가 나올 수 있습니다. 0(무제한)으로 설정하면 동일한 문서의 여러 관련 벡터를 일치시킬 수 있습니다. 기본값은 0입니다. |
| queryRewrites |
생성 모델이 쿼리를 벡터화되도록 보내기 전에 다시 작성하도록 구성할 수 있습니다. |
|
| text |
string |
벡터 검색 쿼리를 수행하기 위해 벡터화할 텍스트입니다. |
| threshold | VectorThreshold: |
벡터 쿼리에 사용되는 임계값입니다. 모든 '필드'가 동일한 유사성 메트릭을 사용하는 경우에만 설정할 수 있습니다. |
| topicGraph | VectorQueryTopicGraph: |
주제 그래프 벡터 검색 옵션. |
| weight |
number (float) |
다른 벡터 쿼리 및/또는 동일한 검색 요청 내의 텍스트 쿼리와 비교할 때 벡터 쿼리의 상대적 가중치입니다. 이 값은 여러 벡터 쿼리 및/또는 텍스트 쿼리를 통해 검색된 결과에 의해 생성된 여러 순위 목록의 결과를 결합할 때 사용됩니다. 가중치가 높을수록 해당 쿼리와 일치하는 문서가 최종 순위에 있습니다. 기본값은 1.0이며 값은 0보다 큰 양수여야 합니다. |
VectorizedQuery
원시 벡터 값이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다.
| 속성 | 형식 | Description |
|---|---|---|
| exhaustive |
boolean |
true이면 벡터 인덱스 내의 모든 벡터에서 K-가장 가까운 전체 인접 검색을 트리거합니다. 정확한 일치 항목이 중요한 시나리오(예: 접지 진리 값 결정)에 유용합니다. |
| fields |
string |
검색된 벡터에 포함할 컬렉션(Edm.Single) 형식의 벡터 필드입니다. |
| filterOverride |
string |
이 특정 벡터 쿼리에 적용할 OData 필터 식입니다. 벡터 수준에서 정의된 필터 식이 없으면 최상위 필터 매개 변수에 정의된 식이 대신 사용됩니다. |
| k |
integer (int32) |
상위 적중 횟수로 반환할 가장 가까운 이웃의 수입니다. |
| kind |
string:
vector |
쿼리 유형입니다. |
| oversampling |
number (double) |
오버샘플링 요소입니다. 최솟값은 1입니다. 인덱스 정의에 구성된 'defaultOversampling' 매개 변수를 재정의합니다. 'rerankWithOriginalVectors'가 true인 경우에만 설정할 수 있습니다. 이 매개 변수는 압축 메서드가 기본 벡터 필드에 사용되는 경우에만 허용됩니다. |
| perDocumentVectorLimit |
integer (int32) |
벡터 검색 쿼리의 각 문서에서 일치시킬 수 있는 벡터 수를 제어합니다. 1로 설정하면 문서당 최대 하나의 벡터가 일치하여 고유한 문서에서 결과가 나올 수 있습니다. 0(무제한)으로 설정하면 동일한 문서의 여러 관련 벡터를 일치시킬 수 있습니다. 기본값은 0입니다. |
| threshold | VectorThreshold: |
벡터 쿼리에 사용되는 임계값입니다. 모든 '필드'가 동일한 유사성 메트릭을 사용하는 경우에만 설정할 수 있습니다. |
| topicGraph | VectorQueryTopicGraph: |
주제 그래프 벡터 검색 옵션. |
| vector |
number[] (float) |
검색 쿼리의 벡터 표현입니다. |
| weight |
number (float) |
다른 벡터 쿼리 및/또는 동일한 검색 요청 내의 텍스트 쿼리와 비교할 때 벡터 쿼리의 상대적 가중치입니다. 이 값은 여러 벡터 쿼리 및/또는 텍스트 쿼리를 통해 검색된 결과에 의해 생성된 여러 순위 목록의 결과를 결합할 때 사용됩니다. 가중치가 높을수록 해당 쿼리와 일치하는 문서가 최종 순위에 있습니다. 기본값은 1.0이며 값은 0보다 큰 양수여야 합니다. |
VectorQueryKind
수행 중인 벡터 쿼리의 종류입니다.
| 값 | Description |
|---|---|
| vector |
원시 벡터 값이 제공되는 벡터 쿼리입니다. |
| text |
벡터화해야 하는 텍스트 값이 제공되는 벡터 쿼리입니다. |
| imageUrl |
벡터화해야 하는 이미지 값을 나타내는 URL이 제공되는 벡터 쿼리입니다. |
| imageBinary |
벡터화해야 하는 이미지의 기본 64로 인코딩된 바이너리가 제공되는 벡터 쿼리입니다. |
VectorSearchTopicGraphKind
어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지.
| 값 | Description |
|---|---|
| none |
주제 그래프 다양성 검색이 꺼져 있을 때는 일반 벡터 검색을 사용하세요. |
| diverse |
주제 그래프 다양성 검색을 활용하세요. |
| balanced |
순수 벡터 유사성과 다양성 인식 회상을 결합합니다. 다양성과 관련성을 균형 있게 맞추는 기본 설정을 권장합니다. |
VectorSimilarityThreshold
벡터 쿼리의 결과는 벡터 유사성 메트릭에 따라 필터링됩니다. 이는 'distance' 버전이 아니라 유사성 메트릭의 정식 정의입니다. 임계값 방향(크거나 작음)은 필드에서 사용하는 메트릭에 따라 자동으로 선택됩니다.
| 속성 | 형식 | Description |
|---|---|---|
| kind |
string:
vector |
임계값 종류. |
| value |
number (double) |
임계값은 유사성 메트릭 값을 기반으로 필터링됩니다. 이는 'distance' 버전이 아니라 유사성 메트릭의 정식 정의입니다. 임계값 방향(크거나 작음)은 필드에서 사용하는 메트릭에 따라 자동으로 선택됩니다. |
VectorThresholdKind
벡터 쿼리를 필터링하는 데 사용되는 임계값의 종류입니다.
| 값 | Description |
|---|---|
| vectorSimilarity |
벡터 쿼리의 결과는 벡터 유사성 메트릭에 따라 필터링됩니다. 이는 'distance' 버전이 아니라 유사성 메트릭의 정식 정의입니다. 임계값 방향(크거나 작음)은 필드에서 사용하는 메트릭에 따라 자동으로 선택됩니다. |
| searchScore |
벡터 쿼리의 결과는 '@search.score' 값을 기준으로 필터링됩니다. 이는 검색 응답의 일부로 반환됩니다 @search.score . 임계값 방향은 더 높은 @search.score. |