Documents - Autocomplete Post

Szolgáltatás:: Search Service

API-verzió:: 2026-08-01-preview

Automatikusan kiegészíti a hiányos lekérdezési kifejezéseket a bemeneti szöveg és az index egyező kifejezései alapján.

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

URI-paraméterek

Név	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	A keresési szolgáltatás végpontjának URL-címe.
indexName	path	True	string	Az index neve.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Kérelem fejléce

Név	Kötelező	Típus	Description
x-ms-client-request-id		string (uuid)	A kérés átlátszatlan, globálisan egyedi, ügyfél által generált sztringazonosítója.
Accept		Accept	Az Elfogadás fejléce.

Kérelem törzse

Név	Kötelező	Típus	Description
search	True	string	Az a keresési szöveg, amelyre az automatikus kiegészítési eredményeket alapozza.
suggesterName	True	string	A javaslattevő neve az indexdefiníció részét képező javaslattevő-gyűjteményben megadottak szerint.
autocompleteMode		AutocompleteMode	Megadja az automatikus kiegészítés módját. Az alapértelmezett érték a "oneTerm". A "twoTerms" használatával kapja meg a zsindelyeket, a "oneTermWithContext" pedig az aktuális környezetet használja az automatikusan kitöltött kifejezések előállításához.
filter		string	Egy OData-kifejezés, amely szűri az automatikus kiegészítés eredményének befejezett kifejezéseinek előállításához használt dokumentumokat.
fuzzy		boolean	Az azt jelző érték, hogy az automatikus kiegészítési lekérdezéshez fuzzy egyezést kell-e használni. Az alapértelmezett érték false. Ha igaz értékre van állítva, a lekérdezés automatikusan kiegészíti a kifejezéseket, még akkor is, ha a keresési szövegben helyettesített vagy hiányzó karakter található. Bár ez bizonyos esetekben jobb felhasználói élményt nyújt, teljesítményköltséggel jár, mivel az intelligens automatikus kiegészítési lekérdezések lassabbak és több erőforrást fogyasztanak.
highlightPostTag		string	Egy sztringcímke, amely a kiemelések eléréséhez van hozzáfűzve. A highlightPreTag értéket kell megadni. Ha nincs megadva, a találatkiemelés le van tiltva.
highlightPreTag		string	Egy sztringcímke, amely elő van állítva a kiemelések eléréséhez. A highlightPostTag értéket kell beállítani. Ha nincs megadva, a találatkiemelés le van tiltva.
minimumCoverage		number (double)	0 és 100 közötti szám, amely azt jelzi, hogy az indexnek hány százalékát kell lefednie az automatikus kiegészítési lekérdezésnek ahhoz, hogy a lekérdezés sikeres legyen. Ez a paraméter akkor is hasznos lehet, ha csak egy replikával rendelkező szolgáltatások esetében is biztosítja a keresés rendelkezésre állását. Az alapértelmezett érték 80.
searchFields		string	Az automatikusan kitöltött kifejezések lekérdezésekor figyelembe veendő mezőnevek vesszővel tagolt listája. A célmezőket a megadott javaslattevőnek kell tartalmaznia.
top		integer (int32)	A lekérni kívánt automatikusan kitöltött kifejezések száma. Ennek 1 és 100 közötti értéknek kell lennie. Az alapértelmezett érték 5.

Válaszok

Név	Típus	Description
200 OK	AutocompleteResult	A kérés sikeres volt.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

api-key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Hatókörök

Név	Description
https://search.azure.com/.default

Példák

SearchIndexAutocompleteDocumentsPost

Mintakérelem

HTTP

POST https://typespecpreviewexampleservice.search.windows.net/indexes('preview-test')/docs/search.post.autocomplete?api-version=2026-08-01-preview



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

Mintaválasz

Állapotkód:: 200

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

Definíciók

Név	Description
Accept	Az Elfogadás fejléce.
AutocompleteItem	Az automatikus kiegészítési kérések eredménye.
AutocompleteMode	Megadja az automatikus kiegészítés módját. Az alapértelmezett érték a "oneTerm". A "twoTerms" használatával kapja meg a zsindelyeket, a "oneTermWithContext" pedig az aktuális környezetet használja az automatikus kiegészítési kifejezések előállításához.
AutocompleteRequest	A homályos egyezés paraméterei és egyéb automatikus kiegészítési lekérdezési viselkedések.
AutocompleteResult	Az Automatikus kiegészítés lekérdezés eredménye.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

Accept

Felsorolás

Az Elfogadás fejléce.

Érték	Description
application/json;odata.metadata=none

AutocompleteItem

Tárgy

