Documents - Graph

Kenar listesi grafik profiline sahip bir indeks üzerinde grafik sorgusu çalıştırır.

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

URI Parametreleri

Veri Akışı Adı İçinde Gerekli Tür Description
endpoint
path True

string (uri)

Arama hizmetinin uç nokta URL'si.

indexName
path True

string

Dizinin adı.

api-version
query True

string

minLength: 1

Bu işlem için kullanılacak API sürümü.

İstek Başlığı

Veri Akışı Adı Gerekli Tür Description
x-ms-client-request-id

string (uuid)

İstek için opak, genel olarak benzersiz, istemci tarafından oluşturulan bir dize tanımlayıcısı.

Accept

Accept

Accept başlığı.

x-ms-query-source-authorization

string (password)

Sorgunun yürütüldüğü kullanıcıyı tanımlayan belirteç. Bu belirteç, belgelerde güvenlik kısıtlamalarını zorlamak için kullanılır.

x-ms-enable-elevated-read

boolean

Sorgu işlemi için belge düzeyi izin denetimlerini atlayan yükseltilmiş okumayı etkinleştiren bir değer.

İstek Gövdesi

Veri Akışı Adı Gerekli Tür Description
gql True

string

minLength: 1

Bağlamak ve yürütülmek için boş olmayan GQL sorgusu.

executionMode

GraphQueryExecutionMode

Sorguyu varsayılan olarak çalıştırır. planOnly planı arka uç sorgu yürütmeden oluşturur ve en az bir açıklama aşaması gerektirir.

explain

GraphQueryExplainStage[]

Yanıta dahil edilecek tanı planı aşamaları. Plan temsilleri, yürütülebilir bir müşteri sözleşmesi olmaktan ziyade tanısal bilgilerdir.

filter

string

Grafik yürütme boyunca uygulanan grafik-indeks alanları üzerinde OData filtresi.

includeDiagnostics

boolean

Bilgilendirici tanıların dahil edilip edilmeyeceği. Hatalar ve uyarılar bu ayar ne olursa olsun döndürülür.

includeStatistics

boolean

Grafik yürütme istatistiklerinin dahil edilip edilmeyeceği. Varsayılan değer true'dır.

provenance

GraphQueryProvenanceParameters

Sınırlı beyanname kanıtını ve isteğe bağlı kaynak belge hidratasyonunu kontrol eder.

search

string

Grafik arka uç isteklerini kısıtlamak için kullanılan tam metin arama metni.

vectorQueries VectorQuery[]:

Grafiğin arka uç aramalarını kısıtlamak için kullanılan vektör sorguları.

Yanıtlar

Veri Akışı Adı Tür Description
200 OK

GraphQueryResult

İstek başarılı oldu.

Other Status Codes

GraphQueryError

Beklenmeyen bir hata yanıtı.

Üst Bilgiler

x-ms-error-code: string

Güvenlik

api-key

Tür: apiKey
İçinde: header

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Kapsamlar

Veri Akışı Adı Description
https://search.azure.com/.default

Örnekler

SearchIndexGraphDocuments

Örnek isteği

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
  }
}

Örnek yanıt

{
  "@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"
    }
  ]
}

Tanımlar

Veri Akışı Adı Description
Accept

Accept başlığı.

BalancedVectorQueryTopicGraph

Saf vektör benzerliğini çeşitlilik farkındalığına sahip geri getirme ile harmanlar. Çeşitlilik ile alaka düzeyini dengelemek için varsayılan öneriliyor.

DiverseVectorQueryTopicGraph

Konu grafiği çeşitli erişim kullanır.

ErrorAdditionalInfo

Kaynak yönetimi hatasına ilişkin ek bilgiler.

ErrorDetail

Hata ayrıntısı.

GraphQueryDiagnostic

Bir grafik planlaması veya yürütme tanılaması.

GraphQueryDiagnosticPhase

Grafik sorgusu tanılaması üreten aşama.

GraphQueryDiagnosticSeverity

Grafik sorgusu tanılamasının önemi.

GraphQueryError

Standart Arama hata bilgisi ve isteğe bağlı grafik tanılama ile başarısız bir grafik isteği.

GraphQueryEvidence

Kaynak iddia tanımlayıcıları ve güvenilirlik değerleri grafik kanıtı olarak saklanır.

GraphQueryEvidenceConfidence

Destekleyici bir iddiada kaydedilen güven değerleri.

GraphQueryEvidenceCount

Koleksiyonun tamamlanıp tamamlanmadığını ilişkisi tanımlayan bir kanıt sayımı.

GraphQueryEvidenceCountRelation

