Documents - Search Get

Reference

Služba:: Search Service

Verze rozhraní API:: 2024-09-01-preview

Vyhledá dokumenty v indexu.

GET {endpoint}/indexes('{indexName}')/docs?api-version=2024-09-01-preview

S volitelnými parametry:

GET {endpoint}/indexes('{indexName}')/docs?search={search}&$count={$count}&facet={facet}&$filter={$filter}&highlight={highlight}&highlightPostTag={highlightPostTag}&highlightPreTag={highlightPreTag}&minimumCoverage={minimumCoverage}&$orderby={$orderby}&queryType={queryType}&scoringParameter={scoringParameter}&scoringProfile={scoringProfile}&searchFields={searchFields}&searchMode={searchMode}&scoringStatistics={scoringStatistics}&sessionId={sessionId}&$select={$select}&$skip={$skip}&$top={$top}&api-version=2024-09-01-preview&semanticConfiguration={semanticConfiguration}&semanticErrorHandling={semanticErrorHandling}&semanticMaxWaitInMilliseconds={semanticMaxWaitInMilliseconds}&answers={answers}&captions={captions}&semanticQuery={semanticQuery}&debug={debug}&queryLanguage={queryLanguage}&speller={speller}&semanticFields={semanticFields}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Adresa URL koncového bodu vyhledávací služby.
indexName	path	True	string	Název indexu.
api-version	query	True	string	Verze rozhraní API klienta.
$count	query		boolean	Hodnota, která určuje, zda se má načíst celkový počet výsledků. Výchozí hodnota je false. Nastavení této hodnoty na hodnotu True může mít vliv na výkon. Všimněte si, že vrácený počet představuje aproximaci.
$filter	query		string	Výraz $filter OData, který se má použít pro vyhledávací dotaz.
$orderby	query		string[]	Seznam výrazů $orderby OData, podle kterých se mají výsledky seřadit. Každý výraz může být buď název pole, nebo volání funkce geo.distance() nebo search.score(). Za každým výrazem může následovat asc, který označuje vzestupně, a desc označuje sestupně. Výchozí hodnota je vzestupné pořadí. Vazby budou přerušeny skóre shody dokumentů. Pokud není zadána žádná položka OrderBy, výchozí pořadí řazení je sestupné podle skóre shody dokumentu. Může existovat maximálně 32 $orderby klauzulí.
$select	query		string[]	Seznam polí, která se mají načíst. Pokud není zadáno, jsou zahrnuta všechna pole označená jako načítaná ve schématu.
$skip	query		integer int32	Počet výsledků hledání, které chcete přeskočit. Tato hodnota nemůže být větší než 100 000. Pokud potřebujete skenovat dokumenty v sekvenci, ale nemůžete kvůli tomuto omezení použít $skip, zvažte použití $orderby u zcela seřazeného klíče a $filter s dotazem rozsahu.
$top	query		integer int32	Počet výsledků hledání, které se mají načíst. To lze použít ve spojení s $skip k implementaci stránkování výsledků hledání na straně klienta. Pokud se výsledky zkrátí kvůli stránkování na straně serveru, odpověď bude obsahovat pokračovací token, který se dá použít k vydání další žádosti o vyhledávání na další stránce výsledků.
answers	query		QueryAnswerType	Tento parametr je platný pouze v případě, že je typ dotazu `semantic`. Pokud je tato možnost nastavená, dotaz vrátí odpovědi extrahované z klíčových pasáží v nejřadivějších dokumentech. Počet vrácených odpovědí lze nakonfigurovat tak, že za hodnotou parametru odpovědi, například `extractive\|count-3`, připojíte znak kanálu `\|` následovanou možností `count-<number of answers>` . Výchozí počet je 1. Prahovou hodnotu spolehlivosti lze nakonfigurovat připojením znaku svislé roury `\|` následovanou možností `threshold-<confidence threshold>` za hodnotou parametru odpovědi, například `extractive\|threshold-0.9`. Výchozí prahová hodnota je 0,7.
captions	query		QueryCaptionType	Tento parametr je platný pouze v případě, že je typ dotazu `semantic`. Pokud je tato možnost nastavená, dotaz vrátí titulky extrahované z klíčových pasáží v nejřadivějších dokumentech. Pokud jsou titulky nastavené na `extractive`, zvýraznění je ve výchozím nastavení povolené a lze ho nakonfigurovat připojením znaku kanálu `\|` následovanou možností `highlight-<true/false>`, například `extractive\|highlight-true`. Výchozí hodnota je `None`.
debug	query		QueryDebugMode	Umožňuje nástroj pro ladění, který se dá použít k dalšímu zkoumání výsledků hledání.
facet	query		string[]	Seznam výrazů omezujících vlastností, které se mají použít u vyhledávacího dotazu. Každý výraz omezující vlastnosti obsahuje název pole, volitelně následovaný čárkami odděleným seznamem párů name:value.
highlight	query		string[]	Seznam názvů polí, které se mají použít pro zvýraznění hitů Ke zvýraznění hitů se dají použít jenom prohledávatelná pole.
highlightPostTag	query		string	Značka řetězce, která se připojí k zvýraznění. Je nutné nastavit zvýrazněníPreTag. Výchozí hodnota je </em>.
highlightPreTag	query		string	Značka řetězce, která je předem zvýrazněná. Musí být nastavena značka highlightPostTag. Výchozí hodnota je <>.
minimumCoverage	query		number double	Číslo mezi 0 a 100 označující procento indexu, které musí být pokryto vyhledávacím dotazem, aby se dotaz ohlásil jako úspěšný. Tento parametr může být užitečný pro zajištění dostupnosti vyhledávání i pro služby s jedinou replikou. Výchozí hodnota je 100.
queryLanguage	query		QueryLanguage	Jazyk dotazu.
queryType	query		QueryType	Hodnota, která určuje syntaxi vyhledávacího dotazu. Výchozí hodnota je "jednoduchá". Pokud dotaz používá syntaxi dotazu Lucene, použijte "full".
scoringParameter	query		string[]	Seznam hodnot parametrů, které se mají použít v bodovacích funkcích (například referencePointParameter) pomocí hodnot názvu formátu. Pokud například profil bodování definuje funkci s parametrem "mylocation", řetězec parametru by byl "mylocation--122.2,44.8" (bez uvozovek).
scoringProfile	query		string	Název bodujícího profilu, který má vyhodnotit skóre shody pro odpovídající dokumenty, aby se výsledky seřadily.
scoringStatistics	query		ScoringStatistics	Hodnota, která určuje, jestli chceme vypočítat statistiku bodování (například četnost dokumentů) globálně pro konzistentnější bodování nebo místně pro nižší latenci.
search	query		string	Výraz dotazu fulltextového vyhledávání; Pokud chcete shodovat všechny dokumenty, použijte *nebo tento parametr vynecháte.
searchFields	query		string[]	Seznam názvů polí, na které chcete nastavit obor fulltextového vyhledávání. Při použití vyhledávacího pole (fieldName:searchExpression) v úplném dotazu Lucene mají názvy polí každého hledaného výrazu přednost před názvy polí uvedených v tomto parametru.
searchMode	query		SearchMode	Hodnota, která určuje, jestli se musí některé nebo všechny hledané termíny shodovat, aby se dokument spočítal jako shoda.
semanticConfiguration	query		string	Název sémantické konfigurace, která obsahuje seznam polí, která se mají použít pro sémantické řazení, titulky, zvýraznění a odpovědi
semanticErrorHandling	query		SemanticErrorMode	Umožňuje uživateli zvolit, jestli má sémantické volání selhat úplně, nebo vrátit částečné výsledky (výchozí).
semanticFields	query		string[]	Seznam názvů polí používaných pro sémantické řazení.
semanticMaxWaitInMilliseconds	query		integer int32	Umožňuje uživateli nastavit horní mez doby, kterou trvá dokončení zpracování sémantického rozšiřování, než požadavek selže.
semanticQuery	query		string	Umožňuje nastavit samostatný vyhledávací dotaz, který se bude používat výhradně pro sémantické reranking, sémantické titulky a sémantické odpovědi. Je užitečné ve scénářích, kdy je potřeba používat různé dotazy mezi základní fází načítání a řazení a sémantickou fází L2.
sessionId	query		string	Hodnota, která se má použít k vytvoření rychlé relace, která může pomoct získat konzistentnější výsledky. Pokud se použije stejné ID relace, provede se pokus o dosažení maximálního úsilí, aby cílil na stejnou sadu replik. Buďte opatrní, že opakované použití stejných hodnot SESSIONID může narušit vyrovnávání zatížení požadavků napříč replikami a nepříznivě ovlivnit výkon vyhledávací služby. Hodnota použitá jako sessionId nemůže začínat znakem _.
speller	query		Speller	Vylepšete úplnost vyhledávání tím, že opravíte jednotlivé hledané termíny.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-request-id		string uuid	ID sledování odeslané s požadavkem, které vám pomůže s laděním.

