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. |
|
index
|
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 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 |
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 |
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 |
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 |
İstek başarılı oldu. |
|
| Other Status Codes |
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ığı. |
|
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. |
|
Diverse |
Konu grafiği çeşitli erişim kullanır. |
|
Error |
Kaynak yönetimi hatasına ilişkin ek bilgiler. |
|
Error |
Hata ayrıntısı. |
|
Graph |
Bir grafik planlaması veya yürütme tanılaması. |
|
Graph |
Grafik sorgusu tanılaması üreten aşama. |
|
Graph |
Grafik sorgusu tanılamasının önemi. |
|
Graph |
Standart Arama hata bilgisi ve isteğe bağlı grafik tanılama ile başarısız bir grafik isteği. |
|
Graph |
Kaynak iddia tanımlayıcıları ve güvenilirlik değerleri grafik kanıtı olarak saklanır. |
|
Graph |
Destekleyici bir iddiada kaydedilen güven değerleri. |
|
Graph |
Koleksiyonun tamamlanıp tamamlanmadığını ilişkisi tanımlayan bir kanıt sayımı. |
|
Graph |
Bir delil sayısının tamlığı. |
|
Graph |
Bir grafik sorgusunun yürütülüp yürütülmediği yoksa sadece planlanıp planlanmadığı. |
|
Graph |
Bir grafik sorgusunu incelerken kullanılabilir tanılama aşamaları. |
|
Graph |
graphProfile.provenanceIndexName tarafından yapılandırılan kaynak indeksten alanları seçer. |
|
Graph |
Grafik satırlarıyla geri dönen türden iddia kanıtları. |
|
Graph |
Bir grafik sorgusu için sınırlı köken koleksiyonu seçenekleri. |
|
Graph |
Bir indeksin graphProfile tarafından eşlenen mantıksal grafiği sorgulamak için alan talep edin. |
|
Graph |
Bir grafik sorgusunun projeksiyon satırları ve isteğe bağlı yürütme bilgileri. |
|
Graph |
İsteğe bağlı sınırlı önerme kanıtı içeren dinamik grafik projeksiyon satırı. |
|
Graph |
Bir projeksiyonlu grafik satırını destekleyen iddia kanıtı. |
|
Graph |
Bir grafik sorgusu için yürütme istatistikleri; sayaçlar, sonuç satır sayımları yerine yapılan işi tanımlar. |
|
None |
Konu grafiği çeşitliliği olmadan normal vektör araması kullanır. |
|
Query |
Bu parametre yalnızca sorgu türü . |
|
Search |
Vektör sorgusunun sonuçları, ' |
|
Vectorizable |
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. |
|
Vectorizable |
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. |
|
Vectorizable |
Vektörleştirilmesi gereken bir metin değeri sağlandığında vektör araması için kullanılacak sorgu parametreleri. |
|
Vectorized |
Ham vektör değeri sağlandığında vektör araması için kullanılacak sorgu parametreleri. |
|
Vector |
Gerçekleştirilen vektör sorgusunun türü. |
|
Vector |
Kullanılacak konu grafiği vektör araması türü. |
|
Vector |
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. |
|
Vector |
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: 250maximum: 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: 0maximum: 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: 250maximum: 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 |
Hata ek bilgisi. |
|
| code |
string |
Hata kodu. |
| details |
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 |
Tanı sürecini üreten aşama. |
|
| severity |
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 |
Yapılandırılmış hatalar, uyarılar ve istenen bilgilendirici tanılamalar. |
|
| @search.graphExplain |
Graph |
İ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 |
İstendiğinde ve mevcut olduğunda yürütme istatistikleri. |
|
| error |
Standart Arama hata bilgisi. Grafik sorgu reddetmeleri InvalidRequestParameter kullanır ve grafik tanılamasında özel kodlarını korur. |
|
| value |
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 |
Ö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 |
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 |
Kaynak belge seçim seçenekleri. Türden su varsa gereklidir. |
|
| kind |
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 | 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 |
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 |
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 |
Yapılandırılmış hatalar, uyarılar ve istenen bilgilendirici tanılamalar. |
|
| @search.graphExplain |
Graph |
İ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 |
İstendiğinde ve mevcut olduğunda yürütme istatistikleri. |
|
| value |
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 |
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 |
Bu sonuç satırı için sınırlı kanıt girdileri. |
|
| evidenceCount |
Destekleyici iddiaların sayısı ve bu sayının tamlık ilişkisi. |
|
| kind |
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 |
İ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:
search |
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:
image |
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:
image |
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 |
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:
vector |
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. |