Bir delil sayısının tamlığı.

GraphQueryExecutionMode

Bir grafik sorgusunun yürütülüp yürütülmediği yoksa sadece planlanıp planlanmadığı.

GraphQueryExplainStage

Bir grafik sorgusunu incelerken kullanılabilir tanılama aşamaları.

GraphQueryProvenanceHydrateDocumentsParameters

graphProfile.provenanceIndexName tarafından yapılandırılan kaynak indeksten alanları seçer.

GraphQueryProvenanceKind

Grafik satırlarıyla geri dönen türden iddia kanıtları.

GraphQueryProvenanceParameters

Bir grafik sorgusu için sınırlı köken koleksiyonu seçenekleri.

GraphQueryRequest

Bir indeksin graphProfile tarafından eşlenen mantıksal grafiği sorgulamak için alan talep edin.

GraphQueryResult

Bir grafik sorgusunun projeksiyon satırları ve isteğe bağlı yürütme bilgileri.

GraphQueryRow

İsteğe bağlı sınırlı önerme kanıtı içeren dinamik grafik projeksiyon satırı.

GraphQueryRowProvenance

Bir projeksiyonlu grafik satırını destekleyen iddia kanıtı.

GraphQueryStatistics

Bir grafik sorgusu için yürütme istatistikleri; sayaçlar, sonuç satır sayımları yerine yapılan işi tanımlar.

NoneVectorQueryTopicGraph

Konu grafiği çeşitliliği olmadan normal vektör araması kullanır.

QueryRewritesType

Bu parametre yalnızca sorgu türü .semantic QueryRewrites olarak generativeayarlandığında, sorgu terimleri, isteğin geri çağrılmasını artırmaya yardımcı olmak için 10 (varsayılan) yeniden yazma üretecek bir oluşturma modeline gönderilir. İstenen sayı, kanal karakterinin | sonuna ve ardından gibi count-<number of rewrites>bir generative|count-3 seçenek eklenerek yapılandırılabilir. Varsayılan değer None’dır.

SearchScoreThreshold

Vektör sorgusunun sonuçları, '

VectorizableImageBinaryQuery

Vektörleştirilmesi gereken bir görüntünün temel 64 kodlanmış ikili dosyası sağlandığında vektör araması için kullanılacak sorgu parametreleri.

VectorizableImageUrlQuery

Vektörleştirilmesi gereken bir görüntü değerini temsil eden bir URL sağlandığında vektör araması için kullanılacak sorgu parametreleri.

VectorizableTextQuery

Vektörleştirilmesi gereken bir metin değeri sağlandığında vektör araması için kullanılacak sorgu parametreleri.

VectorizedQuery

Ham vektör değeri sağlandığında vektör araması için kullanılacak sorgu parametreleri.

VectorQueryKind

Gerçekleştirilen vektör sorgusunun türü.

VectorSearchTopicGraphKind

Kullanılacak konu grafiği vektör araması türü.

VectorSimilarityThreshold

Vektör sorgusunun sonuçları vektör benzerliği ölçümüne göre filtrelenir. Bunun benzerlik ölçümünün kurallı tanımı olduğunu, 'uzaklık' sürümünün olmadığını unutmayın. Eşik yönü (daha büyük veya daha küçük) alan tarafından kullanılan ölçüme göre otomatik olarak seçilir.

VectorThresholdKind

Vektör sorgularını filtrelemek için kullanılan eşik türü.

Accept

Accept başlığı.

Değer Description
application/json;odata.metadata=none

BalancedVectorQueryTopicGraph

Saf vektör benzerliğini çeşitlilik farkındalığına sahip geri getirme ile harmanlar. Çeşitlilik ile alaka düzeyini dengelemek için varsayılan öneriliyor.

Veri Akışı Adı Tür Description
kind string:

balanced

Kullanılacak konu grafiği vektör araması türü.

minDiversityPoolSize

integer (int32)

minimum: 250
maximum: 10000

Konu grafiği örneklemeden önce alınacak minimum vektör aday sayısı. Varsayılan değer 1.000'dir.

DiverseVectorQueryTopicGraph

Konu grafiği çeşitli erişim kullanır.

Veri Akışı Adı Tür Description
diversityFactor

number (float)

minimum: 0
maximum: 1

Konu grafiği çeşitlilik geri çağırmasında kullanılan çeşitlilik faktörü. Atlandıysa, konu grafiği profilinde varsayılan yapılandırılan özellik kullanılır.

kind string:

diverse

Kullanılacak konu grafiği vektör araması türü.

minDiversityPoolSize

integer (int32)

minimum: 250
maximum: 10000