Odpovědi

Name	Typ	Description
200 OK	SearchDocumentsResult	Odpověď obsahující dokumenty, které odpovídají kritériím hledání.
Other Status Codes	ErrorResponse	Chybová odpověď.

Příklady

SearchIndexSearchDocumentsGet

SearchIndexSearchDocumentsSemanticGet

SearchIndexSearchDocumentsGet

Ukázkový požadavek

HTTP

GET https://myservice.search.windows.net/indexes('myindex')/docs?search=nice hotels&$count=True&facet=category,count:10,sort:count&$filter=rating gt 10&highlight=title&highlightPostTag=</em>&highlightPreTag=<em>&minimumCoverage=80&$orderby=search.score() desc,rating desc&queryType=simple&scoringProfile=sp&searchFields=title,description&searchMode=any&scoringStatistics=global&sessionId=mysessionid&$select=docId,title,description&$skip=100&$top=10&api-version=2024-09-01-preview&speller={speller}

Ukázková odpověď

Stavový kód:: 200

{
  "@odata.count": 25,
  "@search.coverage": 80,
  "@search.facets": {
    "category": [
      {
        "count": 1,
        "value": "Economy"
      },
      {
        "count": 1,
        "value": "Luxury"
      }
    ]
  },
  "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"
    }
  ]
}

SearchIndexSearchDocumentsSemanticGet

Ukázkový požadavek

HTTP

GET https://myservice.search.windows.net/indexes('myindex')/docs?search=how do clouds form&$count=True&highlightPostTag=</em>&highlightPreTag=<em>&queryType=semantic&api-version=2024-09-01-preview&semanticConfiguration=my-semantic-config&semanticErrorHandling=partial&semanticMaxWaitInMilliseconds=780&answers=extractive|count-3&captions=extractive|highlight-true&semanticQuery={semanticQuery}&semanticFields={semanticFields}

Ukázková odpověď

Stavový kód:: 200

{
  "@odata.count": 25,
  "@search.answers": [
    {
      "key": "4123",
      "text": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form where air is ascending (over land in this case),   but not where it is descending (over the river).",
      "highlights": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form<em> where air is ascending</em> (over land in this case),   but not where it is<em> descending</em> (over the river).",
      "score": 0.94639826
    }
  ],
  "value": [
    {
      "@search.score": 0.5479723,
      "@search.rerankerScore": 1.0321671911515296,
      "@search.captions": [
        {
          "text": "Like all clouds, it forms when the air reaches its dew point—the temperature at which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley fog, which is common in the Pacific Northwest of North America.",
          "highlights": "Like all<em> clouds</em>, it<em> forms</em> when the air reaches its dew point—the temperature at    which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley<em> fog</em>, which is common in the Pacific Northwest of North America."
        }
      ],
      "id": "4123",
      "title": "Earth Atmosphere",
      "content": "Fog is essentially a cloud lying on the ground. Like all clouds, it forms when the air reaches its dew point—the temperature at  \n\nwhich an air mass is cool enough for its water vapor to condense into liquid droplets.\n\nThis false-color image shows valley fog, which is common in the Pacific Northwest of North America. On clear winter nights, the \n\nground and overlying air cool off rapidly, especially at high elevations. Cold air is denser than warm air, and it sinks down into the \n\nvalleys. The moist air in the valleys gets chilled to its dew point, and fog forms. If undisturbed by winds, such fog may persist for \n\ndays. The Terra satellite captured this image of foggy valleys northeast of Vancouver in February 2010.\n\n\n",
      "locations": [
        "Pacific Northwest",
        "North America",
        "Vancouver"
      ]
    }
  ]
}

Definice

