Documents - Autocomplete Post

Služba:: Search Service

Verze rozhraní API:: 2025-09-01

Automaticky dokončuje neúplné termíny dotazu na základě vstupního textu a odpovídajících termínů v indexu.

POST {endpoint}/indexes('{indexName}')/docs/search.post.autocomplete?api-version=2025-09-01

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.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-request-id		string (uuid)	ID sledování odeslané s požadavkem na pomoc s laděním.

Text požadavku

Name	Vyžadováno	Typ	Description
search	True	string	Hledaný text, na kterém mají být založeny výsledky automatického dokončování.
suggesterName	True	string	Název modulu pro návrhy, jak je uvedeno v kolekci pro návrhy
autocompleteMode		AutocompleteMode	Určuje režim automatického dokončování. Výchozí hodnota je 'oneTerm'. Použijte 'twoTerms' k získání šindelů a 'oneTermWithContext' k použití aktuálního kontextu při vytváření automaticky doplňovaných termínů.
filter		string	Výraz OData, který filtruje dokumenty použité k vytvoření dokončených výrazů pro výsledek automatického dokončování.
fuzzy		boolean	Hodnota označující, zda se má pro dotaz automatického dokončování použít přibližná shoda. Výchozí hodnota je False. Pokud je nastavena hodnota true, dotaz bude automaticky doplňovat výrazy i v případě, že hledaný text obsahuje nahrazený nebo chybějící znak. I když to v některých scénářích poskytuje lepší prostředí, je to za cenu nákladů na výkon, protože přibližné dotazy automatického dokončování jsou pomalejší a spotřebovávají více prostředků.
highlightPostTag		string	Značka řetězce, která je připojena ke zvýraznění polí. Musí být nastaveno pomocí highlightPreTag. Pokud je tato možnost vynechána, zvýraznění zásahů je zakázáno.
highlightPreTag		string	Značka řetězce, která je předřazena tak, aby dosáhla na světla. Musí být nastaveno pomocí highlightPostTag. Pokud je tato možnost vynechána, zvýraznění zásahů je zakázáno.
minimumCoverage		number (double)	Číslo mezi 0 a 100 označující procento indexu, které musí být pokryto dotazem automatického dokončování, aby byl dotaz hlášen 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 pouze jednou replikou. Výchozí hodnota je 80.
searchFields		string	Čárkami oddělený seznam názvů polí, které je třeba vzít v úvahu při dotazování na automaticky dokončované termíny. Cílová pole musí být zahrnuta v určeném modulu pro návrhy.
top		integer (int32)	Počet automaticky vyplněných termínů, které se mají načíst. Musí to být hodnota mezi 1 a 100. Výchozí hodnota je 5.

Odpovědi

Name	Typ	Description
200 OK	AutocompleteResult	Odpověď obsahující navrhované termíny dotazu, které dokončí částečný vstup.
Other Status Codes	ErrorResponse	Chybová odpověď.

Příklady

SearchIndexAutocompleteDocumentsPost

Ukázkový požadavek

HTTP

POST https://stableexampleservice.search.windows.net/indexes('stable-test')/docs/search.post.autocomplete?api-version=2025-09-01


{
  "search": "p",
  "autocompleteMode": "oneTerm",
  "filter": "ownerId ne '1'",
  "fuzzy": true,
  "highlightPostTag": "</em>",
  "highlightPreTag": "<em>",
  "minimumCoverage": 80,
  "searchFields": "category, ownerId",
  "suggesterName": "sg",
  "top": 10
}

Ukázková odpověď

Stavový kód:: 200

{
  "@search.coverage": 100,
  "value": [
    {
      "text": "purple",
      "queryPlusText": "<em>purple</em>"
    },
    {
      "text": "pink",
      "queryPlusText": "<em>pink</em>"
    }
  ]
}

Definice

Name	Description
AutocompleteItem	Výsledek požadavků automatického dokončování.
AutocompleteMode	Určuje režim automatického dokončování. Výchozí hodnota je 'oneTerm'. Použijte 'twoTerms' k získání šindelů a 'oneTermWithContext' k použití aktuálního kontextu při vytváření termínů automatického dokončování.
AutocompleteRequest	Parametry pro přibližné porovnávání a další chování dotazů automatického dokončování.
AutocompleteResult	Výsledek dotazu automatického dokončování.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď

AutocompleteItem

Objekt

Výsledek požadavků automatického dokončování.