Konu grafiği örneklemeden önce alınacak minimum vektör aday sayısı. Varsayılan değer 1.000'dir.

ErrorAdditionalInfo

Kaynak yönetimi hatasına ilişkin ek bilgiler.

Veri Akışı Adı Tür Description
info

Ek bilgiler.

type

string

Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Veri Akışı Adı Tür Description
additionalInfo

ErrorAdditionalInfo[]

Hata ek bilgisi.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi

GraphQueryDiagnostic

Bir grafik planlaması veya yürütme tanılaması.

Veri Akışı Adı Tür Description
code

string

Kararlı, makine tarafından okunabilir tanı tanımlayıcısı.

message

string

İnsan tarafından okunabilir açıklama; uygulamalar bu metni ayrıştırmak yerine kod kullanmalıdır.

phase

GraphQueryDiagnosticPhase

Tanı sürecini üreten aşama.

severity

GraphQueryDiagnosticSeverity

Tanı teknolojisinin önemi.

span

string

Tanılama ile ilişkili isteğe bağlı kaynak aralığı açıklaması.

suggestions

string[]

Önerilen düzeltmeler veya alternatifler.

GraphQueryDiagnosticPhase

Grafik sorgusu tanılaması üreten aşama.

Değer Description
parse

Sorgu sözdizimi ve ayrıştırma.

bind

Değişken, parametre, fonksiyon ve anlamsal bağlama.

validation

İstek-seçenek doğrulaması.

planning

Desteklenmeyen sorgu şekilleri ve sorgu genişliği kısıtlamaları dahil sorgu planlaması.

execution

Çalışma zamanı değerlendirmesi, yürütme sınırı uyarıları ve yürütme özetleri.

GraphQueryDiagnosticSeverity

Grafik sorgusu tanılamasının önemi.

Değer Description
error

Sorgu reddedildi veya başarılı bir şekilde değerlendirilemedi.

warning

Uygulama, bir sonuç döndürür, örneğin bir uygulama veya köken sınırı gibi.

info

İsteğe bağlı yürütme özeti gibi bilgilendirici tanılamalar.

GraphQueryError

Standart Arama hata bilgisi ve isteğe bağlı grafik tanılama ile başarısız bir grafik isteği.

Veri Akışı Adı Tür Description
@odata.count

integer (int64)

Bu yanıttaki projeksiyon satır sayısı, sınırsız grafik popülasyonunun büyüklüğü değil.

@search.graphDiagnostics

GraphQueryDiagnostic[]

Yapılandırılmış hatalar, uyarılar ve istenen bilgilendirici tanılamalar.

@search.graphExplain

GraphQueryExplain

İstenen tanı aşamaları. Eksik aşamalar atlanmıştır.

@search.graphProvenanceDocuments

object

Belge kimliğine göre anahtarlanmış, sonuç satırları arasında paylaşılan hidratlı kaynak belgeler.

@search.graphStats

GraphQueryStatistics

İstendiğinde ve mevcut olduğunda yürütme istatistikleri.

error

ErrorDetail

Standart Arama hata bilgisi. Grafik sorgu reddetmeleri InvalidRequestParameter kullanır ve grafik tanılamasında özel kodlarını korur.

value

GraphQueryRow[]

Projeksiyon satırlarını sorgulayın. planOnly boş bir koleksiyon döndürür.

GraphQueryEvidence

Kaynak iddia tanımlayıcıları ve güvenilirlik değerleri grafik kanıtı olarak saklanır.

Veri Akışı Adı Tür Description
chunkId

string

Kaynak belge sorgusu için kullanılan kaynak parça tanımlayıcısı.

confidence

GraphQueryEvidenceConfidence

Önerme ve bileşenleriyle ilişkili güven değerleri.

edgeId

string

Grafik dizininde doğrulama belgesi tanımlayıcısı.

parentId

string

Üst kaynak belge tanımlayıcısı.

GraphQueryEvidenceConfidence

Destekleyici bir iddiada kaydedilen güven değerleri.

Veri Akışı Adı Tür Description
edge

number (double)

Tam ilişkiye güven.

object

number (double)

Nesneye güven, yere sabitleme.

predicate

number (double)

Yüklem hizalamasına güven.

subject

number (double)

Konuya güven, yere sabitlenme.

GraphQueryEvidenceCount

Koleksiyonun tamamlanıp tamamlanmadığını ilişkisi tanımlayan bir kanıt sayımı.

Veri Akışı Adı Tür Description
relation

GraphQueryEvidenceCountRelation

Değerin tam sayı mı yoksa alt sınır mı olduğu.

value

integer (int32)