Name	Description
AnswerResult	Odpověď je textový úsek extrahovaný z obsahu nejrelevavantnějších dokumentů, které odpovídají dotazu. Odpovědi se extrahují z nejlepších výsledků hledání. Kandidáti na odpovědi jsou hodnoceni a vyberou se hlavní odpovědi.
CaptionResult	Titulky jsou nejvýraznější pasáže z dokumentu relativně do vyhledávacího dotazu. Často se používají jako souhrn dokumentů. Titulky jsou vráceny pouze pro dotazy typu `semantic`.
DocumentDebugInfo	Obsahuje informace o ladění, které lze použít k dalšímu zkoumání výsledků hledání.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
HybridCountAndFacetMode	Určuje, zda počet a omezující vlastnosti by měly obsahovat všechny dokumenty, které odpovídaly vyhledávacímu dotazu, nebo pouze dokumenty, které jsou načteny v okně maxTextRecallSize. Výchozí hodnota je countAllResults.
HybridSearch	Parametry dotazu pro konfiguraci chování hybridního vyhledávání
QueryAnswerType	Hodnota, která určuje, jestli se odpovědi mají vrátit jako součást odpovědi hledání.
QueryCaptionType	Hodnota, která určuje, zda mají být titulky vráceny jako součást odpovědi hledání.
QueryDebugMode	Umožňuje nástroj pro ladění, který se dá použít k dalšímu zkoumání výsledků hledání.
QueryLanguage	Jazyk dotazu.
QueryResultDocumentRerankerInput	Nezpracované zřetězené řetězce odeslané do sémantického procesu rozšiřování.
QueryResultDocumentSemanticField	Popis polí odeslaných do procesu sémantického rozšiřování a způsobu jejich použití
QueryResultDocumentSubscores	Rozpis dílčích jader mezi částmi textového a vektorového dotazu vyhledávacího dotazu pro tento dokument. Každý vektorový dotaz se zobrazí jako samostatný objekt ve stejném pořadí, v jakém byl přijat.
QuerySpellerType	Hodnota, která určila typ kontroly pravopisu, která se má použít ke kontrole pravopisu jednotlivých hledaných termínů dotazu.
QueryType	Určuje syntaxi vyhledávacího dotazu. Výchozí hodnota je "jednoduchá". Pokud dotaz používá syntaxi dotazu Lucene a sémantickou syntaxi, použijte full, pokud syntaxe dotazu není nutná.
RawVectorQuery	Parametry dotazu, které se mají použít pro vektorové vyhledávání při zadání nezpracované hodnoty vektoru.
ScoringStatistics	Hodnota, která určuje, jestli chceme vypočítat statistiku bodování (například četnost dokumentů) globálně pro konzistentnější bodování nebo místně pro nižší latenci. Výchozí hodnota je místní. Před vyhodnocením můžete použít globální agregaci statistik bodování. Použití globálních statistik bodování může zvýšit latenci vyhledávacích dotazů.
SearchDocumentsResult	Odpověď obsahující výsledky hledání z indexu
SearchMode	Určuje, jestli se musí některé nebo všechny hledané termíny shodovat, aby se dokument spočítal jako shoda.
SearchRequest	Parametry pro filtrování, řazení, fasetování, stránkování a další chování vyhledávacích dotazů
SearchResult	Obsahuje dokument nalezený vyhledávacím dotazem a přidruženými metadaty.
SearchScoreThreshold	Výsledky vektorového dotazu se budou filtrovat na základě hodnoty @search.score. Všimněte si, že se jedná o @search.score vrácenou jako součást odpovědi hledání. Směr prahové hodnoty bude zvolen pro vyšší @search.score.
SemanticDebugInfo
SemanticErrorMode	Umožňuje uživateli zvolit, jestli má sémantické volání selhat úplně (výchozí nebo aktuální chování) nebo vrátit částečné výsledky.
SemanticErrorReason	Důvod, proč byla vrácena částečná odpověď pro sémantickou žádost o řazení.
SemanticFieldState	Způsob použití pole pro sémantický proces rozšiřování (plně používaný, částečně použitý nebo nepoužitý)
SemanticSearchResultsType	Typ částečné odpovědi, která byla vrácena pro sémantickou žádost o řazení.
SingleVectorFieldResult	Výsledek jednoho vektorového pole. Vrátí se hodnoty @search.score i vektorové podobnosti. Vektorová podobnost souvisí s @search.score rovnicí.
Speller	Vylepšete úplnost vyhledávání tím, že opravíte jednotlivé hledané termíny.
TextResult	Skóre BM25 nebo Classic pro text v dotazu.
VectorFilterMode	Určuje, zda jsou filtry použity před nebo po provedení vektorového vyhledávání.
VectorizableImageBinaryQuery	Parametry dotazu, které se mají použít pro vektorové vyhledávání, když je k dispozici binární soubor s kódováním base 64 obrázku, který je potřeba vektorizovat.
VectorizableImageUrlQuery	Parametry dotazu, které se mají použít pro vektorové vyhledávání, pokud je k dispozici adresa URL představující hodnotu obrázku, kterou je potřeba vektorizovat.
VectorizableTextQuery	Parametry dotazu, které se mají použít pro vektorové vyhledávání, pokud je k dispozici textová hodnota, která musí být vektorizována.
VectorQueryKind	Druh vektorového dotazu, který se provádí.
VectorsDebugInfo
VectorSimilarityThreshold	Výsledky vektorového dotazu budou filtrovány na základě metriky podobnosti vektoru. Všimněte si, že se jedná o kanonickou definici metriky podobnosti, nikoli verzi "vzdálenosti". Směr prahové hodnoty (větší nebo menší) se vybere automaticky podle metriky používané polem.
VectorThresholdKind	Druh vektorového dotazu, který se provádí.

AnswerResult

Odpověď je textový úsek extrahovaný z obsahu nejrelevavantnějších dokumentů, které odpovídají dotazu. Odpovědi se extrahují z nejlepších výsledků hledání. Kandidáti na odpovědi jsou hodnoceni a vyberou se hlavní odpovědi.

Name	Typ	Description
highlights	string	Stejný textový úsek jako ve vlastnosti Text se zvýrazněnými textovými frázemi, které jsou pro dotaz nejrelevantní.
key	string	Klíč dokumentu, ze které byla odpověď extrahována.
score	number	Hodnota skóre představuje, jak relevantní je odpověď na dotaz vzhledem k jiným odpovědím vrácených pro dotaz.
text	string	Textová část extrahovaná z obsahu dokumentu jako odpověď.

CaptionResult

Titulky jsou nejvýraznější pasáže z dokumentu relativně do vyhledávacího dotazu. Často se používají jako souhrn dokumentů. Titulky jsou vráceny pouze pro dotazy typu semantic.

Name	Typ	Description
highlights	string	Stejný textový úsek jako ve vlastnosti Text se zvýrazněnými frázemi, které jsou pro dotaz nejrelevantní.
text	string	Reprezentativní textový úsek extrahovaný z dokumentu, který je pro vyhledávací dotaz nejrelevavantnější.

DocumentDebugInfo

Obsahuje informace o ladění, které lze použít k dalšímu zkoumání výsledků hledání.

Name	Typ	Description
semantic	SemanticDebugInfo	Obsahuje informace o ladění specifické pro sémantické žádosti o řazení.
vectors	VectorsDebugInfo	Obsahuje informace o ladění specifické pro vektorové a hybridní vyhledávání.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

HybridCountAndFacetMode

Určuje, zda počet a omezující vlastnosti by měly obsahovat všechny dokumenty, které odpovídaly vyhledávacímu dotazu, nebo pouze dokumenty, které jsou načteny v okně maxTextRecallSize. Výchozí hodnota je countAllResults.

Name	Typ	Description
countAllResults	string	Při výpočtu počtu a omezujících vlastností zahrňte všechny dokumenty, které vyhledávací dotaz spároval, bez ohledu na to, jestli se tyto dokumenty nacházejí v okně načítání maxTextRecallSize.
countRetrievableResults	string	Při výpočtu počtu a omezujících vlastností zahrňte pouze dokumenty, které byly v okně načítání maxTextRecallSize shodné.

HybridSearch

Parametry dotazu pro konfiguraci chování hybridního vyhledávání

Name	Typ	Description
countAndFacetMode	HybridCountAndFacetMode	Určuje, zda počet a omezující vlastnosti by měly obsahovat všechny dokumenty, které odpovídaly vyhledávacímu dotazu, nebo pouze dokumenty, které jsou načteny v okně maxTextRecallSize.
maxTextRecallSize	integer	Určuje maximální početdokumentůch Tyto dokumenty se zkombinují s dokumenty odpovídajícími vektorovým dotazům a vytvoří jeden konečný seznam výsledků. Volba větší hodnoty maxTextRecallSize umožní načítání a stránkování prostřednictvím více dokumentů (pomocí horních a přeskočovaných parametrů) za cenu vyššího využití prostředků a vyšší latence. Hodnota musí být v rozmezí od 1 do 10 000. Výchozí hodnota je 1000.

QueryAnswerType

Hodnota, která určuje, jestli se odpovědi mají vrátit jako součást odpovědi hledání.

Name	Typ	Description
extractive	string	Extrahuje kandidáty odpovědí z obsahu dokumentů vrácených v reakci na dotaz vyjádřený jako otázka v přirozeném jazyce.
none	string	Nevracejte odpovědi na dotaz.

QueryCaptionType

Hodnota, která určuje, zda mají být titulky vráceny jako součást odpovědi hledání.

Name	Typ	Description
extractive	string	Extrahuje titulky z odpovídajících dokumentů, které obsahují pasáže relevantní pro vyhledávací dotaz.
none	string	Nevracejte titulky pro dotaz.

QueryDebugMode

Umožňuje nástroj pro ladění, který se dá použít k dalšímu zkoumání výsledků hledání.

Name	Typ	Description
disabled	string	Nebudou vráceny žádné informace o ladění dotazů.
semantic	string	Umožňuje uživateli dále prozkoumat výsledky seřazené podle pořadí.

