Documents - Search Post
Dokumentumokat keres az indexben.
POST {endpoint}/indexes('{indexName}')/docs/search.post.search?api-version=2024-05-01-preview
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
A keresési szolgáltatás végponti URL-címe. |
index
|
path | True |
string |
Az index neve. |
api-version
|
query | True |
string |
Ügyfél API-verziója. |
Kérelem fejléce
Name | Kötelező | Típus | Description |
---|---|---|---|
x-ms-client-request-id |
string uuid |
A kéréssel együtt küldött nyomkövetési azonosító, amely segít a hibakeresésben. |
Kérelem törzse
Name | Típus | Description |
---|---|---|
answers |
Egy érték, amely meghatározza, hogy a válaszokat a keresési válasz részeként kell-e visszaadni. |
|
captions |
Egy érték, amely meghatározza, hogy a keresési válasz részeként vissza kell-e adni a feliratokat. |
|
count |
boolean |
Egy érték, amely meghatározza, hogy lekérje-e az eredmények teljes számát. Az alapértelmezett érték a false (hamis). Ha ezt az értéket true (igaz) értékre állítja, az hatással lehet a teljesítményre. Vegye figyelembe, hogy a visszaadott darabszám közelítés. |
debug |
Lehetővé teszi a hibakeresési eszközt, amely a reranked eredmények további feltárására használható. |
|
facets |
string[] |
A keresési lekérdezésre alkalmazandó aspektuskifejezések listája. Minden aspektuskifejezés tartalmaz egy mezőnevet, amelyet opcionálisan a név:érték párok vesszővel tagolt listája követ. |
filter |
string |
A keresési lekérdezésre alkalmazandó OData $filter kifejezés. |
highlight |
string |
A találatok kiemeléséhez használandó mezőnevek vesszővel tagolt listája. A találatok kiemeléséhez csak kereshető mezők használhatók. |
highlightPostTag |
string |
A kiemelt találatokhoz hozzáfűzött sztringcímke. A highlightPreTag paraméterrel kell beállítani. Az alapértelmezett érték az </em>. |
highlightPreTag |
string |
Egy sztringcímke, amely a kiemelések eléréséhez van előtagként felfűzve. A highlightPostTag paraméterrel kell beállítani. Az alapértelmezett érték az <em>. |
hybridSearch |
A hibrid keresési viselkedés konfigurálására vonatkozó lekérdezési paraméterek. |
|
minimumCoverage |
number |
Egy 0 és 100 közötti szám, amely azt jelzi, hogy a keresési lekérdezésnek hány százalékát kell lefednie az indexnek ahhoz, hogy a lekérdezés sikeresként legyen jelentve. Ez a paraméter akkor is hasznos lehet, ha csak egy replikával rendelkező szolgáltatások esetében is biztosítja a keresések rendelkezésre állását. Az alapértelmezett érték 100. |
orderby |
string |
Az OData vesszővel tagolt listája $orderby kifejezéseket, amelyek alapján rendezheti az eredményeket. Minden kifejezés lehet mezőnév vagy a geo.distance() vagy a search.score() függvény hívása. Minden kifejezést követhet az asc, amely növekvő, a desc pedig csökkenő értéket jelez. Az alapértelmezett érték a növekvő sorrend. A dokumentumok egyezési pontszáma megszakítja a kötelékeket. Ha nincs megadva $orderby, az alapértelmezett rendezési sorrend a dokumentumegyezés pontszáma szerint csökkenő lesz. Legfeljebb 32 $orderby záradék lehet. |
queryLanguage |
A keresési lekérdezés nyelvét meghatározó érték. |
|
queryType |
A keresési lekérdezés szintaxisát meghatározó érték. Az alapértelmezett érték az "egyszerű". Használja a "full" (teljes) értéket, ha a lekérdezés a Lucene lekérdezési szintaxist használja. |
|
scoringParameters |
string[] |
A pontozási függvényekben (például referenciaPointParameter) használandó paraméterértékek listája a formátumnév-értékek használatával. Ha például a pontozási profil egy "mylocation" paraméterrel rendelkező függvényt határoz meg, a paramétersztring "mylocation--122.2,44.8" (idézőjelek nélkül). |
scoringProfile |
string |
Egy pontozási profil neve, amely kiértékeli az egyező dokumentumok egyező pontszámait az eredmények rendezése érdekében. |
scoringStatistics |
Egy érték, amely meghatározza, hogy globálisan ki szeretnénk-e számítani a pontozási statisztikákat (például a dokumentum gyakoriságát) a konzisztensebb pontozáshoz, vagy helyileg az alacsonyabb késés érdekében. Az alapértelmezett érték a "local" (helyi). A "global" használatával globálisan összesítheti a pontozási statisztikákat a pontozás előtt. A globális pontozási statisztikák használata növelheti a keresési lekérdezések késését. |
|
search |
string |
Teljes szöveges keresési lekérdezési kifejezés; Használja a "*" paramétert, vagy kihagyja ezt a paramétert az összes dokumentum egyeztetéséhez. |
searchFields |
string |
Azoknak a mezőneveknek a vesszővel tagolt listája, amelyekre a teljes szöveges keresés hatóköre kiterjed. Ha egy teljes Lucene-lekérdezésben mezőalapú keresést (fieldName:searchExpression) használ, az egyes mezőalapú keresési kifejezések mezőnevei elsőbbséget élveznek az ebben a paraméterben felsorolt mezőnevekkel szemben. |
searchMode |
Egy érték, amely meghatározza, hogy a keresési kifejezések bármelyikét vagy mindegyikét egyezőnek kell-e tekinteni ahhoz, hogy a dokumentumot egyezésként lehessen megszámolni. |
|
select |
string |
A lekérendő mezők vesszővel tagolt listája. Ha nincs meghatározva, a rendszer a sémában lekérdezhetőként megjelölt összes mezőt tartalmazza. |
semanticConfiguration |
string |
A szemantikai konfiguráció neve, amelyet a dokumentumok szemantikai típusú lekérdezések feldolgozásához használnak. |
semanticErrorHandling |
Lehetővé teszi a felhasználó számára, hogy eldöntse, hogy egy szemantikai hívásnak teljesen sikertelennek kell-e lennie, vagy részleges eredményeket ad vissza (alapértelmezett). |
|
semanticFields |
string |
A szemantikai rangsoroláshoz használt mezőnevek vesszővel tagolt listája. |
semanticMaxWaitInMilliseconds |
integer |
Lehetővé teszi a felhasználó számára, hogy felső korlátot állítson be arra az időre, amíg a szemantikai bővítés befejeződik, mielőtt a kérés meghiúsul. |
semanticQuery |
string |
Lehetővé teszi egy külön keresési lekérdezés beállítását, amely kizárólag szemantikai rerankinghoz, szemantikai feliratokhoz és szemantikai válaszokhoz használható. Olyan esetekben hasznos, amikor különböző lekérdezéseket kell használni az alaplekérési és a rangsorolási fázis, valamint az L2 szemantikai fázis között. |
sessionId |
string |
A ragadós munkamenet létrehozásához használandó érték, amely segíthet a konzisztensebb eredmények eléréséhez. Ha ugyanazt a munkamenet-azonosítót használja, a rendszer minden tőle telhetőt megtesz, hogy ugyanazt a replikakészletet célozza meg. Legyen óvatos, ha ugyanazokat a sessionID-értékeket ismételten használja fel, az megzavarhatja a kérések terheléselosztását a replikák között, és hátrányosan befolyásolhatja a keresési szolgáltatás teljesítményét. A sessionIdként használt érték nem kezdődhet _karakterrel. |
skip |
integer |
A kihagyandó keresési eredmények száma. Ez az érték nem lehet nagyobb 100 000-nél. Ha sorrendben kell beolvasnia a dokumentumokat, de a korlátozás miatt nem tudja használni a kihagyást, fontolja meg az orderby használatát egy teljesen rendezett kulcson, és szűrjön egy tartomány lekérdezéssel. |
speller |
Egy érték, amely megadta az egyes keresési lekérdezési kifejezések helyesírási javításához használni kívánt helyesírás-ellenőrző típusát. |
|
top |
integer |
A lekérendő keresési eredmények száma. Ez a $skip együtt használható a keresési eredmények ügyféloldali lapozásának megvalósításához. Ha a találatok csonkulnak a kiszolgálóoldali lapozás miatt, a válasz tartalmaz egy folytatási jogkivonatot, amellyel egy másik keresési kérést adhat ki a következő találati laphoz. |
vectorFilterMode |
Meghatározza, hogy a szűrőket a vektorkeresés előtt vagy után alkalmazza-e a rendszer. Az alapértelmezett érték a "preFilter". |
|
vectorQueries | VectorQuery[]: |
A vektoros és hibrid keresési lekérdezések lekérdezési paraméterei. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A keresési feltételeknek megfelelő dokumentumokat tartalmazó válasz. |
|
Other Status Codes |
Hibaválasz. |
Példák
SearchIndexSearchDocumentsPost
Mintakérelem
POST https://myservice.search.windows.net/indexes('myindex')/docs/search.post.search?api-version=2024-05-01-preview
{
"count": true,
"facets": [
"category,count:10,sort:count"
],
"filter": "rating gt 4.0",
"highlight": "description",
"highlightPostTag": "</em>",
"highlightPreTag": "<em>",
"hybridSearch": {
"maxTextRecallSize": 100,
"countAndFacetMode": "countAllResults"
},
"minimumCoverage": null,
"orderby": "rating desc",
"queryType": "simple",
"scoringParameters": [
"currentLocation--122.123,44.77233"
],
"scoringProfile": "sp",
"search": "nice hotels",
"searchFields": "category,description",
"searchMode": "any",
"sessionId": "mysessionid",
"scoringStatistics": "global",
"select": "hotelId,description",
"skip": 0,
"top": 10,
"vectorQueries": [
{
"kind": "vector",
"vector": [
0.103,
0.0712,
0.0852,
0.1547,
0.1183
],
"fields": "descriptionEmbedding",
"k": 5,
"exhaustive": true,
"oversampling": 20,
"weight": 2,
"threshold": {
"kind": "vectorSimilarity",
"value": 0.8
}
}
],
"vectorFilterMode": "preFilter"
}
Mintaválasz
{
"@odata.count": 25,
"@search.facets": {
"category": [
{
"count": 1,
"value": "Economy"
},
{
"count": 1,
"value": "Luxury"
}
]
},
"@search.nextPageParameters": {
"count": true,
"facets": [
"category,count:10,sort:count"
],
"filter": "rating gt 4.0",
"highlight": "title",
"highlightPostTag": "</em>",
"highlightPreTag": "<em>",
"hybridSearch": {
"maxTextRecallSize": 100,
"countAndFacetMode": "countAllResults"
},
"minimumCoverage": null,
"orderby": "search.score() desc,rating desc",
"queryType": "simple",
"sessionId": "mysessionid",
"scoringStatistics": "global",
"scoringParameters": [
"currentLocation--122.123,44.77233"
],
"scoringProfile": "sp",
"search": "nice hotels",
"searchFields": "title,description",
"searchMode": "any",
"select": "docId,title,description",
"skip": 2,
"top": 8
},
"value": [
{
"@search.score": 1.5,
"@search.highlights": {
"title": [
"<em>Nice</em> <em>Hotel</em>"
]
},
"description": "Cheapest hotel in town",
"docId": "1",
"title": "Nice Hotel"
},
{
"@search.score": 0.7,
"@search.highlights": {
"title": [
"Fancy <em>Hotel</em>"
]
},
"description": "Best hotel in town",
"docId": "2",
"title": "Fancy Hotel"
}
],
"@odata.nextLink": "https://myservice.search.windows.net/indexes('myindex')/docs/search.post.search?api-version=2024-05-01-preview"
}
Definíciók
Name | Description |
---|---|
Answer |
A válasz a lekérdezésnek leginkább megfelelő dokumentumok tartalmából kinyert szövegrészlet. A válaszok a leggyakoribb keresési eredményekből nyerhetők ki. A válaszjelöltek pontszámot kapnak, és a legjobb válaszok lesznek kiválasztva. |
Caption |
A feliratok a dokumentum és a keresési lekérdezés közötti legreprezentesebb szakaszok. Ezeket gyakran használják dokumentum-összefoglalásként. A rendszer csak szemantikai típusú lekérdezések esetén ad vissza feliratokat. |
Document |
A keresési eredmények további vizsgálatához használható hibakeresési információkat tartalmaz. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Hybrid |
Meghatározza, hogy a darabszám és az aspektusok tartalmazzák-e a keresési lekérdezésnek megfelelő összes dokumentumot, vagy csak a "maxTextRecallSize" ablakban lekért dokumentumokat. Az alapértelmezett érték a "countAllResults". |
Hybrid |
TA lekérdezési paraméterek a hibrid keresési viselkedés konfigurálásához. |
Query |
Egy érték, amely meghatározza, hogy a válaszok a keresési válasz részeként legyenek-e visszaadva. |
Query |
Egy érték, amely meghatározza, hogy a keresési válasz részeként vissza kell-e adni a feliratokat. |
Query |
Lehetővé teszi a keresési eredmények további feltárására használható hibakereső eszközt. |
Query |
A lekérdezés nyelve. |
Query |
A szemantikai bővítési folyamatba küldött nyers összefűzött sztringek. |
Query |
A szemantikai bővítési folyamatnak küldött mezők leírása, valamint azok felhasználási módjának leírása |
Query |
Egy érték, amely az egyes keresési lekérdezések kifejezéseinek helyesírás-javításához használandó helyesírás-ellenőrző típusát adta meg. |
Query |
A keresési lekérdezés szintaxisát adja meg. Az alapértelmezett érték az "egyszerű". Használja a "full" értéket, ha a lekérdezés a Lucene lekérdezési szintaxist és a "szemantikai" értéket használja, ha nincs szükség lekérdezési szintaxisra. |
Raw |
A vektorkereséshez használandó lekérdezési paraméterek nyers vektorérték megadásakor. |
Scoring |
Egy érték, amely meghatározza, hogy globálisan ki szeretnénk-e számítani a pontozási statisztikákat (például a dokumentum gyakoriságát) a konzisztensebb pontozás érdekében, vagy helyileg az alacsonyabb késés érdekében. Az alapértelmezett érték a "helyi". A "globális" használatával globálisan összesítheti a pontozási statisztikákat a pontozás előtt. A globális pontozási statisztikák használata növelheti a keresési lekérdezések késését. |
Search |
Egy index keresési eredményeit tartalmazó válasz. |
Search |
Megadja, hogy a keresési kifejezések bármelyikét vagy mindegyikét egyezőnek kell-e tekinteni ahhoz, hogy a dokumentumot egyezésként lehessen megszámolni. |
Search |
Szűrési, rendezési, arculati, lapozási és egyéb keresési lekérdezési viselkedések paraméterei. |
Search |
Tartalmaz egy keresési lekérdezés által talált dokumentumot, valamint a kapcsolódó metaadatokat. |
Search |
A vektoros lekérdezés eredményei a "@search.score" érték alapján lesznek szűrve. Vegye figyelembe, hogy ez a @search.score keresési válasz részeként visszaadott érték. A küszöbérték iránya a magasabb @search.scoreértékhez lesz kiválasztva. |
Semantic |
|
Semantic |
Lehetővé teszi a felhasználó számára, hogy eldöntse, hogy egy szemantikai hívásnak teljesen sikertelennek kell-e lennie, vagy részleges eredményeket ad vissza (alapértelmezett). |
Semantic |
Annak oka, hogy a rendszer részleges választ adott vissza egy szemantikai rangsorolási kérelemre. |
Semantic |
A mező szemantikai bővítési folyamathoz való felhasználási módja (teljes mértékben, részben vagy nem használt) |
Semantic |
A szemantikai rangsorolási kéréshez visszaadott részleges válasz típusa. |
Vector |
Meghatározza, hogy a szűrők alkalmazása a vektorkeresés előtt vagy után történjen-e. |
Vectorizable |
A vektorkereséshez használandó lekérdezési paraméterek, ha egy vektorizálandó kép 64-ben kódolt bináris alapfájlját adja meg. |
Vectorizable |
A vektorkereséshez használandó lekérdezési paraméterek, ha meg van adva egy olyan URL, amely egy vektorizálandó képértéket jelöl. |
Vectorizable |
A vektorkereséshez használandó lekérdezési paraméterek, ha meg van adva egy vektorizálandó szöveges érték. |
Vector |
A végrehajtott vektoros lekérdezés típusa. |
Vector |
A vektoros lekérdezés eredményei a vektoros hasonlóság metrika alapján lesznek szűrve. Vegye figyelembe, hogy ez a hasonlósági metrika canonikus definíciója, nem pedig a "távolság" verziója. A küszöbérték iránya (nagyobb vagy kisebb) automatikusan lesz kiválasztva a mező által használt metrikának megfelelően. |
Vector |
A végrehajtott vektoros lekérdezés típusa. |
AnswerResult
A válasz a lekérdezésnek leginkább megfelelő dokumentumok tartalmából kinyert szövegrészlet. A válaszok a leggyakoribb keresési eredményekből nyerhetők ki. A válaszjelöltek pontszámot kapnak, és a legjobb válaszok lesznek kiválasztva.
Name | Típus | Description |
---|---|---|
highlights |
string |
Ugyanaz a szövegrész, mint a Text tulajdonságban, a lekérdezés szempontjából legrelevánsabb kiemelt szöveges kifejezésekkel. |
key |
string |
Annak a dokumentumnak a kulcsa, amelyből a választ kinyerték. |
score |
number |
A pontszám értéke azt jelzi, hogy mennyire releváns a válasz a lekérdezéshez visszaadott többi válaszhoz képest. |
text |
string |
Válaszként a dokumentum tartalmából kinyert szövegrész. |
CaptionResult
A feliratok a dokumentum és a keresési lekérdezés közötti legreprezentesebb szakaszok. Ezeket gyakran használják dokumentum-összefoglalásként. A rendszer csak szemantikai típusú lekérdezések esetén ad vissza feliratokat.
Name | Típus | Description |
---|---|---|
highlights |
string |
Ugyanaz a szövegrész, mint a Text tulajdonságban a lekérdezés szempontjából legrelevánsabb kiemelt kifejezésekkel. |
text |
string |
A keresési lekérdezés szempontjából legrelevánsabb dokumentumból kinyert reprezentatív szövegrészlet. |
DocumentDebugInfo
A keresési eredmények további vizsgálatához használható hibakeresési információkat tartalmaz.
Name | Típus | Description |
---|---|---|
semantic |
A szemantikai rangsorolási kérelmekre vonatkozó hibakeresési információkat tartalmazza. |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további adattípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
HybridCountAndFacetMode
Meghatározza, hogy a darabszám és az aspektusok tartalmazzák-e a keresési lekérdezésnek megfelelő összes dokumentumot, vagy csak a "maxTextRecallSize" ablakban lekért dokumentumokat. Az alapértelmezett érték a "countAllResults".
Name | Típus | Description |
---|---|---|
countAllResults |
string |
A "darabszám" és a "aspektusok" számítása során a keresési lekérdezés által egyeztetett összes dokumentum belefoglalása, függetlenül attól, hogy ezek a dokumentumok a "maxTextRecallSize" lekérési ablakban találhatók-e. |
countRetrievableResults |
string |
Csak a "maxTextRecallSize" lekérési ablakban egyeztetett dokumentumokat tartalmazza a "darabszám" és a "aspektusok" kiszámításakor. |
HybridSearch
TA lekérdezési paraméterek a hibrid keresési viselkedés konfigurálásához.
Name | Típus | Description |
---|---|---|
countAndFacetMode |
Meghatározza, hogy a darabszám és a aspektusok tartalmazzák-e a keresési lekérdezésnek megfelelő összes dokumentumot, vagy csak a "maxTextRecallSize" ablakban lekért dokumentumokat. |
|
maxTextRecallSize |
integer |
Meghatározza a hibrid keresési kérelem szöveges lekérdezési része által lekérhető dokumentumok maximális számát. Ezek a dokumentumok kombinálva lesznek a vektoros lekérdezésekkel egyező dokumentumokkal, hogy egyetlen végső eredménylistát készítsenek. Ha nagyobb maxTextRecallSize értéket választ, az lehetővé teszi több dokumentum beolvasását és lapozását (a felső és kihagyási paraméterek használatával), magasabb erőforrás-kihasználtság és nagyobb késés mellett. Az értéknek 1 és 10 000 között kell lennie. Az alapértelmezett érték 1000. |
QueryAnswerType
Egy érték, amely meghatározza, hogy a válaszok a keresési válasz részeként legyenek-e visszaadva.
Name | Típus | Description |
---|---|---|
extractive |
string |
Kinyeri a válaszjelölteket a természetes nyelvű kérdésként kifejezett lekérdezésre adott válaszként visszaadott dokumentumok tartalmából. |
none |
string |
Ne adjon vissza válaszokat a lekérdezéshez. |
QueryCaptionType
Egy érték, amely meghatározza, hogy a keresési válasz részeként vissza kell-e adni a feliratokat.
Name | Típus | Description |
---|---|---|
extractive |
string |
Feliratokat nyer ki az egyező dokumentumokból, amelyek a keresési lekérdezés szempontjából releváns részeket tartalmaznak. |
none |
string |
Ne adja vissza a lekérdezés feliratait. |
QueryDebugMode
Lehetővé teszi a keresési eredmények további feltárására használható hibakereső eszközt.
Name | Típus | Description |
---|---|---|
disabled |
string |
A rendszer nem ad vissza lekérdezés-hibakeresési adatokat. |
semantic |
string |
Lehetővé teszi, hogy a felhasználó tovább vizsgálja a reranked eredményeket. |
QueryLanguage
A lekérdezés nyelve.
Name | Típus | Description |
---|---|---|
ar-eg |
string |
Az arab (Egyiptom) nyelv értékének lekérdezése. |
ar-jo |
string |
Az arab (Jordánia) nyelvi értékének lekérdezése. |
ar-kw |
string |
Az arab (Kuvait) nyelvi értékének lekérdezése. |
ar-ma |
string |
Az arab (marokkói) nyelv értékének lekérdezése. |
ar-sa |
string |
Az arab (Szaúd-Arábia) nyelvi értékének lekérdezése. |
bg-bg |
string |
A bolgár (Bulgária) nyelvi értékének lekérdezése. |
bn-in |
string |
A Bengáli (India) nyelvértékének lekérdezése. |
ca-es |
string |
A katalán nyelv értékének lekérdezése. |
cs-cz |
string |
A cseh (Cseh Köztársaság) lekérdezési nyelvi értéke. |
da-dk |
string |
A dán (Dánia) lekérdezési nyelvi értéke. |
de-de |
string |
A német (Németország) lekérdezési nyelvi értéke. |
el-gr |
string |
A görög (Görögország) nyelvi értékének lekérdezése. |
en-au |
string |
Angol (Ausztrália) lekérdezési nyelvi értéke. |
en-ca |
string |
Az angol (Kanada) nyelvi értékének lekérdezése. |
en-gb |
string |
Angol (Nagy-Britannia) lekérdezési nyelvi értéke. |
en-in |
string |
Angol (India) lekérdezési nyelvi értéke. |
en-us |
string |
Angol nyelv (Egyesült Államok) lekérdezési nyelvi értéke. |
es-es |
string |
A spanyol (Spanyolország) lekérdezési nyelvi értéke. |
es-mx |
string |
A spanyol (Mexikó) nyelvi értékének lekérdezése. |
et-ee |
string |
Az észt (Észtország) nyelvértékének lekérdezése. |
eu-es |
string |
A baszk nyelv értékének lekérdezése. |
fa-ae |
string |
A perzsa nyelv (U.A.E.) lekérdezési nyelvi értéke. |
fi-fi |
string |
A finn (Finnország) nyelvi értékének lekérdezése. |
fr-ca |
string |
A francia (Kanada) nyelvi értékének lekérdezése. |
fr-fr |
string |
A francia (Franciaország) lekérdezési nyelvének értéke. |
ga-ie |
string |
Az ír (Írország) lekérdezési nyelvi értéke. |
gl-es |
string |
A galíciai nyelv értékének lekérdezése. |
gu-in |
string |
A Gujarati (India) nyelvértékének lekérdezése. |
he-il |
string |
A héber (Izrael) nyelv értékének lekérdezése. |
hi-in |
string |
A hindi (India) nyelvértékének lekérdezése. |
hr-ba |
string |
A horvát (Bosznia-Hercegovina) lekérdezési nyelvi értéke. |
hr-hr |
string |
A horvát (Horvátország) nyelvi értékének lekérdezése. |
hu-hu |
string |
A magyar (Magyarország) lekérdezési nyelvének értéke. |
hy-am |
string |
Örmény (Örményország) nyelvértékének lekérdezése. |
id-id |
string |
Indonéz (Indonézia) nyelvértékének lekérdezése. |
is-is |
string |
Az izlandi (Izland) lekérdezési nyelvi értéke. |
it-it |
string |
Az olasz (Olaszország) lekérdezési nyelvi értéke. |
ja-jp |
string |
A japán (Japán) nyelvi értékének lekérdezése. |
kn-in |
string |
Kannada (India) nyelvértékének lekérdezése. |
ko-kr |
string |
A koreai (Korea) nyelvi értékének lekérdezése. |
lt-lt |
string |
A litván (Litvánia) nyelvi értékének lekérdezése. |
lv-lv |
string |
Lett (Lettország) lekérdezési nyelvi értéke. |
ml-in |
string |
Malajalam (India) nyelvértékének lekérdezése. |
mr-in |
string |
A Marathi (India) nyelvértékének lekérdezése. |
ms-bn |
string |
A maláj (Brunei Darussalam) lekérdezési nyelvi értéke. |
ms-my |
string |
Maláj (Malajzia) nyelvértékének lekérdezése. |
nb-no |
string |
A norvég (Norvégia) nyelvi értékének lekérdezése. |
nl-be |
string |
A holland (Belgium) lekérdezési nyelvi értéke. |
nl-nl |
string |
A holland (Hollandia) lekérdezési nyelvi értéke. |
no-no |
string |
A norvég (Norvégia) nyelvi értékének lekérdezése. |
none |
string |
A lekérdezés nyelve nincs megadva. |
pa-in |
string |
A Punjabi (India) nyelvértékének lekérdezése. |
pl-pl |
string |
A lengyel (Lengyelország) nyelvi értékének lekérdezése. |
pt-br |
string |
A portugál (Brazília) nyelvértékének lekérdezése. |
pt-pt |
string |
A portugál (Portugália) nyelvi értékének lekérdezése. |
ro-ro |
string |
A román (Románia) lekérdezési nyelvi értéke. |
ru-ru |
string |
Az orosz (Oroszország) nyelvi értékének lekérdezése. |
sk-sk |
string |
A szlovák (Szlovákia) lekérdezési nyelvi értéke. |
sl-sl |
string |
A szlovén (Szlovénia) nyelvi értékének lekérdezése. |
sr-ba |
string |
A szerb (Bosznia-Hercegovina) nyelvértékének lekérdezése. |
sr-me |
string |
A szerb (Montenegró) lekérdezési nyelvi értéke. |
sr-rs |
string |
A szerb (Szerbia) lekérdezési nyelvi értéke. |
sv-se |
string |
A svéd (Svédország) lekérdezési nyelvi értéke. |
ta-in |
string |
A tamil (India) lekérdezési nyelvi értéke. |
te-in |
string |
A Telugu (India) nyelvértékének lekérdezése. |
th-th |
string |
Thai (Thaiföld) lekérdezési nyelvi értéke. |
tr-tr |
string |
A török (Törökország) nyelvi értékének lekérdezése. |
uk-ua |
string |
Az ukrán (Ukrajna) nyelvértékének lekérdezése. |
ur-pk |
string |
Az Urdu (Pakisztán) lekérdezési nyelvének értéke. |
vi-vn |
string |
A vietnami (Viet Nam) nyelvértékének lekérdezése. |
zh-cn |
string |
A kínai (Kínai) nyelv lekérdezési nyelvi értéke. |
zh-tw |
string |
A kínai (Tajvan) nyelvi értékének lekérdezése. |
QueryResultDocumentRerankerInput
A szemantikai bővítési folyamatba küldött nyers összefűzött sztringek.
Name | Típus | Description |
---|---|---|
content |
string |
A szemantikai bővítéshez használt tartalommezők nyers összefűzött sztringjei. |
keywords |
string |
A szemantikai bővítéshez használt kulcsszómezők nyers összefűzött sztringjei. |
title |
string |
A szemantikai bővítéshez használt címmező nyers sztringje. |
QueryResultDocumentSemanticField
A szemantikai bővítési folyamatnak küldött mezők leírása, valamint azok felhasználási módjának leírása
Name | Típus | Description |
---|---|---|
name |
string |
A szemantikai bővítési folyamatnak küldött mező neve |
state |
A mező szemantikai bővítési folyamathoz való felhasználási módja (teljes mértékben, részben vagy nem használt) |
QuerySpellerType
Egy érték, amely az egyes keresési lekérdezések kifejezéseinek helyesírás-javításához használandó helyesírás-ellenőrző típusát adta meg.
Name | Típus | Description |
---|---|---|
lexicon |
string |
A Helyesírás-ellenőrző a queryLanguage paraméter által megadott nyelvhez tartozó statikus lexikon használatával javítja ki az egyes lekérdezési kifejezéseket. |
none |
string |
A helyesírás-ellenőrző nincs engedélyezve. |
QueryType
A keresési lekérdezés szintaxisát adja meg. Az alapértelmezett érték az "egyszerű". Használja a "full" értéket, ha a lekérdezés a Lucene lekérdezési szintaxist és a "szemantikai" értéket használja, ha nincs szükség lekérdezési szintaxisra.
Name | Típus | Description |
---|---|---|
full |
string |
A teljes Lucene lekérdezési szintaxist használja a keresésekhez. A keresési szöveg értelmezése a Lucene lekérdezési nyelv használatával történik, amely lehetővé teszi a mezőspecifikus és súlyozott kereséseket, valamint egyéb speciális funkciókat. |
semantic |
string |
A természetes nyelven kifejezett lekérdezésekhez a legjobb, nem pedig a kulcsszavakhoz. A webes korpuszban betanított rangsorolási modell használatával javítja a keresési eredmények pontosságát. |
simple |
string |
Az egyszerű lekérdezési szintaxist használja a keresésekhez. A keresési szöveg értelmezése egyszerű lekérdezési nyelv használatával történik, amely lehetővé teszi az olyan szimbólumok használatát, mint a +, * és "". A lekérdezések kiértékelése alapértelmezés szerint az összes kereshető mezőben történik, kivéve, ha a searchFields paraméter meg van adva. |
RawVectorQuery
A vektorkereséshez használandó lekérdezési paraméterek nyers vektorérték megadásakor.
Name | Típus | Description |
---|---|---|
exhaustive |
boolean |
Ha igaz, a teljes k-legközelebbi szomszédkeresést aktiválja a vektorindex összes vektorában. Olyan helyzetekben hasznos, ahol a pontos egyezések kritikus fontosságúak, például az alapvető igazságértékek meghatározásához. |
fields |
string |
A keresett vektorban szerepeltetni kívánt Collection(Edm.Single) típusú vektormezők. |
k |
integer |
Azoknak a legközelebbi szomszédoknak a száma, ahányszor a legtöbb találatot vissza szeretné adni. |
kind |
string:
vector |
A végrehajtott vektoros lekérdezés típusa. |
oversampling |
number |
Túlbélyegezési tényező. A minimális érték 1. Felülbírálja az indexdefinícióban konfigurált defaultOversampling paramétert. Csak akkor állítható be, ha a "rerankWithOriginalVectors" igaz. Ez a paraméter csak akkor engedélyezett, ha a mögöttes vektormezőn tömörítési módszert használ. |
threshold | VectorThreshold: |
A vektoros lekérdezésekhez használt küszöbérték. Vegye figyelembe, hogy ez csak akkor állítható be, ha minden "mező" ugyanazt a hasonlósági metrikát használja. |
vector |
number[] |
A keresési lekérdezés vektoros ábrázolása. |
weight |
number |
A vektoros lekérdezés relatív súlya, ha összehasonlítja a többi vektoros lekérdezéssel és/vagy a szöveges lekérdezéssel ugyanabban a keresési kérelemben. Ez az érték a különböző vektoros lekérdezések és/vagy a szöveges lekérdezésen keresztül lekért eredmények több rangsorolási lista eredményeinek kombinálásakor használatos. Minél nagyobb a súly, annál magasabb lesz a lekérdezésnek megfelelő dokumentumok végső rangsorolása. Az alapértelmezett érték 1,0, és az értéknek nullánál nagyobb pozitív számnak kell lennie. |
ScoringStatistics
Egy érték, amely meghatározza, hogy globálisan ki szeretnénk-e számítani a pontozási statisztikákat (például a dokumentum gyakoriságát) a konzisztensebb pontozás érdekében, vagy helyileg az alacsonyabb késés érdekében. Az alapértelmezett érték a "helyi". A "globális" használatával globálisan összesítheti a pontozási statisztikákat a pontozás előtt. A globális pontozási statisztikák használata növelheti a keresési lekérdezések késését.
Name | Típus | Description |
---|---|---|
global |
string |
A pontozási statisztikákat globálisan számítjuk ki a következetesebb pontozás érdekében. |
local |
string |
A pontozási statisztikák helyileg lesznek kiszámítva az alacsonyabb késés érdekében. |
SearchDocumentsResult
Egy index keresési eredményeit tartalmazó válasz.
Name | Típus | Description |
---|---|---|
@odata.count |
integer |
A keresési művelet által talált találatok teljes száma, vagy null érték, ha a szám nem lett kérve. Ha jelen van, a szám nagyobb lehet, mint a válaszban szereplő eredmények száma. Ez akkor fordulhat elő, ha a $top vagy $skip paramétereket használja, vagy ha a lekérdezés nem tudja egyetlen válaszban visszaadni az összes kért dokumentumot. |
@odata.nextLink |
string |
A folytatási URL-cím akkor ad vissza, ha a lekérdezés nem tudja egyetlen válaszban visszaadni az összes kért eredményt. Ezzel az URL-címmel létrehozhat egy másik GET vagy POST keresési kérést a keresési válasz következő részének lekéréséhez. Ügyeljen arra, hogy ugyanazt az igét (GET vagy POST) használja, mint a választ eredményező kérés. |
@search.answers |
A keresési műveletre adott válaszok lekérdezési eredményei; null értékű, ha az answers lekérdezési paraméter nincs megadva, vagy nincs értékre van állítva. |
|
@search.coverage |
number |
A lekérdezésben szereplő index százalékos arányát jelző érték, vagy null érték, ha a kérelemben nem volt megadva a minimális átvétel. |
@search.facets |
object |
A keresési művelet aspektusalapú lekérdezési eredményei, gyűjtők gyűjteményeként rendezve az egyes aspektusmezőkhöz; null értékű, ha a lekérdezés nem tartalmaz aspektuskifejezéseket. |
@search.nextPageParameters |
A folytatási JSON hasznos adat akkor ad vissza, ha a lekérdezés nem tudja egyetlen válaszban visszaadni az összes kért eredményt. Ezzel a JSON-val egy @odata.nextLink másik POST Search-kérést is összeállíthat a keresési válasz következő részének lekéréséhez. |
|
@search.semanticPartialResponseReason |
Annak oka, hogy a rendszer részleges választ adott vissza egy szemantikai rangsorolási kérelemre. |
|
@search.semanticPartialResponseType |
A szemantikai rangsorolási kéréshez visszaadott részleges válasz típusa. |
|
value |
A lekérdezés által visszaadott eredmények sorozata. |
SearchMode
Megadja, hogy a keresési kifejezések bármelyikét vagy mindegyikét egyezőnek kell-e tekinteni ahhoz, hogy a dokumentumot egyezésként lehessen megszámolni.
Name | Típus | Description |
---|---|---|
all |
string |
A dokumentum egyezésként való megszámlálásához az összes keresési kifejezést meg kell egyezni. |
any |
string |
Ahhoz, hogy a dokumentumot egyezőnek tekinthesse, a keresési kifejezéseket egyeznie kell. |
SearchRequest
Szűrési, rendezési, arculati, lapozási és egyéb keresési lekérdezési viselkedések paraméterei.
Name | Típus | Description |
---|---|---|
answers |
Egy érték, amely meghatározza, hogy a válaszok a keresési válasz részeként legyenek-e visszaadva. |
|
captions |
Egy érték, amely meghatározza, hogy a keresési válasz részeként vissza kell-e adni a feliratokat. |
|
count |
boolean |
Egy érték, amely meghatározza, hogy lekérje-e az eredmények teljes számát. Az alapértelmezett érték a false (hamis). Ha ezt az értéket true (igaz) értékre állítja, az hatással lehet a teljesítményre. Vegye figyelembe, hogy a visszaadott darabszám közelítés. |
debug |
Lehetővé teszi a hibakereső eszközt, amely a reranked eredmények további vizsgálatához használható. |
|
facets |
string[] |
A keresési lekérdezésre alkalmazandó aspektuskifejezések listája. Minden aspektuskifejezés tartalmaz egy mezőnevet, amelyet opcionálisan a név:érték párok vesszővel tagolt listája követ. |
filter |
string |
A keresési lekérdezésre alkalmazandó OData $filter kifejezés. |
highlight |
string |
A találatok kiemeléséhez használandó mezőnevek vesszővel tagolt listája. A találatok kiemeléséhez csak kereshető mezők használhatók. |
highlightPostTag |
string |
A kiemelt találatokhoz hozzáfűzött sztringcímke. A highlightPreTag paraméterrel kell beállítani. Az alapértelmezett érték az </em>. |
highlightPreTag |
string |
Egy sztringcímke, amely a kiemelések eléréséhez van előtagként felfűzve. A highlightPostTag paraméterrel kell beállítani. Az alapértelmezett érték az <em>. |
hybridSearch |
A hibrid keresési viselkedés konfigurálására vonatkozó lekérdezési paraméterek. |
|
minimumCoverage |
number |
Egy 0 és 100 közötti szám, amely azt jelzi, hogy a keresési lekérdezésnek hány százalékát kell lefednie az indexnek ahhoz, hogy a lekérdezés sikeresként legyen jelentve. Ez a paraméter akkor is hasznos lehet, ha csak egy replikával rendelkező szolgáltatások esetében is biztosítja a keresések rendelkezésre állását. Az alapértelmezett érték 100. |
orderby |
string |
Az OData vesszővel tagolt listája $orderby kifejezéseket, amelyek alapján rendezheti az eredményeket. Minden kifejezés lehet mezőnév vagy a geo.distance() vagy a search.score() függvény hívása. Minden kifejezést követhet az asc, amely növekvő, a desc pedig csökkenő értéket jelez. Az alapértelmezett érték a növekvő sorrend. A dokumentumok egyezési pontszáma megszakítja a kötelékeket. Ha nincs megadva $orderby, az alapértelmezett rendezési sorrend a dokumentumegyezés pontszáma szerint csökkenő lesz. Legfeljebb 32 $orderby záradék lehet. |
queryLanguage |
A keresési lekérdezés nyelvét meghatározó érték. |
|
queryType |
A keresési lekérdezés szintaxisát meghatározó érték. Az alapértelmezett érték az "egyszerű". Használja a "full" (teljes) értéket, ha a lekérdezés a Lucene lekérdezési szintaxist használja. |
|
scoringParameters |
string[] |
A pontozófüggvényekben (például a referencePointParameterben) használandó paraméterértékek listája a név-értékek formátumával. Ha például a pontozási profil egy "mylocation" nevű paraméterrel definiál egy függvényt, a paraméter sztringje "mylocation--122.2,44.8" lesz (idézőjelek nélkül). |
scoringProfile |
string |
Egy pontozási profil neve, amely kiértékeli az egyező dokumentumok egyező pontszámait az eredmények rendezése érdekében. |
scoringStatistics |
Egy érték, amely meghatározza, hogy globálisan ki szeretnénk-e számítani a pontozási statisztikákat (például a dokumentum gyakoriságát) a konzisztensebb pontozáshoz, vagy helyileg az alacsonyabb késés érdekében. Az alapértelmezett érték a "local" (helyi). A "global" használatával globálisan összesítheti a pontozási statisztikákat a pontozás előtt. A globális pontozási statisztikák használata növelheti a keresési lekérdezések késését. |
|
search |
string |
Egy teljes szöveges keresési lekérdezési kifejezés; Használja a "*" paramétert, vagy hagyja ki ezt a paramétert az összes dokumentum egyeztetéséhez. |
searchFields |
string |
Azoknak a mezőneveknek a vesszővel tagolt listája, amelyekre a teljes szöveges keresés hatóköre kiterjed. Ha mezőalapú keresést (fieldName:searchExpression) használ egy teljes Lucene-lekérdezésben, az egyes mezőalapú keresési kifejezések mezőnevei elsőbbséget élveznek az ebben a paraméterben felsorolt mezőnevekkel szemben. |
searchMode |
Egy érték, amely meghatározza, hogy a keresési kifejezések bármelyikét vagy mindegyikét egyezésnek kell-e tekinteni a dokumentum egyezésként való megszámlálásához. |
|
select |
string |
A beolvasandó mezők vesszővel tagolt listája. Ha nincs meghatározva, a rendszer a sémában lekérdezhetőként megjelölt összes mezőt tartalmazza. |
semanticConfiguration |
string |
Egy szemantikai konfiguráció neve, amelyet a dokumentumok szemantikai típusú lekérdezések feldolgozásához használnak. |
semanticErrorHandling |
Lehetővé teszi, hogy a felhasználó eldöntse, hogy egy szemantikai hívás teljesen meghiúsuljon-e, vagy részleges eredményeket adjon vissza (alapértelmezett). |
|
semanticFields |
string |
A szemantikai rangsoroláshoz használt mezőnevek vesszővel tagolt listája. |
semanticMaxWaitInMilliseconds |
integer |
Lehetővé teszi a felhasználó számára, hogy felső határt állítson be arra az időre, amellyel a szemantikai bővítés befejeződik, mielőtt a kérés meghiúsul. |
semanticQuery |
string |
Lehetővé teszi egy külön keresési lekérdezés beállítását, amely kizárólag szemantikai rerankinghoz, szemantikai feliratokhoz és szemantikai válaszokhoz használható. Olyan helyzetekben hasznos, ahol az alaplekérési és rangsorolási fázis és az L2 szemantikai fázis között különböző lekérdezéseket kell használni. |
sessionId |
string |
A ragadós munkamenet létrehozásához használandó érték, amely segíthet a konzisztensebb eredmények eléréséhez. Ha ugyanazt a munkamenet-azonosítót használja, a rendszer minden tőle telhetőt megtesz, hogy ugyanazt a replikakészletet célozza meg. Legyen óvatos, ha ugyanazokat a sessionID-értékeket ismételten használja fel, az megzavarhatja a kérések terheléselosztását a replikák között, és hátrányosan befolyásolhatja a keresési szolgáltatás teljesítményét. A sessionIdként használt érték nem kezdődhet _karakterrel. |
skip |
integer |
A kihagyandó keresési eredmények száma. Ez az érték nem lehet nagyobb 100 000-nél. Ha egymás után kell beolvasnia a dokumentumokat, de a korlátozás miatt nem tudja használni a kihagyást, fontolja meg az orderby használatát egy teljesen rendezett kulcson, és szűrjön inkább egy tartomány-lekérdezéssel. |
speller |
Egy érték, amely az egyes keresési lekérdezések kifejezéseinek helyesírás-javításához használandó helyesírás-ellenőrző típusát adta meg. |
|
top |
integer |
A lekérendő keresési eredmények száma. Ez a $skip együtt használható a keresési eredmények ügyféloldali lapozásának megvalósításához. Ha a kiszolgálóoldali lapozás miatt csonkulnak az eredmények, a válasz tartalmaz egy folytatási jogkivonatot, amellyel egy másik keresési kérést adhat ki a következő találati lapra. |
vectorFilterMode |
Meghatározza, hogy a szűrők alkalmazása a vektorkeresés előtt vagy után történjen-e. Az alapértelmezett érték a "preFilter". |
|
vectorQueries | VectorQuery[]: |
A vektoros és hibrid keresési lekérdezések lekérdezési paraméterei. |
SearchResult
Tartalmaz egy keresési lekérdezés által talált dokumentumot, valamint a kapcsolódó metaadatokat.
Name | Típus | Description |
---|---|---|
@search.captions |
A feliratok a dokumentum és a keresési lekérdezés közötti legreprezentálásosabb szakaszok. Ezeket gyakran használják dokumentumösszesítésként. A rendszer csak "szemantikai" típusú lekérdezések esetén ad vissza feliratokat. |
|
@search.documentDebugInfo |
Hibakeresési információkat tartalmaz, amelyek a keresési eredmények további feltárására használhatók. |
|
@search.highlights |
object |
A dokumentum szövegtöredékei, amelyek az egyező keresési kifejezéseket jelzik, az egyes alkalmazható mezők szerint rendezve; null értékű, ha a találatkiemelés nem volt engedélyezve a lekérdezéshez. |
@search.rerankerScore |
number |
A legfontosabb keresési eredmények szemantikai rangsorolója által kiszámított relevanciapont. A keresési eredményeket először a RerankerScore, majd a Pontszám szerint rendezi a rendszer. A RerankerScore csak "szemantikus" típusú lekérdezések esetén lesz visszaadva. |
@search.score |
number |
A dokumentum relevanciapontszáma a lekérdezés által visszaadott többi dokumentumhoz képest. |
SearchScoreThreshold
A vektoros lekérdezés eredményei a "@search.score" érték alapján lesznek szűrve. Vegye figyelembe, hogy ez a @search.score keresési válasz részeként visszaadott érték. A küszöbérték iránya a magasabb @search.scoreértékhez lesz kiválasztva.
Name | Típus | Description |
---|---|---|
kind |
string:
search |
A vektoros lekérdezések szűréséhez használt küszöbérték típusa |
value |
number |
A küszöbérték a "@search.score" érték alapján lesz szűrve. Vegye figyelembe, hogy ez a @search.score keresési válasz részeként visszaadott érték. A küszöbérték iránya a magasabb @search.scoreértékhez lesz kiválasztva. |
SemanticDebugInfo
Name | Típus | Description |
---|---|---|
contentFields |
A szemantikai bővítési folyamatnak küldött tartalommezők, valamint a használatuk |
|
keywordFields |
A szemantikai bővítési folyamatnak küldött kulcsszómezők, valamint azok felhasználási módjának |
|
rerankerInput |
A szemantikai bővítési folyamatba küldött nyers összefűzött sztringek. |
|
titleField |
A szemantikai bővítési folyamatnak küldött címmező, valamint a használatuk |
SemanticErrorMode
Lehetővé teszi a felhasználó számára, hogy eldöntse, hogy egy szemantikai hívásnak teljesen sikertelennek kell-e lennie, vagy részleges eredményeket ad vissza (alapértelmezett).
Name | Típus | Description |
---|---|---|
fail |
string |
Ha a szemantikai feldolgozási lépés során kivétel történik, a lekérdezés sikertelen lesz, és a hibától függően visszaadja a megfelelő HTTP-kódot. |
partial |
string |
Ha a szemantikai feldolgozás sikertelen, a részleges eredmények továbbra is visszatérnek. A részleges eredmények definíciója attól függ, hogy melyik szemantikai lépés meghiúsult, és mi volt a hiba oka. |
SemanticErrorReason
Annak oka, hogy a rendszer részleges választ adott vissza egy szemantikai rangsorolási kérelemre.
Name | Típus | Description |
---|---|---|
capacityOverloaded |
string |
A rendszer szabályozta a kérelmet. Csak az alaperedmények lettek visszaadva. |
maxWaitExceeded |
string |
Ha a "szemanticMaxWaitInMilliseconds" érték be van állítva, és a szemantikai feldolgozási időtartam túllépte ezt az értéket. Csak az alaperedmények lettek visszaadva. |
transient |
string |
A szemantikai folyamat legalább egy lépése sikertelen volt. |
SemanticFieldState
A mező szemantikai bővítési folyamathoz való felhasználási módja (teljes mértékben, részben vagy nem használt)
Name | Típus | Description |
---|---|---|
partial |
string |
A mezőt részben szemantikai bővítéshez használták. |
unused |
string |
A mezőt nem használták szemantikai bővítéshez. |
used |
string |
A mezőt teljes mértékben a szemantikai bővítéshez használták. |
SemanticSearchResultsType
A szemantikai rangsorolási kéréshez visszaadott részleges válasz típusa.
Name | Típus | Description |
---|---|---|
baseResults |
string |
Szemantikai dúsítás vagy reranking nélküli eredmények. |
rerankedResults |
string |
Az eredmények a reranker modellel lettek újraküldve, és szemantikai feliratokat tartalmaznak. Ezek nem tartalmaznak válaszokat, válaszkiemeléseket vagy képaláírás kiemeléseket. |
VectorFilterMode
Meghatározza, hogy a szűrők alkalmazása a vektorkeresés előtt vagy után történjen-e.
Name | Típus | Description |
---|---|---|
postFilter |
string |
A szűrő a vektoreredmények jelölt készletének visszaadása után lesz alkalmazva. A szűrő szelektivitásától függően ez a k paraméter által kértnél kevesebb eredményt eredményezhet. |
preFilter |
string |
A szűrő a keresési lekérdezés előtt lesz alkalmazva. |
VectorizableImageBinaryQuery
A vektorkereséshez használandó lekérdezési paraméterek, ha egy vektorizálandó kép 64-ben kódolt bináris alapfájlját adja meg.
Name | Típus | Description |
---|---|---|
base64Image |
string |
A vektoros keresési lekérdezés végrehajtásához vektorizálandó kép 64-ben kódolt bináris alapja. |
exhaustive |
boolean |
Ha igaz, a teljes k-legközelebbi szomszédkeresést aktiválja a vektorindex összes vektorában. Olyan helyzetekben hasznos, ahol a pontos egyezések kritikus fontosságúak, például az alapvető igazságértékek meghatározása. |
fields |
string |
A keresett vektorban szerepeltetni kívánt Gyűjtemény(Edm.Single) típusú vektormezők. |
k |
integer |
Azoknak a legközelebbi szomszédoknak a száma, aki a legnagyobb találatként tér vissza. |
kind |
string:
image |
A végrehajtott vektoros lekérdezés típusa. |
oversampling |
number |
Túlbélyegzési tényező. A minimális érték 1. Felülbírálja az indexdefinícióban konfigurált defaultOversampling paramétert. Csak akkor állítható be, ha a "rerankWithOriginalVectors" igaz. Ez a paraméter csak akkor engedélyezett, ha a mögöttes vektormezőn tömörítési módszert használ. |
threshold | VectorThreshold: |
A vektoros lekérdezésekhez használt küszöbérték. Vegye figyelembe, hogy ez csak akkor állítható be, ha minden "mező" ugyanazt a hasonlósági metrikát használja. |
weight |
number |
A vektoros lekérdezés relatív súlya, ha összehasonlítja a többi vektoros lekérdezéssel és/vagy a szöveges lekérdezéssel ugyanabban a keresési kérelemben. Ez az érték a különböző vektoros lekérdezések és/vagy a szöveges lekérdezésen keresztül lekért eredmények több rangsorolási lista eredményeinek kombinálásakor használatos. Minél nagyobb a súly, annál magasabb lesz a lekérdezésnek megfelelő dokumentumok végső rangsorolása. Az alapértelmezett érték 1,0, és az értéknek nullánál nagyobb pozitív számnak kell lennie. |
VectorizableImageUrlQuery
A vektorkereséshez használandó lekérdezési paraméterek, ha meg van adva egy olyan URL, amely egy vektorizálandó képértéket jelöl.
Name | Típus | Description |
---|---|---|
exhaustive |
boolean |
Ha igaz, a teljes k-legközelebbi szomszédkeresést aktiválja a vektorindex összes vektorában. Olyan helyzetekben hasznos, ahol a pontos egyezések kritikus fontosságúak, például az alapvető igazságértékek meghatározása. |
fields |
string |
A keresett vektorban szerepeltetni kívánt Gyűjtemény(Edm.Single) típusú vektormezők. |
k |
integer |
Azoknak a legközelebbi szomszédoknak a száma, aki a legnagyobb találatként tér vissza. |
kind |
string:
image |
A végrehajtott vektoros lekérdezés típusa. |
oversampling |
number |
Túlbélyegzési tényező. A minimális érték 1. Felülbírálja az indexdefinícióban konfigurált defaultOversampling paramétert. Csak akkor állítható be, ha a "rerankWithOriginalVectors" igaz. Ez a paraméter csak akkor engedélyezett, ha a mögöttes vektormezőn tömörítési módszert használ. |
threshold | VectorThreshold: |
A vektoros lekérdezésekhez használt küszöbérték. Vegye figyelembe, hogy ez csak akkor állítható be, ha minden "mező" ugyanazt a hasonlósági metrikát használja. |
url |
string |
A vektoros keresési lekérdezés végrehajtásához vektorizálandó kép URL-címe. |
weight |
number |
A vektoros lekérdezés relatív súlya, ha összehasonlítja a többi vektoros lekérdezéssel és/vagy a szöveges lekérdezéssel ugyanabban a keresési kérelemben. Ez az érték a különböző vektoros lekérdezések és/vagy a szöveges lekérdezésen keresztül lekért eredmények több rangsorolási lista eredményeinek kombinálásakor használatos. Minél nagyobb a súly, annál magasabb lesz a lekérdezésnek megfelelő dokumentumok végső rangsorolása. Az alapértelmezett érték 1,0, és az értéknek nullánál nagyobb pozitív számnak kell lennie. |
VectorizableTextQuery
A vektorkereséshez használandó lekérdezési paraméterek, ha meg van adva egy vektorizálandó szöveges érték.
Name | Típus | Description |
---|---|---|
exhaustive |
boolean |
Ha igaz, a teljes k-legközelebbi szomszédkeresést aktiválja a vektorindex összes vektorában. Olyan helyzetekben hasznos, ahol a pontos egyezések kritikus fontosságúak, például az alapvető igazságértékek meghatározása. |
fields |
string |
A keresett vektorban szerepeltetni kívánt Gyűjtemény(Edm.Single) típusú vektormezők. |
k |
integer |
Azoknak a legközelebbi szomszédoknak a száma, aki a legnagyobb találatként tér vissza. |
kind |
string:
text |
A végrehajtott vektoros lekérdezés típusa. |
oversampling |
number |
Túlbélyegzési tényező. A minimális érték 1. Felülbírálja az indexdefinícióban konfigurált defaultOversampling paramétert. Csak akkor állítható be, ha a "rerankWithOriginalVectors" igaz. Ez a paraméter csak akkor engedélyezett, ha a mögöttes vektormezőn tömörítési módszert használ. |
text |
string |
A vektoros keresési lekérdezés végrehajtásához használandó szöveg. |
threshold | VectorThreshold: |
A vektoros lekérdezésekhez használt küszöbérték. Vegye figyelembe, hogy ez csak akkor állítható be, ha minden "mező" ugyanazt a hasonlósági metrikát használja. |
weight |
number |
A vektoros lekérdezés relatív súlya, ha összehasonlítja a többi vektoros lekérdezéssel és/vagy a szöveges lekérdezéssel ugyanabban a keresési kérelemben. Ez az érték a különböző vektoros lekérdezések és/vagy a szöveges lekérdezésen keresztül lekért eredmények több rangsorolási lista eredményeinek kombinálásakor használatos. Minél nagyobb a súly, annál magasabb lesz a lekérdezésnek megfelelő dokumentumok végső rangsorolása. Az alapértelmezett érték 1,0, és az értéknek nullánál nagyobb pozitív számnak kell lennie. |
VectorQueryKind
A végrehajtott vektoros lekérdezés típusa.
Name | Típus | Description |
---|---|---|
imageBinary |
string |
Vektoros lekérdezés, ahol egy vektorizálandó kép 64 kódolású bináris alapfájlja van megadva. |
imageUrl |
string |
Vektoros lekérdezés, ahol a vektorizálni kívánt képértéket jelölő URL-cím van megadva. |
text |
string |
Vektoros lekérdezés, ahol egy vektorizálandó szöveges érték van megadva. |
vector |
string |
Vektoros lekérdezés, ahol nyers vektorérték van megadva. |
VectorSimilarityThreshold
A vektoros lekérdezés eredményei a vektoros hasonlóság metrika alapján lesznek szűrve. Vegye figyelembe, hogy ez a hasonlósági metrika canonikus definíciója, nem pedig a "távolság" verziója. A küszöbérték iránya (nagyobb vagy kisebb) automatikusan lesz kiválasztva a mező által használt metrikának megfelelően.
Name | Típus | Description |
---|---|---|
kind |
string:
vector |
A vektoros lekérdezések szűréséhez használt küszöbérték típusa |
value |
number |
A küszöbérték a hasonlósági metrika értéke alapján fog szűrni. Vegye figyelembe, hogy ez a hasonlósági metrika canonikus definíciója, nem pedig a "távolság" verziója. A küszöbérték iránya (nagyobb vagy kisebb) automatikusan lesz kiválasztva a mező által használt metrikának megfelelően. |
VectorThresholdKind
A végrehajtott vektoros lekérdezés típusa.
Name | Típus | Description |
---|---|---|
searchScore |
string |
A vektoros lekérdezés eredményei a "@search.score" érték alapján lesznek szűrve. Vegye figyelembe, hogy ez a @search.score keresési válasz részeként visszaadott érték. A küszöbérték iránya a magasabb @search.scoreértékhez lesz kiválasztva. |
vectorSimilarity |
string |
A vektoros lekérdezés eredményei a vektoros hasonlóság metrika alapján lesznek szűrve. Vegye figyelembe, hogy ez a hasonlósági metrika canonikus definíciója, nem pedig a "távolság" verziója. A küszöbérték iránya (nagyobb vagy kisebb) automatikusan lesz kiválasztva a mező által használt metrikának megfelelően. |