Gözlemlenen destekleyici kanıt girişlerinin sayısı.

GraphQueryEvidenceCountRelation

Bir delil sayısının tamlığı.

Değer Description
exact

Tüm destekleyici kanıtlar sayıldı.

lowerBound

En azından bu kadar çok destekleyici giriş vardır; koleksiyon sınırlıydı.

GraphQueryExecutionMode

Bir grafik sorgusunun yürütülüp yürütülmediği yoksa sadece planlanıp planlanmadığı.

Değer Description
execute

Grafik planını oluşturun ve uygulayın.

planOnly

Arka uç aramaları yapmadan grafik planını oluşturun.

GraphQueryExplainStage

Bir grafik sorgusunu incelerken kullanılabilir tanılama aşamaları.

Değer Description
syntax

Ayrıştırılmış sorgu sözdizimi.

semanticIr

Bağlı anlamsal ara temsil.

logicalPlan

Optimizasyondan önce mantıklı plan.

optimizedLogicalPlan

Optimizasyondan sonra mantıklı plan.

physicalPlan

Fiziksel uygulama planı.

requestAttributions

Arka uç isteklerinin yürütme planı düğümlerine atfedilmesi.

full

Tüm mevcut tanı aşamaları.

GraphQueryProvenanceHydrateDocumentsParameters

graphProfile.provenanceIndexName tarafından yapılandırılan kaynak indeksten alanları seçer.

Veri Akışı Adı Tür Description
select

string

Dönecek kaynak belge alanları virgülle ayrılmıştır; atlanmış, servisin varsayılan alınabilir alanlarını seçer.

GraphQueryProvenanceKind

Grafik satırlarıyla geri dönen türden iddia kanıtları.

Değer Description
ids

Kaynak belgeler olmadan kanıt tanımlayıcıları döndürün.

hydrate

Profil yapılandırılmış kaynak indeksinden kanıt tanımlayıcılarını ve seçili belgeleri döndürün.

GraphQueryProvenanceParameters

Bir grafik sorgusu için sınırlı köken koleksiyonu seçenekleri.

Veri Akışı Adı Tür Description
hydrateDocuments

GraphQueryProvenanceHydrateDocumentsParameters

Kaynak belge seçim seçenekleri. Türden su varsa gereklidir.

kind

GraphQueryProvenanceKind

Delil tanımlayıcılarını mı geri göndereceksin yoksa kaynak belgelerini de nemlendirecekler.

maxEvidencePerRow

integer (int32)

minimum: 1

Sonuç satırı başına toplanan maksimum kanıt girişi. Sınırlı olduğunda, yanıt kanıt sayısının tam mı yoksa alt sınır mı olduğunu gösterir.

GraphQueryRequest

Bir indeksin graphProfile tarafından eşlenen mantıksal grafiği sorgulamak için alan talep edin.

Veri Akışı Adı Tür Default value Description
executionMode

GraphQueryExecutionMode

execute

Sorguyu varsayılan olarak çalıştırır. planOnly planı arka uç sorgu yürütmeden oluşturur ve en az bir açıklama aşaması gerektirir.

explain

GraphQueryExplainStage[]

Yanıta dahil edilecek tanı planı aşamaları. Plan temsilleri, yürütülebilir bir müşteri sözleşmesi olmaktan ziyade tanısal bilgilerdir.

filter

string

Grafik yürütme boyunca uygulanan grafik-indeks alanları üzerinde OData filtresi.

gql

string

minLength: 1

Bağlamak ve yürütülmek için boş olmayan GQL sorgusu.

includeDiagnostics

boolean

False

Bilgilendirici tanıların dahil edilip edilmeyeceği. Hatalar ve uyarılar bu ayar ne olursa olsun döndürülür.

includeStatistics

boolean

True

Grafik yürütme istatistiklerinin dahil edilip edilmeyeceği. Varsayılan değer true'dır.

provenance

GraphQueryProvenanceParameters

Sınırlı beyanname kanıtını ve isteğe bağlı kaynak belge hidratasyonunu kontrol eder.

search

string

Grafik arka uç isteklerini kısıtlamak için kullanılan tam metin arama metni.

vectorQueries VectorQuery[]:

Grafiğin arka uç aramalarını kısıtlamak için kullanılan vektör sorguları.

GraphQueryResult

Bir grafik sorgusunun projeksiyon satırları ve isteğe bağlı yürütme bilgileri.

Veri Akışı Adı Tür Description
@odata.count

integer (int64)

Bu yanıttaki projeksiyon satır sayısı, sınırsız grafik popülasyonunun büyüklüğü değil.

@search.graphDiagnostics