QueryLanguage

Jazyk dotazu.

Name	Typ	Description
ar-eg	string	Hodnota dotazovacího jazyka pro arabštinu (Egypt).
ar-jo	string	Hodnota dotazovacího jazyka pro arabštinu (Jordánsko).
ar-kw	string	Hodnota dotazovacího jazyka pro arabštinu (Kuvajt).
ar-ma	string	Hodnota dotazovacího jazyka pro arabštinu (Maroko).
ar-sa	string	Hodnota dotazovacího jazyka pro arabštinu (Saúdská Arábie).
bg-bg	string	Hodnota dotazovacího jazyka pro bulharštinu (Bulharsko).
bn-in	string	Hodnota dotazovacího jazyka pro Bengali (Indie).
ca-es	string	Hodnota dotazovacího jazyka pro katalánštinu
cs-cz	string	Hodnota dotazovacího jazyka pro češtinu (Česká republika).
da-dk	string	Hodnota dotazovacího jazyka pro dánštinu (Dánsko).
de-de	string	Hodnota dotazovacího jazyka pro němčinu (Německo).
el-gr	string	Hodnota dotazovacího jazyka pro řečtinu (Řecko).
en-au	string	Hodnota dotazovacího jazyka pro angličtinu (Austrálie).
en-ca	string	Hodnota dotazovacího jazyka pro angličtinu (Kanada).
en-gb	string	Hodnota dotazovacího jazyka pro angličtinu (Velká Británie).
en-in	string	Hodnota dotazovacího jazyka pro angličtinu (Indie).
en-us	string	Hodnota dotazovacího jazyka pro angličtinu (Spojené státy).
es-es	string	Hodnota dotazovacího jazyka pro španělštinu (Španělsko).
es-mx	string	Hodnota dotazovacího jazyka pro španělštinu (Mexiko).
et-ee	string	Hodnota dotazovacího jazyka pro Estonštinu (Estonsko).
eu-es	string	Hodnota dotazovacího jazyka pro baskičtina
fa-ae	string	Hodnota dotazovacího jazyka pro perštinu (USA).
fi-fi	string	Hodnota dotazovacího jazyka pro finštinu (Finsko).
fr-ca	string	Hodnota dotazovacího jazyka pro francouzštinu (Kanada).
fr-fr	string	Hodnota jazyka dotazu pro francouzštinu (Francie).
ga-ie	string	Hodnota dotazovacího jazyka pro irštinu (Irsko).
gl-es	string	Hodnota dotazovacího jazyka pro Galicijštinu
gu-in	string	Hodnota dotazovacího jazyka pro Gujarati (Indie).
he-il	string	Hodnota dotazovacího jazyka pro hebrejštinu (Izrael).
hi-in	string	Hodnota dotazovacího jazyka pro hindštinu (Indie).
hr-ba	string	Hodnota dotazovacího jazyka pro chorvatštinu (Bosna a Hercegovina).
hr-hr	string	Hodnota dotazovacího jazyka pro chorvatštinu (Chorvatsko).
hu-hu	string	Hodnota dotazovacího jazyka pro maďarštinu (Maďarsko).
hy-am	string	Hodnota dotazovacího jazyka pro Arménii (Arménie).
id-id	string	Hodnota dotazovacího jazyka pro indonéštinu (Indonésie).
is-is	string	Hodnota dotazovacího jazyka islandštiny (Island).
it-it	string	Hodnota dotazovacího jazyka pro italštinu (Itálie).
ja-jp	string	Hodnota dotazovacího jazyka pro japonštinu (Japonsko).
kn-in	string	Hodnota dotazovacího jazyka pro Kannada (Indie).
ko-kr	string	Hodnota dotazovacího jazyka pro korejštinu (Korea).
lt-lt	string	Hodnota dotazovacího jazyka pro litevštinu (Litva).
lv-lv	string	Hodnota dotazovacího jazyka pro lotyštinu (Lotyšsko).
ml-in	string	Hodnota dotazovacího jazyka pro Malayalam (Indie).
mr-in	string	Hodnota dotazovacího jazyka pro Marathi (Indie).
ms-bn	string	Hodnota dotazovacího jazyka pro Malajštinu (Brunej Darussalam).
ms-my	string	Hodnota dotazovacího jazyka pro Malajštinu (Malajsie).
nb-no	string	Hodnota dotazovacího jazyka pro norštinu (Norsko).
nl-be	string	Hodnota dotazovacího jazyka pro holandštinu (Belgie).
nl-nl	string	Hodnota dotazovacího jazyka pro holandštinu (Nizozemsko).
no-no	string	Hodnota dotazovacího jazyka pro norštinu (Norsko).
none	string	Nebyl zadán dotazovací jazyk.
pa-in	string	Hodnota dotazovacího jazyka pro Padžábi (Indie).
pl-pl	string	Hodnota dotazovacího jazyka pro polštinu (Polsko).
pt-br	string	Hodnota dotazovacího jazyka pro portugalštinu (Brazílie).
pt-pt	string	Hodnota dotazovacího jazyka pro portugalštinu (Portugalsko).
ro-ro	string	Hodnota dotazovacího jazyka pro rumunštinu (Rumunsko).
ru-ru	string	Hodnota dotazovacího jazyka pro ruštinu (Rusko).
sk-sk	string	Hodnota dotazovacího jazyka pro slovenštinu (Slovensko).
sl-sl	string	Hodnota dotazovacího jazyka pro slovinštinu (Slovinsko).
sr-ba	string	Hodnota dotazovacího jazyka pro srbštinu (Bosna a Hercegovina).
sr-me	string	Hodnota dotazovacího jazyka pro srbštinu (Černá Hora).
sr-rs	string	Hodnota dotazovacího jazyka pro srbštinu (Srbsko).
sv-se	string	Hodnota dotazovacího jazyka pro švédštinu (Švédsko).
ta-in	string	Hodnota dotazovacího jazyka pro tamilštinu (Indie).
te-in	string	Hodnota dotazovacího jazyka pro Telugu (Indie).
th-th	string	Hodnota dotazovacího jazyka pro thajštinu (Thajsko).
tr-tr	string	Hodnota dotazovacího jazyka pro turečtinu (Turecko).
uk-ua	string	Hodnota dotazovacího jazyka pro ukrajinštinu (Ukrajina).
ur-pk	string	Hodnota dotazovacího jazyka pro Urdu (Pákistán).
vi-vn	string	Hodnota dotazovacího jazyka pro vietnamštinu (Viet Nam).
zh-cn	string	Hodnota dotazovacího jazyka pro čínštinu (Čína).
zh-tw	string	Hodnota dotazovacího jazyka pro čínštinu (Tchaj-wan).

QueryResultDocumentRerankerInput

Nezpracované zřetězené řetězce odeslané do sémantického procesu rozšiřování.

Name	Typ	Description
content	string	Nezpracované zřetězené řetězce pro pole obsahu, která byla použita pro sémantické rozšiřování.
keywords	string	Nezpracované zřetězené řetězce pro pole klíčových slov, která byla použita pro sémantické rozšiřování.
title	string	Nezpracovaný řetězec pro pole názvu, které se použilo pro sémantické rozšiřování.

QueryResultDocumentSemanticField

Popis polí odeslaných do procesu sémantického rozšiřování a způsobu jejich použití

Name	Typ	Description
name	string	Název pole odeslaného do sémantického procesu rozšiřování
state	SemanticFieldState	Způsob použití pole pro sémantický proces rozšiřování (plně používaný, částečně použitý nebo nepoužitý)

QueryResultDocumentSubscores

