Documents - Graph

엣지 리스트 그래프 프로파일을 가진 인덱스에 대한 그래프 쿼리를 실행합니다.

POST {endpoint}/indexes('{indexName}')/docs/search.graph?api-version=2026-11-01-preview

URI 매개 변수

속성 In(다음 안에) 필수 형식 Description
endpoint
path True

string (uri)

검색 서비스의 엔드포인트 URL입니다.

indexName
path True

string

인덱스의 이름입니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

요청 헤더

속성 필수 형식 Description
x-ms-client-request-id

string (uuid)

요청에 대한 불투명하고 전역적으로 고유한 클라이언트 생성 문자열 식별자입니다.

Accept

Accept

Accept 헤더입니다.

x-ms-query-source-authorization

string (password)

쿼리가 실행되는 사용자를 식별하는 토큰입니다. 이 토큰은 문서에 보안 제한을 적용하는 데 사용됩니다.

x-ms-enable-elevated-read

boolean

쿼리 연산에 대한 문서 수준 권한 검사를 우회하는 상위 읽기를 가능하게 하는 값입니다.

요청 본문

속성 필수 형식 Description
gql True

string

minLength: 1

바인딩하고 실행할 비어 있지 않은 GQL 쿼리입니다.

executionMode

GraphQueryExecutionMode

쿼리를 기본적으로 실행합니다. planOnly는 백엔드 쿼리 실행 없이 계획을 구축하며 최소 한 단계의 설명 단계를 필요로 합니다.

explain

GraphQueryExplainStage[]

대응에 포함할 진단 계획 단계들. 계획 표현은 실행 가능한 클라이언트 계약이 아니라 진단 정보입니다.

filter

string

그래프 실행 전반에 걸쳐 그래프 인덱스 필드에 적용되는 OData 필터.

includeDiagnostics

boolean

정보 진단을 포함할지 여부. 이 설정과 관계없이 오류와 경고가 반환됩니다.

includeStatistics

boolean

그래프 실행 통계를 포함할지 여부. 기본값은 true입니다.

provenance

GraphQueryProvenanceParameters

유한한 주장 증거와 선택적 소스-문서 수화를 제어합니다.

search

string

그래프 백엔드 요청을 제한하는 데 사용되는 전체 텍스트 검색 텍스트.

vectorQueries VectorQuery[]:

그래프의 백엔드 검색을 제한하는 데 사용되는 벡터 쿼리.

응답

속성 형식 Description
200 OK

GraphQueryResult

요청이 성공했습니다.

Other Status Codes

GraphQueryError

예기치 않은 오류 응답입니다.

헤더

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 헤더입니다.

BalancedVectorQueryTopicGraph

순수 벡터 유사성과 다양성 인식 회상을 결합합니다. 다양성과 관련성을 균형 있게 맞추는 기본 설정을 권장합니다.

DiverseVectorQueryTopicGraph

주제 그래프를 사용하여 다양한 검색을 수행합니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보

ErrorDetail

오류 세부 정보입니다.

GraphQueryDiagnostic

그래프 계획 또는 실행 진단.

GraphQueryDiagnosticPhase

그래프 쿼리 진단을 생성한 단계입니다.

GraphQueryDiagnosticSeverity

그래프 쿼리 진단의 중요성.

GraphQueryError

표준 검색 오류 정보와 선택적 그래프 진단이 포함된 실패한 그래프 요청입니다.

GraphQueryEvidence

출처 주장 식별자와 신뢰 값은 그래프 증거로 유지됩니다.

GraphQueryEvidenceConfidence

이를 뒷받침하는 주장에 기록된 신뢰도(confidence) 값.

GraphQueryEvidenceCount

수집이 완전했는지 여부를 나타내는 관계식 증거 수.

GraphQueryEvidenceCountRelation

증거 집계의 완전성.

GraphQueryExecutionMode

그래프 쿼리가 실행되는지 아니면 계획만 수행되는지 여부.

GraphQueryExplainStage

그래프 쿼리를 검사할 때 사용할 수 있는 진단 단계.

GraphQueryProvenanceHydrateDocumentsParameters

graphProfile.provenanceIndexName으로 구성된 소스 인덱스에서 필드를 선택합니다.

GraphQueryProvenanceKind