GraphQueryDiagnostic[]

Yapılandırılmış hatalar, uyarılar ve istenen bilgilendirici tanılamalar.

@search.graphExplain

GraphQueryExplain

İstenen tanı aşamaları. Eksik aşamalar atlanmıştır.

@search.graphProvenanceDocuments

object

Belge kimliğine göre anahtarlanmış, sonuç satırları arasında paylaşılan hidratlı kaynak belgeler.

@search.graphStats

GraphQueryStatistics

İstendiğinde ve mevcut olduğunda yürütme istatistikleri.

value

GraphQueryRow[]

Projeksiyon satırlarını sorgulayın. planOnly boş bir koleksiyon döndürür.

GraphQueryRow

İsteğe bağlı sınırlı önerme kanıtı içeren dinamik grafik projeksiyon satırı.

Veri Akışı Adı Tür Description
@search.graphProvenance

GraphQueryRowProvenance

Bu öngörülen tartışmayı destekleyen iddia kanıtı.

GraphQueryRowProvenance

Bir projeksiyonlu grafik satırını destekleyen iddia kanıtı.

Veri Akışı Adı Tür Description
evidence

GraphQueryEvidence[]

Bu sonuç satırı için sınırlı kanıt girdileri.

evidenceCount

GraphQueryEvidenceCount

Destekleyici iddiaların sayısı ve bu sayının tamlık ilişkisi.

kind

GraphQueryProvenanceKind

Sorguda kanıt kimlikleri veya kaynak hidratasyonu talep edilip edilmemesi.

GraphQueryStatistics

Bir grafik sorgusu için yürütme istatistikleri; sayaçlar, sonuç satır sayımları yerine yapılan işi tanımlar.

Veri Akışı Adı Tür Description
documentsFetched

integer (int32)

Yürütme sırasında alınan arka uç doğrulama belgeleri.

executionMode

GraphQueryExecutionMode

İsteğin yürütülüp yürütülmediği ya da sadece bir plan üretip üretmediği.

isEstimated

boolean

Yürütmenin tahmini bir sonucu rapor edip etmediği.

planningMs

integer (int64)

Sorgu planını üretmek için harcanan süre, milisaniye cinsinden.

queryCount

integer (int32)

Grafik sorgusu tarafından gerçekleştirilen arka uç arama istekleri.

searchMs

integer (int64)

Arama süresi milisaniye cinsinden bildirildi.

totalMs

integer (int64)

Toplam yürütme süresi milisaniye cinsinden bildirildi.

NoneVectorQueryTopicGraph

Konu grafiği çeşitliliği olmadan normal vektör araması kullanır.

Veri Akışı Adı Tür Description
kind string:

none

Kullanılacak konu grafiği vektör araması türü.

QueryRewritesType

Bu parametre yalnızca sorgu türü .semantic QueryRewrites olarak generativeayarlandığında, sorgu terimleri, isteğin geri çağrılmasını artırmaya yardımcı olmak için 10 (varsayılan) yeniden yazma üretecek bir oluşturma modeline gönderilir. İstenen sayı, kanal karakterinin | sonuna ve ardından gibi count-<number of rewrites>bir generative|count-3 seçenek eklenerek yapılandırılabilir. Varsayılan değer None’dır.

Değer Description
none

Bu sorgu için ek sorgu yeniden yazmaları oluşturmayın.

generative

Arama isteğinin geri çağrılmasını artırmak için alternatif sorgu terimleri oluşturun.

SearchScoreThreshold

Vektör sorgusunun sonuçları, '

Veri Akışı Adı Tür Description
kind string:

searchScore

Eşik türü.

value

number (double)

Eşik '

VectorizableImageBinaryQuery

Vektörleştirilmesi gereken bir görüntünün temel 64 kodlanmış ikili dosyası sağlandığında vektör araması için kullanılacak sorgu parametreleri.

Veri Akışı Adı Tür Description
base64Image

string

Bir vektör arama sorgusu gerçekleştirmek için vektörleştirilecek bir görüntünün 64 tabanlı kodlanmış ikili dosyası.

exhaustive

boolean

True olduğunda, vektör dizinindeki tüm vektörlerde en yakın k komşu aramasını tetikler. Tam eşleşmelerin kritik olduğu senaryolar için yararlıdır( örneğin, zemin gerçeği değerlerini belirleme).

fields

string

Aranan vektöre dahil edilecek Collection(Edm.Single) türünde Vektör Alanları.

filterOverride

string

Bu özel vektör sorgusuna uygulanacak OData filtre ifadesi. Vektör düzeyinde hiçbir filtre ifadesi tanımlanmamışsa, bunun yerine en üst düzey filtre parametresinde tanımlanan ifade kullanılır.