Rozpis dílčích jader mezi částmi textového a vektorového dotazu vyhledávacího dotazu pro tento dokument. Každý vektorový dotaz se zobrazí jako samostatný objekt ve stejném pořadí, v jakém byl přijat.

Name	Typ	Description
documentBoost	number	Skóre BM25 nebo Classic pro text v dotazu.
text	TextResult	Skóre BM25 nebo Classic pro text v dotazu.
vectors	<string, SingleVectorFieldResult>	Vektorová podobnost a @search.score hodnoty pro každý vektorový dotaz.

QuerySpellerType

Hodnota, která určila typ kontroly pravopisu, která se má použít ke kontrole pravopisu jednotlivých hledaných termínů dotazu.

Name	Typ	Description
lexicon	string	Kontrola pravopisu opraví jednotlivé termíny dotazu pomocí statického lexikonu pro jazyk určený parametrem queryLanguage.
none	string	Kontrola pravopisu není povolená.

QueryType

Určuje syntaxi vyhledávacího dotazu. Výchozí hodnota je "jednoduchá". Pokud dotaz používá syntaxi dotazu Lucene a sémantickou syntaxi, použijte full, pokud syntaxe dotazu není nutná.

Name	Typ	Description
full	string	Používá úplnou syntaxi dotazu Lucene pro hledání. Hledaný text se interpretuje pomocí dotazovacího jazyka Lucene, který umožňuje vyhledávání specifické pro pole a vážené vyhledávání a také další pokročilé funkce.
semantic	string	Nejvhodnější pro dotazy vyjádřené v přirozeném jazyce na rozdíl od klíčových slov. Zlepšuje přesnost výsledků hledání opětovným řazením nejlepších výsledků hledání pomocí modelu řazení natrénovaného na webovém korpusu.
simple	string	Používá jednoduchou syntaxi dotazu pro vyhledávání. Hledaný text se interpretuje pomocí jednoduchého dotazovacího jazyka, který umožňuje symboly jako +, * a "". Dotazy se ve výchozím nastavení vyhodnocují ve všech prohledávatelných polích, pokud není zadaný parametr searchFields.

RawVectorQuery

Parametry dotazu, které se mají použít pro vektorové vyhledávání při zadání nezpracované hodnoty vektoru.

Name	Typ	Description
exhaustive	boolean	Pokud je hodnota true, aktivuje vyčerpávající hledání k-nejbližšího souseda napříč všemi vektory v indexu vektoru. Užitečné pro scénáře, ve kterých jsou přesné shody kritické, například určení hodnot základní pravdy.
fields	string	Vektorová pole typu Collection(Edm.Single), která mají být zahrnuta do vektorového vyhledávání.
filterOverride	string	Výraz filtru OData, který se má použít pro tento konkrétní vektorový dotaz. Pokud není na úrovni vektoru definován žádný výraz filtru, použije se místo toho výraz definovaný v parametru filtru nejvyšší úrovně.
k	integer	Početnejbližších
kind	string: vector	Druh vektorového dotazu, který se provádí.
oversampling	number	Faktor převzorkování Minimální hodnota je 1. Přepíše parametr defaultOversampling nakonfigurovaný v definici indexu. Lze ji nastavit pouze v případech, kdy je true rerankWithOriginalVectors. Tento parametr je povolen pouze v případě, že se metoda komprese použije v podkladovém vektorovém poli.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Prahová hodnota použitá pro vektorové dotazy. Všimněte si, že tuto možnost lze nastavit pouze v případě, že všechna pole používají stejnou metriku podobnosti.
vector	number[]	Vektorové znázornění vyhledávacího dotazu.
weight	number	Relativní váha vektorového dotazu ve srovnání s jinými vektorovými dotazy nebo textovým dotazem ve stejném požadavku hledání. Tato hodnota se používá při kombinování výsledků více seznamů řazení vytvořených různými vektorovými dotazy nebo výsledky načtenými prostřednictvím textového dotazu. Čím vyšší je váha, tím vyšší budou dokumenty, které odpovídají danému dotazu, v konečném pořadí. Výchozí hodnota je 1,0 a hodnota musí být kladné číslo větší než nula.

ScoringStatistics

Hodnota, která určuje, jestli chceme vypočítat statistiku bodování (například četnost dokumentů) globálně pro konzistentnější bodování nebo místně pro nižší latenci. Výchozí hodnota je místní. Před vyhodnocením můžete použít globální agregaci statistik bodování. Použití globálních statistik bodování může zvýšit latenci vyhledávacích dotazů.

Name	Typ	Description
global	string	Statistiky vyhodnocování se počítají globálně pro konzistentnější bodování.
local	string	Statistiky vyhodnocování se počítají místně, aby se snížila latence.

SearchDocumentsResult

Odpověď obsahující výsledky hledání z indexu

Name	Typ	Description
@odata.count	integer	Celkový počet výsledků nalezených operací hledání nebo hodnota null, pokud se počet nepožadoval. Pokud existuje, může být počet větší než počet výsledků v této odpovědi. K tomu může dojít, pokud použijete parametry $top nebo $skip nebo pokud dotaz nemůže vrátit všechny požadované dokumenty v jedné odpovědi.
@odata.nextLink	string	Adresa URL pokračování vrácená, když dotaz nemůže vrátit všechny požadované výsledky v jedné odpovědi. Pomocí této adresy URL můžete formulovat jiný požadavek GET nebo POST Search a získat další část odpovědi hledání. Ujistěte se, že používáte stejný příkaz (GET nebo POST) jako požadavek, který tuto odpověď vytvořil.
@search.answers	AnswerResult[]	Výsledky dotazu pro operaci hledání; Null, pokud nebyl zadán parametr dotazu odpovědi nebo nastaven na hodnotu none.
@search.coverage	number	Hodnota označující procento indexu zahrnutého v dotazu nebo hodnotu null, pokud v požadavku nebylo zadáno minimumCoverage.
@search.facets	object	Výsledky fasetového dotazu pro operaci hledání uspořádané jako kolekce kontejnerů pro každé omezující pole; null pokud dotaz neobsahuje žádné omezující vlastnosti výrazy.
@search.nextPageParameters	SearchRequest	Datová část JSON pro pokračování vrácená, když dotaz nemůže vrátit všechny požadované výsledky v jedné odpovědi. Tento JSON můžete použít společně s @odata.nextLink k vytvoření dalšího požadavku POST Search, který získá další část odpovědi hledání.
@search.semanticPartialResponseReason	SemanticErrorReason	Důvod, proč byla vrácena částečná odpověď pro sémantickou žádost o řazení.
@search.semanticPartialResponseType	SemanticSearchResultsType	Typ částečné odpovědi, která byla vrácena pro sémantickou žádost o řazení.
value	SearchResult[]	Posloupnost výsledků vrácených dotazem.

SearchMode

Určuje, jestli se musí některé nebo všechny hledané termíny shodovat, aby se dokument spočítal jako shoda.

Name	Typ	Description
all	string	Aby bylo možné spočítat dokument jako shodu, musí se všechny hledané termíny shodovat.
any	string	Aby bylo možné spočítat dokument jako shodu, musí se shodovat kterýkoli z hledaných termínů.

SearchRequest

Parametry pro filtrování, řazení, fasetování, stránkování a další chování vyhledávacích dotazů