그래프 행으로 돌아오는 주장 증거와 같은 종류의 증거.

GraphQueryProvenanceParameters

그래프 쿼리를 위한 bounded provenance collection 옵션.

GraphQueryRequest

인덱스의 graphProfile에 매핑된 논리 그래프를 쿼리하기 위한 필드를 요청합니다.

GraphQueryResult

그래프 쿼리의 예측 행과 선택적 실행 정보.

GraphQueryRow

선택적으로 유한 주장 증거가 포함된 동적 그래프 투영 행.

GraphQueryRowProvenance

한 개의 예측된 그래프 행을 뒷받침하는 주장 증거.

GraphQueryStatistics

그래프 쿼리의 실행 통계; 카운터는 결과 행 횟수가 아니라 수행된 작업을 설명합니다.

NoneVectorQueryTopicGraph

주제 그래프 다양성 검색 없이 일반 벡터 탐색을 사용합니다.

QueryRewritesType

이 매개변수는 쿼리 유형 semantic이 인 경우에만 유효합니다. QueryRewrites가 로 설정 generative되면 쿼리 용어가 생성 모델로 전송되어 요청 재현율을 높이는 데 도움이 되도록 10개(기본값) 재작성을 생성합니다. 요청된 개수는 파이프 문자 | 뒤에 count-<number of rewrites> 옵션(예 generative|count-3: )을 추가하여 구성할 수 있습니다. 기본값은 None입니다.

SearchScoreThreshold

벡터 쿼리 결과는 '

VectorizableImageBinaryQuery

벡터화해야 하는 이미지의 base 64로 인코딩된 이진 파일이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다.

VectorizableImageUrlQuery

벡터화해야 하는 이미지 값을 나타내는 URL이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다.

VectorizableTextQuery

벡터화해야 하는 텍스트 값이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다.

VectorizedQuery

원시 벡터 값이 제공될 때 벡터 검색에 사용할 쿼리 매개 변수입니다.

VectorQueryKind

수행 중인 벡터 쿼리의 종류입니다.

VectorSearchTopicGraphKind

어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지.

VectorSimilarityThreshold

벡터 쿼리의 결과는 벡터 유사성 메트릭에 따라 필터링됩니다. 이는 'distance' 버전이 아니라 유사성 메트릭의 정식 정의입니다. 임계값 방향(크거나 작음)은 필드에서 사용하는 메트릭에 따라 자동으로 선택됩니다.

VectorThresholdKind

벡터 쿼리를 필터링하는 데 사용되는 임계값의 종류입니다.

Accept

Accept 헤더입니다.

값 Description
application/json;odata.metadata=none

BalancedVectorQueryTopicGraph

순수 벡터 유사성과 다양성 인식 회상을 결합합니다. 다양성과 관련성을 균형 있게 맞추는 기본 설정을 권장합니다.

속성 형식 Description
kind string:

balanced

어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지.

minDiversityPoolSize

integer (int32)

minimum: 250
maximum: 10000

주제 그래프 샘플링 전에 검색해야 할 최소 벡터 후보 수. 기본값은 1,000입니다.

DiverseVectorQueryTopicGraph

주제 그래프를 사용하여 다양한 검색을 수행합니다.

속성 형식 Description
diversityFactor

number (float)

minimum: 0
maximum: 1

주제 그래프 다양성 검색에 사용되는 다양성 계수. 생략하면 주제 그래프 프로필에 설정된 기본값이 사용됩니다.

kind string:

diverse

어떤 종류의 주제 그래프 벡터 검색을 사용해야 할지.

minDiversityPoolSize

integer (int32)

minimum: 250
maximum: 10000

주제 그래프 샘플링 전에 검색해야 할 최소 벡터 후보 수. 기본값은 1,000입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보

속성 형식 Description
info

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

속성 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상.

GraphQueryDiagnostic

그래프 계획 또는 실행 진단.

속성 형식 Description
code

string

안정적인 기계 판독 가능한 진단 식별자.

message

string

사람이 읽을 수 있는 설명; 애플리케이션은 이 텍스트를 파싱하기보다는 코드를 사용해야 합니다.

phase

GraphQueryDiagnosticPhase

진단을 만들어낸 단계.

severity