k

integer (int32)

En çok isabet alan olarak döndürülecek en yakın komşu sayısı.

kind string:

imageBinary

Sorgu türü.

oversampling

number (double)

Fazla örnekleme faktörü. En düşük değer 1'dir. Dizin tanımında yapılandırılan 'defaultOversampling' parametresini geçersiz kılar. Yalnızca 'rerankWithOriginalVectors' true olduğunda ayarlanabilir. Bu parametreye yalnızca temel alınan vektör alanında bir sıkıştırma yöntemi kullanıldığında izin verilir.

perDocumentVectorLimit

integer (int32)

Bir vektör arama sorgusunda her belgeden kaç vektörün eşleştirilebileceğini kontrol eder. Bunu 1 olarak ayarlamak, belge başına en fazla bir vektörün eşleşmesini sağlayarak sonuçların farklı belgelerden gelmesini garanti eder. 0 (sınırsız) olarak ayarlamak, aynı belgeden birden çok ilgili vektörün eşleştirilmesine izin verir. Varsayılan değer 0'dır.

threshold VectorThreshold:

Vektör sorguları için kullanılan eşik. Bunun yalnızca tüm 'alanlar' aynı benzerlik ölçümünü kullandığında ayarlanabileceğini unutmayın.

topicGraph VectorQueryTopicGraph:

Konu grafiği vektör arama seçenekleri.

weight

number (float)

Aynı arama isteğindeki diğer vektör sorgusu ve/veya metin sorgusuyla karşılaştırıldığında vektör sorgusunun göreli ağırlığı. Bu değer, farklı vektör sorguları ve/veya metin sorgusu aracılığıyla alınan sonuçlar tarafından üretilen birden çok derecelendirme listesinin sonuçları birleştirildiğinde kullanılır. Ağırlık ne kadar yüksek olursa, bu sorguyla eşleşen belgeler son derecelendirmede o kadar yüksek olur. Varsayılan değer 1,0'dır ve değerin sıfırdan büyük pozitif bir sayı olması gerekir.

VectorizableImageUrlQuery

Vektörleştirilmesi gereken bir görüntü değerini temsil eden bir URL sağlandığında vektör araması için kullanılacak sorgu parametreleri.

Veri Akışı Adı Tür Description
exhaustive

boolean

True olduğunda, vektör dizinindeki tüm vektörlerde en yakın k komşu aramasını tetikler. Tam eşleşmelerin kritik olduğu senaryolar için yararlıdır( örneğin, zemin gerçeği değerlerini belirleme).

fields

string

Aranan vektöre dahil edilecek Collection(Edm.Single) türünde Vektör Alanları.

filterOverride

string

Bu özel vektör sorgusuna uygulanacak OData filtre ifadesi. Vektör düzeyinde hiçbir filtre ifadesi tanımlanmamışsa, bunun yerine en üst düzey filtre parametresinde tanımlanan ifade kullanılır.

k

integer (int32)

En çok isabet alan olarak döndürülecek en yakın komşu sayısı.

kind string:

imageUrl

Sorgu türü.

oversampling

number (double)

Fazla örnekleme faktörü. En düşük değer 1'dir. Dizin tanımında yapılandırılan 'defaultOversampling' parametresini geçersiz kılar. Yalnızca 'rerankWithOriginalVectors' true olduğunda ayarlanabilir. Bu parametreye yalnızca temel alınan vektör alanında bir sıkıştırma yöntemi kullanıldığında izin verilir.

perDocumentVectorLimit

integer (int32)

Bir vektör arama sorgusunda her belgeden kaç vektörün eşleştirilebileceğini kontrol eder. Bunu 1 olarak ayarlamak, belge başına en fazla bir vektörün eşleşmesini sağlayarak sonuçların farklı belgelerden gelmesini garanti eder. 0 (sınırsız) olarak ayarlamak, aynı belgeden birden çok ilgili vektörün eşleştirilmesine izin verir. Varsayılan değer 0'dır.

threshold VectorThreshold:

Vektör sorguları için kullanılan eşik. Bunun yalnızca tüm 'alanlar' aynı benzerlik ölçümünü kullandığında ayarlanabileceğini unutmayın.

topicGraph VectorQueryTopicGraph:

Konu grafiği vektör arama seçenekleri.

url

string

Vektör arama sorgusu gerçekleştirmek için vektörleştirilecek görüntünün URL'si.

weight

number (float)