Name	Typ	Description
answers	QueryAnswerType	Hodnota, která určuje, jestli se odpovědi mají vrátit jako součást odpovědi hledání.
captions	QueryCaptionType	Hodnota, která určuje, zda mají být titulky vráceny jako součást odpovědi hledání.
count	boolean	Hodnota, která určuje, zda se má načíst celkový počet výsledků. Výchozí hodnota je false. Nastavení této hodnoty na hodnotu True může mít vliv na výkon. Všimněte si, že vrácený počet představuje aproximaci.
debug	QueryDebugMode	Umožňuje nástroj pro ladění, který se dá použít k dalšímu prozkoumání výsledků v pořadí.
facets	string[]	Seznam výrazů omezujících vlastností, které se mají použít u vyhledávacího dotazu. Každý výraz omezující vlastnosti obsahuje název pole, volitelně následovaný čárkami odděleným seznamem párů name:value.
filter	string	Výraz $filter OData, který se má použít pro vyhledávací dotaz.
highlight	string	Seznam názvů polí oddělených čárkami, které se mají použít pro zvýraznění hitů. Ke zvýraznění hitů se dají použít jenom prohledávatelná pole.
highlightPostTag	string	Značka řetězce, která se připojí k zvýraznění. Je nutné nastavit zvýrazněníPreTag. Výchozí hodnota je </em>.
highlightPreTag	string	Značka řetězce, která je předem zvýrazněná. Musí být nastavena značka highlightPostTag. Výchozí hodnota je <>.
hybridSearch	HybridSearch	Parametry dotazu pro konfiguraci chování hybridního vyhledávání.
minimumCoverage	number	Číslo mezi 0 a 100 označující procento indexu, které musí být pokryto vyhledávacím dotazem, aby se dotaz ohlásil jako úspěšný. Tento parametr může být užitečný pro zajištění dostupnosti vyhledávání i pro služby s jedinou replikou. Výchozí hodnota je 100.
orderby	string	Čárkami oddělený seznam výrazů OData $orderby, podle kterých se mají výsledky seřadit. Každý výraz může být buď název pole, nebo volání funkce geo.distance() nebo search.score(). Za každým výrazem může následovat asc, který označuje vzestupně, nebo desc označují sestupně. Výchozí hodnota je vzestupné pořadí. Vazby budou přerušeny skóre shody dokumentů. Pokud není zadán žádný $orderby, výchozí pořadí řazení je sestupné podle skóre shody dokumentu. Může existovat maximálně 32 $orderby klauzulí.
queryLanguage	QueryLanguage	Hodnota, která určuje jazyk vyhledávacího dotazu.
queryType	QueryType	Hodnota, která určuje syntaxi vyhledávacího dotazu. Výchozí hodnota je "jednoduchá". Pokud dotaz používá syntaxi dotazu Lucene, použijte "full".
scoringParameters	string[]	Seznam hodnot parametrů, které se mají použít v bodovacích funkcích (například referencePointParameter) pomocí hodnot názvu formátu. Pokud například profil bodování definuje funkci s parametrem "mylocation", řetězec parametru by byl "mylocation--122.2,44.8" (bez uvozovek).
scoringProfile	string	Název bodujícího profilu, který má vyhodnotit skóre shody pro odpovídající dokumenty, aby se výsledky seřadily.
scoringStatistics	ScoringStatistics	Hodnota, která určuje, jestli chceme vypočítat statistiku bodování (například četnost dokumentů) globálně pro konzistentnější bodování nebo místně pro nižší latenci. Výchozí hodnota je místní. Před vyhodnocením můžete použít globální agregaci statistik bodování. Použití globálních statistik bodování může zvýšit latenci vyhledávacích dotazů.
search	string	Výraz dotazu fulltextového vyhledávání; Pokud chcete shodovat všechny dokumenty, použijte *nebo tento parametr vynecháte.
searchFields	string	Čárkami oddělený seznam názvů polí, na které chcete nastavit obor fulltextového vyhledávání. Při použití vyhledávacího pole (fieldName:searchExpression) v úplném dotazu Lucene mají názvy polí každého hledaného výrazu přednost před názvy polí uvedených v tomto parametru.
searchMode	SearchMode	Hodnota, která určuje, jestli se musí některé nebo všechny hledané termíny shodovat, aby se dokument spočítal jako shoda.
select	string	Seznam polí oddělených čárkami, která se mají načíst. Pokud není zadáno, jsou zahrnuta všechna pole označená jako načítaná ve schématu.
semanticConfiguration	string	Název sémantické konfigurace, která se použije při zpracování dokumentů pro dotazy sémantického typu.
semanticErrorHandling	SemanticErrorMode	Umožňuje uživateli zvolit, jestli má sémantické volání selhat úplně (výchozí nebo aktuální chování) nebo vrátit částečné výsledky.
semanticFields	string	Čárkami oddělený seznam názvů polí používaných pro sémantické řazení.
semanticMaxWaitInMilliseconds	integer	Umožňuje uživateli nastavit horní mez doby, kterou trvá dokončení zpracování sémantického rozšiřování, než požadavek selže.
semanticQuery	string	Umožňuje nastavit samostatný vyhledávací dotaz, který se bude používat výhradně pro sémantické reranking, sémantické titulky a sémantické odpovědi. Je užitečné ve scénářích, kdy je potřeba používat různé dotazy mezi základní fází načítání a řazení a sémantickou fází L2.
sessionId	string	Hodnota, která se má použít k vytvoření rychlé relace, která může pomoct získat konzistentnější výsledky. Pokud se použije stejné ID relace, provede se pokus o dosažení maximálního úsilí, aby cílil na stejnou sadu replik. Buďte opatrní, že opakované použití stejných hodnot SESSIONID může narušit vyrovnávání zatížení požadavků napříč replikami a nepříznivě ovlivnit výkon vyhledávací služby. Hodnota použitá jako sessionId nemůže začínat znakem _.
skip	integer	Počet výsledků hledání, které chcete přeskočit. Tato hodnota nemůže být větší než 100 000. Pokud potřebujete skenovat dokumenty v posloupnosti, ale kvůli tomuto omezení nemůžete použít přeskočení, zvažte použití orderby u zcela seřazeného klíče a filtrování pomocí dotazu rozsahu.
speller	QuerySpellerType	Hodnota, která určila typ kontroly pravopisu, která se má použít ke kontrole pravopisu jednotlivých hledaných termínů dotazu.
top	integer	Počet výsledků hledání, které se mají načíst. To lze použít ve spojení s $skip k implementaci stránkování výsledků hledání na straně klienta. Pokud se výsledky zkrátí kvůli stránkování na straně serveru, odpověď bude obsahovat pokračovací token, který se dá použít k vydání další žádosti o vyhledávání na další stránce výsledků.
vectorFilterMode	VectorFilterMode	Určuje, zda jsou filtry použity před nebo po provedení vektorového vyhledávání. Výchozí hodnota je preFilter pro nové indexy.
vectorQueries	VectorQuery[]: RawVectorQuery[] VectorizableImageBinaryQuery[] VectorizableImageUrlQuery[] VectorizableTextQuery[]	Parametry dotazu pro vektorové a hybridní vyhledávací dotazy.

SearchResult

Obsahuje dokument nalezený vyhledávacím dotazem a přidruženými metadaty.