Name	Typ	Description
queryPlusText	string	Dotaz spolu s dokončeným termínem.
text	string	Ukončené období.

AutocompleteMode

Výčet

Určuje režim automatického dokončování. Výchozí hodnota je 'oneTerm'. Použijte 'twoTerms' k získání šindelů a 'oneTermWithContext' k použití aktuálního kontextu při vytváření termínů automatického dokončování.

Hodnota	Description
oneTerm	Navrhuje se pouze jeden termín. Pokud má dotaz dva termíny, dokončí se pouze poslední termín. Pokud je například vstup "washingtonský zdravotník", navrhované termíny mohou zahrnovat "medicaid", "medicare" a "medicína".
twoTerms	Budou navrženy shodné dvoučlenné fráze v indexu. Pokud je například vstup "zdravotník", navrhované termíny mohou zahrnovat "pokrytí zdravotní péče" a "zdravotnický asistent".
oneTermWithContext	Dokončí poslední termín v dotazu dvěma nebo více výrazy, kde poslední dva výrazy jsou fráze, která existuje v indexu. Pokud je například vstup "washington medic", navrhované termíny mohou zahrnovat "washington medicaid" a "washington medical".

AutocompleteRequest

Objekt

Parametry pro přibližné porovnávání a další chování dotazů automatického dokončování.

Name	Typ	Description
autocompleteMode	AutocompleteMode	Určuje režim automatického dokončování. Výchozí hodnota je 'oneTerm'. Použijte 'twoTerms' k získání šindelů a 'oneTermWithContext' k použití aktuálního kontextu při vytváření automaticky doplňovaných termínů.
filter	string	Výraz OData, který filtruje dokumenty použité k vytvoření dokončených výrazů pro výsledek automatického dokončování.
fuzzy	boolean	Hodnota označující, zda se má pro dotaz automatického dokončování použít přibližná shoda. Výchozí hodnota je False. Pokud je nastavena hodnota true, dotaz bude automaticky doplňovat výrazy i v případě, že hledaný text obsahuje nahrazený nebo chybějící znak. I když to v některých scénářích poskytuje lepší prostředí, je to za cenu nákladů na výkon, protože přibližné dotazy automatického dokončování jsou pomalejší a spotřebovávají více prostředků.
highlightPostTag	string	Značka řetězce, která je připojena ke zvýraznění polí. Musí být nastaveno pomocí highlightPreTag. Pokud je tato možnost vynechána, zvýraznění zásahů je zakázáno.
highlightPreTag	string	Značka řetězce, která je předřazena tak, aby dosáhla na světla. Musí být nastaveno pomocí highlightPostTag. Pokud je tato možnost vynechána, zvýraznění zásahů je zakázáno.
minimumCoverage	number (double)	Číslo mezi 0 a 100 označující procento indexu, které musí být pokryto dotazem automatického dokončování, aby byl dotaz hlášen 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 pouze jednou replikou. Výchozí hodnota je 80.
search	string	Hledaný text, na kterém mají být založeny výsledky automatického dokončování.
searchFields	string	Čárkami oddělený seznam názvů polí, které je třeba vzít v úvahu při dotazování na automaticky dokončované termíny. Cílová pole musí být zahrnuta v určeném modulu pro návrhy.
suggesterName	string	Název modulu pro návrhy, jak je uvedeno v kolekci pro návrhy
top	integer (int32)	Počet automaticky vyplněných termínů, které se mají načíst. Musí to být hodnota mezi 1 a 100. Výchozí hodnota je 5.

AutocompleteResult

Objekt

Výsledek dotazu automatického dokončování.

Name	Typ	Description
@search.coverage	number (double)	Hodnota označující procento indexu, které bylo zohledněno požadavkem automatického dokončování, nebo hodnotu null, pokud v požadavku nebylo uvedeno minimumCoverage.
value	AutocompleteItem[]	Seznam vrácených automaticky dokončovaných položek.

ErrorAdditionalInfo

Objekt

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

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

ErrorDetail

Objekt

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

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

Sdílet prostřednictvím

Documents - Autocomplete Post

Parametry identifikátoru URI

Hlavička požadavku

Text požadavku

Odpovědi

Příklady

SearchIndexAutocompleteDocumentsPost

Ukázkový požadavek

Ukázková odpověď

Definice

AutocompleteItem

AutocompleteMode

AutocompleteRequest

AutocompleteResult

ErrorAdditionalInfo

ErrorDetail

ErrorResponse