Aynı arama isteğindeki diğer vektör sorgusu ve/veya metin sorgusuyla karşılaştırıldığında vektör sorgusunun göreli ağırlığı. Bu değer, farklı vektör sorguları ve/veya metin sorgusu aracılığıyla alınan sonuçlar tarafından üretilen birden çok derecelendirme listesinin sonuçları birleştirildiğinde kullanılır. Ağırlık ne kadar yüksek olursa, bu sorguyla eşleşen belgeler son derecelendirmede o kadar yüksek olur. Varsayılan değer 1,0'dır ve değerin sıfırdan büyük pozitif bir sayı olması gerekir.

VectorizableTextQuery

Vektörleştirilmesi gereken bir metin değeri sağlandığında vektör araması için kullanılacak sorgu parametreleri.

Veri Akışı Adı Tür Description
exhaustive

boolean

True olduğunda, vektör dizinindeki tüm vektörlerde en yakın k komşu aramasını tetikler. Tam eşleşmelerin kritik olduğu senaryolar için yararlıdır( örneğin, zemin gerçeği değerlerini belirleme).

fields

string

Aranan vektöre dahil edilecek Collection(Edm.Single) türünde Vektör Alanları.

filterOverride

string

Bu özel vektör sorgusuna uygulanacak OData filtre ifadesi. Vektör düzeyinde hiçbir filtre ifadesi tanımlanmamışsa, bunun yerine en üst düzey filtre parametresinde tanımlanan ifade kullanılır.

k

integer (int32)

En çok isabet alan olarak döndürülecek en yakın komşu sayısı.

kind string:

text

Sorgu türü.

oversampling

number (double)

Fazla örnekleme faktörü. En düşük değer 1'dir. Dizin tanımında yapılandırılan 'defaultOversampling' parametresini geçersiz kılar. Yalnızca 'rerankWithOriginalVectors' true olduğunda ayarlanabilir. Bu parametreye yalnızca temel alınan vektör alanında bir sıkıştırma yöntemi kullanıldığında izin verilir.

perDocumentVectorLimit

integer (int32)

Bir vektör arama sorgusunda her belgeden kaç vektörün eşleştirilebileceğini kontrol eder. Bunu 1 olarak ayarlamak, belge başına en fazla bir vektörün eşleşmesini sağlayarak sonuçların farklı belgelerden gelmesini garanti eder. 0 (sınırsız) olarak ayarlamak, aynı belgeden birden çok ilgili vektörün eşleştirilmesine izin verir. Varsayılan değer 0'dır.

queryRewrites

QueryRewritesType

Oluşturucu modelin sorguyu vektörleştirilmeye göndermeden önce yeniden yazmasına izin verecek şekilde yapılandırılabilir.

text

string

Vektör arama sorgusu gerçekleştirmek için vektörleştirilecek metin.

threshold VectorThreshold:

Vektör sorguları için kullanılan eşik. Bunun yalnızca tüm 'alanlar' aynı benzerlik ölçümünü kullandığında ayarlanabileceğini unutmayın.

topicGraph VectorQueryTopicGraph:

Konu grafiği vektör arama seçenekleri.

weight

number (float)

Aynı arama isteğindeki diğer vektör sorgusu ve/veya metin sorgusuyla karşılaştırıldığında vektör sorgusunun göreli ağırlığı. Bu değer, farklı vektör sorguları ve/veya metin sorgusu aracılığıyla alınan sonuçlar tarafından üretilen birden çok derecelendirme listesinin sonuçları birleştirildiğinde kullanılır. Ağırlık ne kadar yüksek olursa, bu sorguyla eşleşen belgeler son derecelendirmede o kadar yüksek olur. Varsayılan değer 1,0'dır ve değerin sıfırdan büyük pozitif bir sayı olması gerekir.

VectorizedQuery

Ham vektör değeri sağlandığında vektör araması için kullanılacak sorgu parametreleri.

Veri Akışı Adı Tür Description
exhaustive

boolean

True olduğunda, vektör dizinindeki tüm vektörlerde en yakın k komşu aramasını tetikler. Tam eşleşmelerin kritik olduğu senaryolar için yararlıdır( örneğin, zemin gerçeği değerlerini belirleme).

fields

string

Aranan vektöre dahil edilecek Collection(Edm.Single) türünde Vektör Alanları.

filterOverride

string

Bu özel vektör sorgusuna uygulanacak OData filtre ifadesi. Vektör düzeyinde hiçbir filtre ifadesi tanımlanmamışsa, bunun yerine en üst düzey filtre parametresinde tanımlanan ifade kullanılır.

k

integer (int32)

En çok isabet alan olarak döndürülecek en yakın komşu sayısı.

kind string:

vector

Sorgu türü.