Name	Typ	Description
@search.captions	CaptionResult[]	Titulky jsou nejvýraznější pasáže z dokumentu relativně do vyhledávacího dotazu. Často se používají jako souhrn dokumentů. Titulky se vrátí jenom pro dotazy typu sémantické.
@search.documentDebugInfo	DocumentDebugInfo[]	Obsahuje informace o ladění, které lze použít k dalšímu zkoumání výsledků hledání.
@search.highlights	object	Textové fragmenty z dokumentu, které označují odpovídající hledané termíny uspořádané podle každého příslušného pole; Null, pokud pro dotaz nebylo povoleno zvýrazňování hitů.
@search.rerankerScore	number	Skóre relevance vypočítané sémantickým rankerem pro nejlepší výsledky hledání. Výsledky hledání se nejprve seřadí podle rerankerScore a pak podle skóre. Funkce RerankerScore se vrátí pouze pro dotazy typu sémantické.
@search.score	number	Skóre relevance dokumentu ve srovnání s jinými dokumenty vrácenými dotazem.

SearchScoreThreshold

Výsledky vektorového dotazu se budou filtrovat na základě hodnoty @search.score. Všimněte si, že se jedná o @search.score vrácenou jako součást odpovědi hledání. Směr prahové hodnoty bude zvolen pro vyšší @search.score.

Name	Typ	Description
kind	string: searchScore	Druh prahové hodnoty použité k filtrování vektorových dotazů
value	number	Prahová hodnota se vyfiltruje na základě hodnoty @search.score. Všimněte si, že se jedná o @search.score vrácenou jako součást odpovědi hledání. Směr prahové hodnoty bude zvolen pro vyšší @search.score.

SemanticDebugInfo

Name	Typ	Description
contentFields	QueryResultDocumentSemanticField[]	Pole obsahu, která byla odeslána do procesu sémantického rozšiřování, a také způsob jejich použití
keywordFields	QueryResultDocumentSemanticField[]	Pole klíčových slov, která byla odeslána do sémantického procesu rozšiřování, a také způsob jejich použití
rerankerInput	QueryResultDocumentRerankerInput	Nezpracované zřetězené řetězce odeslané do sémantického procesu rozšiřování.
titleField	QueryResultDocumentSemanticField	Pole názvu, které bylo odesláno do sémantického procesu rozšiřování, a také způsob jeho použití

SemanticErrorMode

Umožňuje uživateli zvolit, jestli má sémantické volání selhat úplně (výchozí nebo aktuální chování) nebo vrátit částečné výsledky.

Name	Typ	Description
fail	string	Pokud během kroku sémantického zpracování dojde k výjimce, dotaz selže a vrátí odpovídající kód HTTP v závislosti na chybě.
partial	string	Pokud se sémantické zpracování nezdaří, částečné výsledky se stále vrátí. Definice částečných výsledků závisí na tom, jaký sémantický krok selhal a jaký byl důvod selhání.

SemanticErrorReason

Důvod, proč byla vrácena částečná odpověď pro sémantickou žádost o řazení.

Name	Typ	Description
capacityOverloaded	string	Žádost byla omezena. Vrátily se pouze základní výsledky.
maxWaitExceeded	string	Pokud `semanticMaxWaitInMilliseconds` byla nastavena a doba trvání sémantického zpracování překročila danou hodnotu. Vrátily se pouze základní výsledky.
transient	string	Nejméně jeden krok sémantického procesu se nezdařil.

SemanticFieldState

Způsob použití pole pro sémantický proces rozšiřování (plně používaný, částečně použitý nebo nepoužitý)

Name	Typ	Description
partial	string	Pole bylo částečně použito pro sémantické rozšiřování.
unused	string	Pole nebylo použito pro sémantické rozšiřování.
used	string	Pole bylo plně použito pro sémantické rozšiřování.

SemanticSearchResultsType

Typ částečné odpovědi, která byla vrácena pro sémantickou žádost o řazení.

Name	Typ	Description
baseResults	string	Výsledky bez sémantického rozšiřování nebo přeřazení.
rerankedResults	string	Výsledky byly znovu seřazeny pomocí modelu reranker a budou obsahovat sémantické titulky. Nebudou obsahovat žádné odpovědi, zvýraznění odpovědí ani zvýraznění titulků.

SingleVectorFieldResult

Výsledek jednoho vektorového pole. Vrátí se hodnoty @search.score i vektorové podobnosti. Vektorová podobnost souvisí s @search.score rovnicí.

Name	Typ	Description
searchScore	number	Hodnota @search.score vypočítaná z skóre podobnosti vektoru. Toto je skóre, které je viditelné v čistě jednoúčelovém jednoúčelovém dotazu.
vectorSimilarity	number	Skóre podobnosti vektorů pro tento dokument. Všimněte si, že se jedná o kanonickou definici metriky podobnosti, nikoli verzi "vzdálenosti". Například kosinus podobnost místo kosinusové vzdálenosti.

Speller

Vylepšete úplnost vyhledávání tím, že opravíte jednotlivé hledané termíny.

Name	Typ	Description
lexicon	string	Kontrola pravopisu opraví jednotlivé termíny dotazu pomocí statického lexikonu pro jazyk určený parametrem queryLanguage.
none	string	Kontrola pravopisu není povolená.

TextResult

Skóre BM25 nebo Classic pro text v dotazu.

Name	Typ	Description
searchScore	number	Skóre BM25 nebo Classic pro text v dotazu.

VectorFilterMode

Určuje, zda jsou filtry použity před nebo po provedení vektorového vyhledávání.

Name	Typ	Description
postFilter	string	Filtr se použije po vrácení kandidátské sady výsledků vektoru. V závislosti na selektivitě filtru to může vést k menšímu počtu výsledků, než požaduje parametr "k".
preFilter	string	Filtr se použije před vyhledávacím dotazem.

VectorizableImageBinaryQuery

Parametry dotazu, které se mají použít pro vektorové vyhledávání, když je k dispozici binární soubor s kódováním base 64 obrázku, který je potřeba vektorizovat.

Name	Typ	Description
base64Image	string	Binární soubor s kódováním base 64 obrázku, který má být vektorizován k provedení vektorového vyhledávacího dotazu.
exhaustive	boolean	Pokud je hodnota true, aktivuje vyčerpávající hledání k-nejbližšího souseda napříč všemi vektory v indexu vektoru. Užitečné pro scénáře, ve kterých jsou přesné shody kritické, například určení hodnot základní pravdy.
fields	string	Vektorová pole typu Collection(Edm.Single), která mají být zahrnuta do vektorového vyhledávání.
filterOverride	string	Výraz filtru OData, který se má použít pro tento konkrétní vektorový dotaz. Pokud není na úrovni vektoru definován žádný výraz filtru, použije se místo toho výraz definovaný v parametru filtru nejvyšší úrovně.
k	integer	Početnejbližších
kind	string: imageBinary	Druh vektorového dotazu, který se provádí.
oversampling	number	Faktor převzorkování Minimální hodnota je 1. Přepíše parametr defaultOversampling nakonfigurovaný v definici indexu. Lze ji nastavit pouze v případech, kdy je true rerankWithOriginalVectors. Tento parametr je povolen pouze v případě, že se metoda komprese použije v podkladovém vektorovém poli.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Prahová hodnota použitá pro vektorové dotazy. Všimněte si, že tuto možnost lze nastavit pouze v případě, že všechna pole používají stejnou metriku podobnosti.
weight	number	Relativní váha vektorového dotazu ve srovnání s jinými vektorovými dotazy nebo textovým dotazem ve stejném požadavku hledání. Tato hodnota se používá při kombinování výsledků více seznamů řazení vytvořených různými vektorovými dotazy nebo výsledky načtenými prostřednictvím textového dotazu. Čím vyšší je váha, tím vyšší budou dokumenty, které odpovídají danému dotazu, v konečném pořadí. Výchozí hodnota je 1,0 a hodnota musí být kladné číslo větší než nula.

VectorizableImageUrlQuery