GraphQueryDiagnosticSeverity

진단의 중요성.

span

string

진단과 연관된 선택적 소스 범위 설명.

suggestions

string[]

제안된 수정 사항이나 대안.

GraphQueryDiagnosticPhase

그래프 쿼리 진단을 생성한 단계입니다.

값 Description
parse

쿼리 구문과 구문 분석.

bind

변수, 매개변수, 함수, 그리고 의미론적 바인딩.

validation

요청 옵션 검증.

planning

지원되지 않는 쿼리 도형 및 쿼리 폭 제한 등 쿼리 계획.

execution

런타임 평가, 실행 제한 경고, 실행 요약.

GraphQueryDiagnosticSeverity

그래프 쿼리 진단의 중요성.

값 Description
error

쿼리가 거부되었거나 성공적으로 평가할 수 없었습니다.

warning

실행 시 결과는 실행 또는 출처 제한과 같은 조건이 붙었습니다.

info

선택적 실행 요약과 같은 정보 진단 기능.

GraphQueryError

표준 검색 오류 정보와 선택적 그래프 진단이 포함된 실패한 그래프 요청입니다.

속성 형식 Description
@odata.count

integer (int64)

이 응답에서 투영된 행의 수, 무한한 그래프 모집단의 크기가 아닙니다.

@search.graphDiagnostics

GraphQueryDiagnostic[]

구조화된 오류, 경고, 요청된 정보 진단.

@search.graphExplain

GraphQueryExplain

요청된 진단 단계. 빠진 단계는 생략됩니다.

@search.graphProvenanceDocuments

object

문서 ID로 키팅된 수분 처리 소스 문서, 결과 행 간에 공유됩니다.

@search.graphStats

GraphQueryStatistics

요청 시 실행 통계 제공.

error

ErrorDetail

표준 검색 오류 정보. 그래프 쿼리 거부는 InvalidRequestParameter를 사용하며, 그래프 진단에서 해당 코드를 보존합니다.

value

GraphQueryRow[]

쿼리 투영 행. planOnly는 빈 컬렉션을 반환합니다.

GraphQueryEvidence

출처 주장 식별자와 신뢰 값은 그래프 증거로 유지됩니다.

속성 형식 Description
chunkId

string

소스 문서 조회에 사용되는 소스 청크 식별자.

confidence

GraphQueryEvidenceConfidence

주장 및 그 구성 요소와 관련된 신뢰도(confidence) 값.

edgeId

string

그래프 인덱스의 주장 문서 식별자.

parentId

string

상위 소스 문서 식별자.

GraphQueryEvidenceConfidence

이를 뒷받침하는 주장에 기록된 신뢰도(confidence) 값.

속성 형식 Description
edge

number (double)

완전한 관계에 대한 자신감.

object

number (double)

대상에 대한 확신.

predicate

number (double)

술어 정렬에 대한 신뢰.

subject

number (double)

주제에 대한 자신감.

GraphQueryEvidenceCount

수집이 완전했는지 여부를 나타내는 관계식 증거 수.

속성 형식 Description
relation

GraphQueryEvidenceCountRelation

값이 정확한 카운트인지 하한인지입니다.

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

GraphQueryProvenanceHydrateDocumentsParameters

소스 문서 선택 옵션. 친절한 사람이 수분 공급을 할 때 필요하다.

kind

GraphQueryProvenanceKind

증거 식별자를 반환할지, 아니면 출처 문서를 다시 정리할지 여부도 중요합니다.

maxEvidencePerRow

integer (int32)

minimum: 1

결과 행당 수집된 최대 증거 항목. 한이 있을 경우, 응답은 증거 수가 정확한지 하한인지 나타낸다.

GraphQueryRequest

인덱스의 graphProfile에 매핑된 논리 그래프를 쿼리하기 위한 필드를 요청합니다.

속성 형식 Default value Description
executionMode

GraphQueryExecutionMode

execute

쿼리를 기본적으로 실행합니다. planOnly는 백엔드 쿼리 실행 없이 계획을 구축하며 최소 한 단계의 설명 단계를 필요로 합니다.

explain

GraphQueryExplainStage[]

대응에 포함할 진단 계획 단계들. 계획 표현은 실행 가능한 클라이언트 계약이 아니라 진단 정보입니다.