oversampling

number (double)

Fazla örnekleme faktörü. En düşük değer 1'dir. Dizin tanımında yapılandırılan 'defaultOversampling' parametresini geçersiz kılar. Yalnızca 'rerankWithOriginalVectors' true olduğunda ayarlanabilir. Bu parametreye yalnızca temel alınan vektör alanında bir sıkıştırma yöntemi kullanıldığında izin verilir.

perDocumentVectorLimit

integer (int32)

Bir vektör arama sorgusunda her belgeden kaç vektörün eşleştirilebileceğini kontrol eder. Bunu 1 olarak ayarlamak, belge başına en fazla bir vektörün eşleşmesini sağlayarak sonuçların farklı belgelerden gelmesini garanti eder. 0 (sınırsız) olarak ayarlamak, aynı belgeden birden çok ilgili vektörün eşleştirilmesine izin verir. Varsayılan değer 0'dır.

threshold VectorThreshold:

Vektör sorguları için kullanılan eşik. Bunun yalnızca tüm 'alanlar' aynı benzerlik ölçümünü kullandığında ayarlanabileceğini unutmayın.

topicGraph VectorQueryTopicGraph:

Konu grafiği vektör arama seçenekleri.

vector

number[] (float)

Arama sorgusunun vektör gösterimi.

weight

number (float)

Aynı arama isteğindeki diğer vektör sorgusu ve/veya metin sorgusuyla karşılaştırıldığında vektör sorgusunun göreli ağırlığı. Bu değer, farklı vektör sorguları ve/veya metin sorgusu aracılığıyla alınan sonuçlar tarafından üretilen birden çok derecelendirme listesinin sonuçları birleştirildiğinde kullanılır. Ağırlık ne kadar yüksek olursa, bu sorguyla eşleşen belgeler son derecelendirmede o kadar yüksek olur. Varsayılan değer 1,0'dır ve değerin sıfırdan büyük pozitif bir sayı olması gerekir.

VectorQueryKind

Gerçekleştirilen vektör sorgusunun türü.

Değer Description
vector

Ham vektör değerinin sağlandığı vektör sorgusu.

text

Vektörleştirilmesi gereken bir metin değerinin sağlandığı vektör sorgusu.

imageUrl

Vektörleştirilmesi gereken bir görüntü değerini temsil eden bir url'nin sağlandığı vektör sorgusu.

imageBinary

Vektörleştirilmesi gereken bir görüntünün 64 tabanlı kodlanmış ikili dosyasının sağlandığı vektör sorgusu.

VectorSearchTopicGraphKind

Kullanılacak konu grafiği vektör araması türü.

Değer Description
none

Konu grafiği çeşitlilik geri kazanımı kapalıysa normal vektör araması kullanın.

diverse

Konu grafiği çeşitlilik geri çağırışını kullanın.

balanced

Saf vektör benzerliğini çeşitlilik farkındalığına sahip geri getirme ile harmanlar. Çeşitlilik ile alaka düzeyini dengelemek için varsayılan öneriliyor.

VectorSimilarityThreshold

Vektör sorgusunun sonuçları vektör benzerliği ölçümüne göre filtrelenir. Bunun benzerlik ölçümünün kurallı tanımı olduğunu, 'uzaklık' sürümünün olmadığını unutmayın. Eşik yönü (daha büyük veya daha küçük) alan tarafından kullanılan ölçüme göre otomatik olarak seçilir.

Veri Akışı Adı Tür Description
kind string:

vectorSimilarity

Eşik türü.

value

number (double)

Eşik, benzerlik metriği değerine göre filtrelenir. Bunun benzerlik ölçümünün kurallı tanımı olduğunu, 'uzaklık' sürümünün olmadığını unutmayın. Eşik yönü (daha büyük veya daha küçük) alan tarafından kullanılan ölçüme göre otomatik olarak seçilir.

VectorThresholdKind

Vektör sorgularını filtrelemek için kullanılan eşik türü.

Değer Description
vectorSimilarity

Vektör sorgusunun sonuçları vektör benzerliği ölçümüne göre filtrelenir. Bunun benzerlik ölçümünün kurallı tanımı olduğunu, 'uzaklık' sürümünün olmadığını unutmayın. Eşik yönü (daha büyük veya daha küçük) alan tarafından kullanılan ölçüme göre otomatik olarak seçilir.

searchScore

Vektör sorgusunun sonuçları '@search.score' değerine göre filtrelenir. Bunun, arama yanıtının bir parçası olarak döndürülen @search.score olduğunu unutmayın. Eşik yönü daha yüksek @search.scoreiçin seçilir.