Documents - Autocomplete Post

  • Reference
Služba:
Search Service
Verze rozhraní API:
2024-07-01

Automatické dokončování neúplných termínů dotazů 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=2024-07-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, které vám pomůže s laděním.

Text požadavku

Name Vyžadováno Typ Description
search True

string

Hledaný text, na kterém se mají založit výsledky automatického dokončování.
suggesterName True

string

Název navrhujícího, jak je uvedeno v kolekci pro návrhy, která je součástí definice indexu.
autocompleteMode

AutocompleteMode

Určuje režim automatického dokončování. Výchozí hodnota je oneTerm. Pomocí příkazu twoTerms můžete získat shingles a oneTermWithContext k použití aktuálního kontextu při vytváření termínů automatického dokončování.
filter

string

Výraz OData, který filtruje dokumenty použité k vytvoření dokončených termínů pro výsledek automatického dokončování.
fuzzy

boolean

Hodnota označující, jestli se má použít přibližná shoda pro dotaz automatického dokončování. Výchozí hodnota je false. Pokud je nastavená hodnota true, dotaz automaticky dokončuje termíny, i když je ve hledaném textu nahrazený nebo chybějící znak. I když to poskytuje lepší prostředí v některých scénářích, přináší to náklady na výkon, protože dotazy s přibližným automatickým dokončováním jsou pomalejší a spotřebovávají více prostředků.
highlightPostTag

string

Značka řetězce, která se připojí k zvýraznění. Je nutné nastavit zvýrazněníPreTag. Pokud tuto možnost vynecháte, zvýraznění stisknutím klávesy je zakázáno.
highlightPreTag

string

Značka řetězce, která je předem zvýrazněná. Musí být nastavena značka highlightPostTag. Pokud tuto možnost vynecháte, zvýraznění stisknutím klávesy je zakázáno.
minimumCoverage

number

Číslo mezi 0 a 100 označující procento indexu, které musí být pokryto dotazem automatického dokončování, 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 80.
searchFields

string

Seznam názvů polí oddělených čárkami, které je potřeba vzít v úvahu při dotazování na automaticky dokončené termíny. Cílová pole musí být zahrnuta v zadaném sugestivním nástroji.
top

integer

Počet automaticky dokončený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

POST https://myservice.search.windows.net/indexes('myindex')/docs/search.post.autocomplete?api-version=2024-07-01

{
  "autocompleteMode": "oneTerm",
  "search": "washington medic",
  "suggesterName": "sg",
  "filter": "search.in(docId,'101,102,105')",
  "highlightPostTag": "</em>",
  "highlightPreTag": "<em>",
  "minimumCoverage": 80,
  "searchFields": "title,description",
  "top": 10
}

Ukázková odpověď

Stavový kód:
200 
[
  {
    "text": "medicaid",
    "queryPlusText": "washington medicaid"
  },
  {
    "text": "medicare",
    "queryPlusText": "washington medicare"
  },
  {
    "text": "medicine",
    "queryPlusText": "washington medicine"
  }
]

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. Pomocí příkazu twoTerms získáte shingles a oneTermWithContext k použití aktuálního kontextu při vytváření termínů automatického dokončování.
AutocompleteRequest

Parametry pro porovnávání přibližných shod 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

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

Name Typ Description
queryPlusText

string

Dotaz spolu s dokončeným termínem.
text

string

Dokončený termín.

AutocompleteMode

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

Name Typ Description
oneTerm

string

Navrhuje se jenom jeden termín. Pokud má dotaz dva termíny, dokončí se jenom poslední termín. Pokud je například vstup "washington medic", navrhované termíny mohou zahrnovat "medicaid", "medicare" a "medicine".
oneTermWithContext

string

Dokončí poslední termín v dotazu dvěma nebo více termíny, kde poslední dva termíny jsou fráze, která existuje v indexu. Pokud je například vstup "washington medic", navrhované termíny mohou zahrnovat "washington medicaid" a "washington medical".
twoTerms

string

Navrhne se porovnávání dvou termínů v indexu. Pokud je například vstup "medik", navrhované termíny mohou zahrnovat "medicare coverage" a "medical assistant".

AutocompleteRequest

Parametry pro porovnávání přibližných shod 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. Pomocí příkazu twoTerms můžete získat shingles a oneTermWithContext k použití aktuálního kontextu při vytváření termínů automatického dokončování.
filter

string

Výraz OData, který filtruje dokumenty použité k vytvoření dokončených termínů pro výsledek automatického dokončování.
fuzzy

boolean

Hodnota označující, jestli se má použít přibližná shoda pro dotaz automatického dokončování. Výchozí hodnota je false. Pokud je nastavená hodnota true, dotaz automaticky dokončuje termíny, i když je ve hledaném textu nahrazený nebo chybějící znak. I když to poskytuje lepší prostředí v některých scénářích, přináší to náklady na výkon, protože dotazy s přibližným automatickým dokončováním jsou pomalejší a spotřebovávají více prostředků.
highlightPostTag

string

Značka řetězce, která se připojí k zvýraznění. Je nutné nastavit zvýrazněníPreTag. Pokud tuto možnost vynecháte, zvýraznění stisknutím klávesy je zakázáno.
highlightPreTag

string

Značka řetězce, která je předem zvýrazněná. Musí být nastavena značka highlightPostTag. Pokud tuto možnost vynecháte, zvýraznění stisknutím klávesy je zakázáno.
minimumCoverage

number

Číslo mezi 0 a 100 označující procento indexu, které musí být pokryto dotazem automatického dokončování, 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 80.
search

string

Hledaný text, na kterém se mají založit výsledky automatického dokončování.
searchFields

string

Seznam názvů polí oddělených čárkami, které je potřeba vzít v úvahu při dotazování na automaticky dokončené termíny. Cílová pole musí být zahrnuta v zadaném sugestivním nástroji.
suggesterName

string

Název navrhujícího, jak je uvedeno v kolekci pro návrhy, která je součástí definice indexu.
top

integer

Počet automaticky dokončených termínů, které se mají načíst. Musí to být hodnota mezi 1 a 100. Výchozí hodnota je 5.

AutocompleteResult

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

Name Typ Description
@search.coverage

number

Hodnota označující procento indexu, který byl považován za požadavek automatického dokončování, nebo null, pokud v požadavku nebylo zadáno minimumCoverage.
value

AutocompleteItem[]

Seznam vrácených položek automatického dokončová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.