BaseVectorQuery interface

패키지:

@azure/search-documents

벡터 및 하이브리드 검색 쿼리에 대한 쿼리 매개 변수입니다.

속성

exhaustive	true이면 벡터 인덱스 내의 모든 벡터에서 K-가장 가까운 전체 인접 검색을 트리거합니다. 정확한 일치 항목이 중요한 시나리오(예: 접지 진리 값 결정)에 유용합니다.
fields	검색된 벡터에 포함할 컬렉션(Edm.Single) 형식의 벡터 필드입니다.
filterOverride	이 특정 벡터 쿼리에 적용할 OData 필터 식입니다. 벡터 수준에서 정의된 필터 식이 없으면 최상위 필터 매개 변수에 정의된 식이 대신 사용됩니다.
kind	서비스에서 지원하는 알려진 값 벡터: 원시 벡터 값이 제공되는 벡터 쿼리입니다. 텍스트: 벡터화해야 하는 텍스트 값이 제공되는 벡터 쿼리입니다. imageUrl: 벡터화해야 하는 이미지 값을 나타내는 URL이 제공되는 벡터 쿼리입니다. imageBinary: 벡터화해야 하는 이미지의 기본 64로 인코딩된 바이너리가 제공되는 벡터 쿼리입니다.
kNearestNeighborsCount	상위 적중 횟수로 반환할 가장 가까운 이웃의 수입니다.
perDocumentVectorLimit	벡터 검색 쿼리의 각 문서에서 일치시킬 수 있는 벡터 수를 제어합니다. 1로 설정하면 문서당 최대 하나의 벡터가 일치하여 고유한 문서에서 결과가 나올 수 있습니다. 0(무제한)으로 설정하면 동일한 문서의 여러 관련 벡터를 일치시킬 수 있습니다. 기본값은 0입니다.
threshold	벡터 쿼리에 사용되는 임계값입니다. 모든 '필드'가 동일한 유사성 메트릭을 사용하는 경우에만 설정할 수 있습니다.
weight	다른 벡터 쿼리 및/또는 동일한 검색 요청 내의 텍스트 쿼리와 비교할 때 벡터 쿼리의 상대적 가중치입니다. 이 값은 여러 벡터 쿼리 및/또는 텍스트 쿼리를 통해 검색된 결과에 의해 생성된 여러 순위 목록의 결과를 결합할 때 사용됩니다. 가중치가 높을수록 해당 쿼리와 일치하는 문서가 최종 순위에 있습니다. 기본값은 1.0이며 값은 0보다 큰 양수여야 합니다.

속성 세부 정보

exhaustive

true이면 벡터 인덱스 내의 모든 벡터에서 K-가장 가까운 전체 인접 검색을 트리거합니다. 정확한 일치 항목이 중요한 시나리오(예: 접지 진리 값 결정)에 유용합니다.

exhaustive?: boolean

속성 값

boolean

fields

검색된 벡터에 포함할 컬렉션(Edm.Single) 형식의 벡터 필드입니다.

fields?: SearchFieldArray<TModel>

속성 값

SearchFieldArray<TModel>

filterOverride

이 특정 벡터 쿼리에 적용할 OData 필터 식입니다. 벡터 수준에서 정의된 필터 식이 없으면 최상위 필터 매개 변수에 정의된 식이 대신 사용됩니다.

filterOverride?: string

속성 값

string

kind

서비스에서 지원하는 알려진 값

벡터: 원시 벡터 값이 제공되는 벡터 쿼리입니다. 텍스트: 벡터화해야 하는 텍스트 값이 제공되는 벡터 쿼리입니다. imageUrl: 벡터화해야 하는 이미지 값을 나타내는 URL이 제공되는 벡터 쿼리입니다. imageBinary: 벡터화해야 하는 이미지의 기본 64로 인코딩된 바이너리가 제공되는 벡터 쿼리입니다.

kind: "text" | "vector" | "imageUrl" | "imageBinary"

속성 값

"text" | "vector" | "imageUrl" | "imageBinary"

kNearestNeighborsCount

상위 적중 횟수로 반환할 가장 가까운 이웃의 수입니다.

kNearestNeighborsCount?: number

속성 값

number

perDocumentVectorLimit

벡터 검색 쿼리의 각 문서에서 일치시킬 수 있는 벡터 수를 제어합니다. 1로 설정하면 문서당 최대 하나의 벡터가 일치하여 고유한 문서에서 결과가 나올 수 있습니다. 0(무제한)으로 설정하면 동일한 문서의 여러 관련 벡터를 일치시킬 수 있습니다. 기본값은 0입니다.

perDocumentVectorLimit?: number

속성 값

number

threshold

벡터 쿼리에 사용되는 임계값입니다. 모든 '필드'가 동일한 유사성 메트릭을 사용하는 경우에만 설정할 수 있습니다.

threshold?: VectorThreshold

속성 값

VectorThreshold

weight

다른 벡터 쿼리 및/또는 동일한 검색 요청 내의 텍스트 쿼리와 비교할 때 벡터 쿼리의 상대적 가중치입니다. 이 값은 여러 벡터 쿼리 및/또는 텍스트 쿼리를 통해 검색된 결과에 의해 생성된 여러 순위 목록의 결과를 결합할 때 사용됩니다. 가중치가 높을수록 해당 쿼리와 일치하는 문서가 최종 순위에 있습니다. 기본값은 1.0이며 값은 0보다 큰 양수여야 합니다.

weight?: number

속성 값

number