Az automatikus kiegészítési kérések eredménye.

Név	Típus	Description
queryPlusText	string	A lekérdezés és a befejezett kifejezés.
text	string	A befejezett kifejezés.

AutocompleteMode

Felsorolás

Megadja az automatikus kiegészítés módját. Az alapértelmezett érték a "oneTerm". A "twoTerms" használatával kapja meg a zsindelyeket, a "oneTermWithContext" pedig az aktuális környezetet használja az automatikus kiegészítési kifejezések előállításához.

Érték	Description
oneTerm	Csak egy kifejezést javasol. Ha a lekérdezés két kifejezésből áll, csak az utolsó kifejezés fejeződik be. Például, ha a bemenet "washington medic", a javasolt kifejezések közé tartozhat a "medicaid", a "medicare" és a "medicine".
twoTerms	A rendszer kétkifejezéses kifejezések egyeztetését javasolja az indexben. Például, ha a bemenet "orvos", a javasolt kifejezések közé tartozhat a "medicare fedezet" és az "orvosi asszisztens".
oneTermWithContext	A lekérdezés utolsó kifejezését két vagy több kifejezéssel egészíti ki, ahol az utolsó két kifejezés az indexben található kifejezés. Ha például a bemenet "washington medic", a javasolt kifejezések közé tartozhat a "washington medicaid" és a "washington medical".

AutocompleteRequest

Tárgy

A homályos egyezés paraméterei és egyéb automatikus kiegészítési lekérdezési viselkedések.

Név	Típus	Description
autocompleteMode	AutocompleteMode	Megadja az automatikus kiegészítés módját. Az alapértelmezett érték a "oneTerm". A "twoTerms" használatával kapja meg a zsindelyeket, a "oneTermWithContext" pedig az aktuális környezetet használja az automatikusan kitöltött kifejezések előállításához.
filter	string	Egy OData-kifejezés, amely szűri az automatikus kiegészítés eredményének befejezett kifejezéseinek előállításához használt dokumentumokat.
fuzzy	boolean	Az azt jelző érték, hogy az automatikus kiegészítési lekérdezéshez fuzzy egyezést kell-e használni. Az alapértelmezett érték false. Ha igaz értékre van állítva, a lekérdezés automatikusan kiegészíti a kifejezéseket, még akkor is, ha a keresési szövegben helyettesített vagy hiányzó karakter található. Bár ez bizonyos esetekben jobb felhasználói élményt nyújt, teljesítményköltséggel jár, mivel az intelligens automatikus kiegészítési lekérdezések lassabbak és több erőforrást fogyasztanak.
highlightPostTag	string	Egy sztringcímke, amely a kiemelések eléréséhez van hozzáfűzve. A highlightPreTag értéket kell megadni. Ha nincs megadva, a találatkiemelés le van tiltva.
highlightPreTag	string	Egy sztringcímke, amely elő van állítva a kiemelések eléréséhez. A highlightPostTag értéket kell beállítani. Ha nincs megadva, a találatkiemelés le van tiltva.
minimumCoverage	number (double)	0 és 100 közötti szám, amely azt jelzi, hogy az indexnek hány százalékát kell lefednie az automatikus kiegészítési lekérdezésnek ahhoz, hogy a lekérdezés sikeres legyen. Ez a paraméter akkor is hasznos lehet, ha csak egy replikával rendelkező szolgáltatások esetében is biztosítja a keresés rendelkezésre állását. Az alapértelmezett érték 80.
search	string	Az a keresési szöveg, amelyre az automatikus kiegészítési eredményeket alapozza.
searchFields	string	Az automatikusan kitöltött kifejezések lekérdezésekor figyelembe veendő mezőnevek vesszővel tagolt listája. A célmezőket a megadott javaslattevőnek kell tartalmaznia.
suggesterName	string	A javaslattevő neve az indexdefiníció részét képező javaslattevő-gyűjteményben megadottak szerint.
top	integer (int32)	A lekérni kívánt automatikusan kitöltött kifejezések száma. Ennek 1 és 100 közötti értéknek kell lennie. Az alapértelmezett érték 5.

AutocompleteResult

Tárgy

Az Automatikus kiegészítés lekérdezés eredménye.

Név	Típus	Description
@search.coverage	number (double)	Az automatikus kiegészítési kérelem által figyelembe vett index százalékos arányát jelző érték, vagy null, ha a kérelemben nem volt megadva a minimumfeltárás.
value	AutocompleteItem[]	A visszaadott automatikus kiegészítésű elemek listája.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Description
info		A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célpontja.

ErrorResponse

Tárgy

Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

Név	Típus	Description
error	ErrorDetail	A hibaobjektum.