Parametry dotazu, které se mají použít pro vektorové vyhledávání, pokud je k dispozici adresa URL představující hodnotu obrázku, kterou je potřeba vektorizovat.

Name	Typ	Description
exhaustive	boolean	Pokud je hodnota true, aktivuje vyčerpávající hledání k-nejbližšího souseda napříč všemi vektory v indexu vektoru. Užitečné pro scénáře, ve kterých jsou přesné shody kritické, například určení hodnot základní pravdy.
fields	string	Vektorová pole typu Collection(Edm.Single), která mají být zahrnuta do vektorového vyhledávání.
filterOverride	string	Výraz filtru OData, který se má použít pro tento konkrétní vektorový dotaz. Pokud není na úrovni vektoru definován žádný výraz filtru, použije se místo toho výraz definovaný v parametru filtru nejvyšší úrovně.
k	integer	Početnejbližších
kind	string: imageUrl	Druh vektorového dotazu, který se provádí.
oversampling	number	Faktor převzorkování Minimální hodnota je 1. Přepíše parametr defaultOversampling nakonfigurovaný v definici indexu. Lze ji nastavit pouze v případech, kdy je true rerankWithOriginalVectors. Tento parametr je povolen pouze v případě, že se metoda komprese použije v podkladovém vektorovém poli.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Prahová hodnota použitá pro vektorové dotazy. Všimněte si, že tuto možnost lze nastavit pouze v případě, že všechna pole používají stejnou metriku podobnosti.
url	string	Adresa URL obrázku, který se má vektorizovat za účelem provedení vektorového vyhledávacího dotazu.
weight	number	Relativní váha vektorového dotazu ve srovnání s jinými vektorovými dotazy nebo textovým dotazem ve stejném požadavku hledání. Tato hodnota se používá při kombinování výsledků více seznamů řazení vytvořených různými vektorovými dotazy nebo výsledky načtenými prostřednictvím textového dotazu. Čím vyšší je váha, tím vyšší budou dokumenty, které odpovídají danému dotazu, v konečném pořadí. Výchozí hodnota je 1,0 a hodnota musí být kladné číslo větší než nula.

VectorizableTextQuery

Parametry dotazu, které se mají použít pro vektorové vyhledávání, pokud je k dispozici textová hodnota, která musí být vektorizována.

Name	Typ	Description
exhaustive	boolean	Pokud je hodnota true, aktivuje vyčerpávající hledání k-nejbližšího souseda napříč všemi vektory v indexu vektoru. Užitečné pro scénáře, ve kterých jsou přesné shody kritické, například určení hodnot základní pravdy.
fields	string	Vektorová pole typu Collection(Edm.Single), která mají být zahrnuta do vektorového vyhledávání.
filterOverride	string	Výraz filtru OData, který se má použít pro tento konkrétní vektorový dotaz. Pokud není na úrovni vektoru definován žádný výraz filtru, použije se místo toho výraz definovaný v parametru filtru nejvyšší úrovně.
k	integer	Početnejbližších
kind	string: text	Druh vektorového dotazu, který se provádí.
oversampling	number	Faktor převzorkování Minimální hodnota je 1. Přepíše parametr defaultOversampling nakonfigurovaný v definici indexu. Lze ji nastavit pouze v případech, kdy je true rerankWithOriginalVectors. Tento parametr je povolen pouze v případě, že se metoda komprese použije v podkladovém vektorovém poli.
text	string	Text, který má být vektorizován k provedení vektorového vyhledávacího dotazu.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Prahová hodnota použitá pro vektorové dotazy. Všimněte si, že tuto možnost lze nastavit pouze v případě, že všechna pole používají stejnou metriku podobnosti.
weight	number	Relativní váha vektorového dotazu ve srovnání s jinými vektorovými dotazy nebo textovým dotazem ve stejném požadavku hledání. Tato hodnota se používá při kombinování výsledků více seznamů řazení vytvořených různými vektorovými dotazy nebo výsledky načtenými prostřednictvím textového dotazu. Čím vyšší je váha, tím vyšší budou dokumenty, které odpovídají danému dotazu, v konečném pořadí. Výchozí hodnota je 1,0 a hodnota musí být kladné číslo větší než nula.

VectorQueryKind

Druh vektorového dotazu, který se provádí.

Name	Typ	Description
imageBinary	string	Vektorový dotaz, ve kterém je k dispozici binární soubor s kódováním base 64 obrázku, který je potřeba vektorizovat.
imageUrl	string	Vektorový dotaz, kde je k dispozici adresa URL představující hodnotu obrázku, kterou je potřeba vektorizovat.
text	string	Vektorový dotaz, kde je k dispozici textová hodnota, kterou je potřeba vektorizovat.
vector	string	Vektorový dotaz, kde je zadaná nezpracovaná hodnota vektoru.

VectorsDebugInfo

Name	Typ	Description
subscores	QueryResultDocumentSubscores	Rozpis dílčích jader dokumentu před zvolenou metodou fúzní/kombinované sady výsledků, jako je RRF.

VectorSimilarityThreshold

Výsledky vektorového dotazu budou filtrovány na základě metriky podobnosti vektoru. Všimněte si, že se jedná o kanonickou definici metriky podobnosti, nikoli verzi "vzdálenosti". Směr prahové hodnoty (větší nebo menší) se vybere automaticky podle metriky používané polem.

Name	Typ	Description
kind	string: vectorSimilarity	Druh prahové hodnoty použité k filtrování vektorových dotazů
value	number	Prahová hodnota se vyfiltruje na základě hodnoty metriky podobnosti. Všimněte si, že se jedná o kanonickou definici metriky podobnosti, nikoli verzi "vzdálenosti". Směr prahové hodnoty (větší nebo menší) se vybere automaticky podle metriky používané polem.

VectorThresholdKind

Druh vektorového dotazu, který se provádí.

Name	Typ	Description
searchScore	string	Výsledky vektorového dotazu se budou filtrovat na základě hodnoty @search.score. Všimněte si, že se jedná o @search.score vrácenou jako součást odpovědi hledání. Směr prahové hodnoty bude zvolen pro vyšší @search.score.
vectorSimilarity	string	Výsledky vektorového dotazu budou filtrovány na základě metriky podobnosti vektoru. Všimněte si, že se jedná o kanonickou definici metriky podobnosti, nikoli verzi "vzdálenosti". Směr prahové hodnoty (větší nebo menší) se vybere automaticky podle metriky používané polem.

Sdílet prostřednictvím

Documents - Search Get

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Příklady

SearchIndexSearchDocumentsGet

Ukázkový požadavek

Ukázková odpověď

SearchIndexSearchDocumentsSemanticGet

Ukázkový požadavek

Ukázková odpověď

Definice

AnswerResult

CaptionResult

DocumentDebugInfo

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HybridCountAndFacetMode

HybridSearch

QueryAnswerType

QueryCaptionType

QueryDebugMode

QueryLanguage

QueryResultDocumentRerankerInput

QueryResultDocumentSemanticField

QueryResultDocumentSubscores

QuerySpellerType

QueryType

RawVectorQuery

ScoringStatistics

SearchDocumentsResult

SearchMode

SearchRequest

SearchResult

SearchScoreThreshold

SemanticDebugInfo

SemanticErrorMode

SemanticErrorReason

SemanticFieldState

SemanticSearchResultsType

SingleVectorFieldResult

Speller

TextResult

VectorFilterMode

VectorizableImageBinaryQuery

VectorizableImageUrlQuery

VectorizableTextQuery

VectorQueryKind

VectorsDebugInfo

VectorSimilarityThreshold

VectorThresholdKind

Další materiály