filter

string

그래프 실행 전반에 걸쳐 그래프 인덱스 필드에 적용되는 OData 필터.

gql

string

minLength: 1

바인딩하고 실행할 비어 있지 않은 GQL 쿼리입니다.

includeDiagnostics

boolean

False

정보 진단을 포함할지 여부. 이 설정과 관계없이 오류와 경고가 반환됩니다.

includeStatistics

boolean

True

그래프 실행 통계를 포함할지 여부. 기본값은 true입니다.

provenance

GraphQueryProvenanceParameters

유한한 주장 증거와 선택적 소스-문서 수화를 제어합니다.

search

string

그래프 백엔드 요청을 제한하는 데 사용되는 전체 텍스트 검색 텍스트.

vectorQueries VectorQuery[]:

그래프의 백엔드 검색을 제한하는 데 사용되는 벡터 쿼리.

GraphQueryResult

그래프 쿼리의 예측 행과 선택적 실행 정보.

속성 형식 Description
@odata.count

integer (int64)

이 응답에서 투영된 행의 수, 무한한 그래프 모집단의 크기가 아닙니다.

@search.graphDiagnostics

GraphQueryDiagnostic[]

구조화된 오류, 경고, 요청된 정보 진단.

@search.graphExplain

GraphQueryExplain

요청된 진단 단계. 빠진 단계는 생략됩니다.

@search.graphProvenanceDocuments

object

문서 ID로 키팅된 수분 처리 소스 문서, 결과 행 간에 공유됩니다.

@search.graphStats

GraphQueryStatistics

요청 시 실행 통계 제공.

value

GraphQueryRow[]

쿼리 투영 행. planOnly는 빈 컬렉션을 반환합니다.

GraphQueryRow

선택적으로 유한 주장 증거가 포함된 동적 그래프 투영 행.

속성 형식 Description
@search.graphProvenance

GraphQueryRowProvenance

이 예상 논쟁을 뒷받침하는 주장 증거.

GraphQueryRowProvenance

한 개의 예측된 그래프 행을 뒷받침하는 주장 증거.

속성 형식 Description
evidence

GraphQueryEvidence[]

이 결과 행에 대한 경계 있는 증거 항목.

evidenceCount

GraphQueryEvidenceCount

이를 뒷받침하는 주장의 수와 그 카운트의 완전성 관계.

kind

GraphQueryProvenanceKind

쿼리가 증거 ID를 요청했는지, 아니면 소스 수분 공급을 요청했는지.

GraphQueryStatistics

그래프 쿼리의 실행 통계; 카운터는 결과 행 횟수가 아니라 수행된 작업을 설명합니다.

속성 형식 Description
documentsFetched

integer (int32)

실행 중에 가져오는 백엔드 주장 문서.

executionMode

GraphQueryExecutionMode

요청이 실행되었는지, 아니면 단지 계획만 생성했는지.

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:

searchScore

임계값 종류.

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:

imageBinary

쿼리 유형입니다.

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:

imageUrl

쿼리 유형입니다.

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

QueryRewritesType

생성 모델이 쿼리를 벡터화되도록 보내기 전에 다시 작성하도록 구성할 수 있습니다.

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:

vectorSimilarity

임계값 종류.

value

number (double)

임계값은 유사성 메트릭 값을 기반으로 필터링됩니다. 이는 'distance' 버전이 아니라 유사성 메트릭의 정식 정의입니다. 임계값 방향(크거나 작음)은 필드에서 사용하는 메트릭에 따라 자동으로 선택됩니다.

VectorThresholdKind

벡터 쿼리를 필터링하는 데 사용되는 임계값의 종류입니다.

값 Description
vectorSimilarity

벡터 쿼리의 결과는 벡터 유사성 메트릭에 따라 필터링됩니다. 이는 'distance' 버전이 아니라 유사성 메트릭의 정식 정의입니다. 임계값 방향(크거나 작음)은 필드에서 사용하는 메트릭에 따라 자동으로 선택됩니다.

searchScore

벡터 쿼리의 결과는 '@search.score' 값을 기준으로 필터링됩니다. 이는 검색 응답의 일부로 반환됩니다 @search.score . 임계값 방향은 더 높은 @search.score.