Documents - Autocomplete Get

Riferimento

Servizio:: Search Service

Versione API:: 2023-10-01-Preview

Completamento automatico dei termini di query incompleti in base al testo di input e ai termini corrispondenti nell'indice.

GET {endpoint}/indexes('{indexName}')/docs/search.autocomplete?api-version=2023-10-01-Preview&search={search}&suggesterName={suggesterName}

Con parametri facoltativi:

GET {endpoint}/indexes('{indexName}')/docs/search.autocomplete?api-version=2023-10-01-Preview&search={search}&suggesterName={suggesterName}&autocompleteMode={autocompleteMode}&$filter={$filter}&fuzzy={fuzzy}&highlightPostTag={highlightPostTag}&highlightPreTag={highlightPreTag}&minimumCoverage={minimumCoverage}&searchFields={searchFields}&$top={$top}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string	URL dell'endpoint del servizio di ricerca.
indexName	path	True	string	Nome dell'indice.
api-version	query	True	string	Versione dell'API client.
search	query	True	string	Termine incompleto che deve essere completato automaticamente.
suggesterName	query	True	string	Nome del suggeritore come specificato nell'insieme di suggeritori che fa parte della definizione dell'indice.
$filter	query		string	Espressione OData che filtra i documenti usati per produrre termini completati per il risultato completamento automatico.
$top	query		integer int32	Numero di termini completati automaticamente da recuperare. Deve essere un valore compreso tra 1 e 100. Il valore predefinito è 5.
autocompleteMode	query		AutocompleteMode	Specifica la modalità di completamento automatico. Il valore predefinito è "oneTerm". Usare "twoTerms" per ottenere shingles e "oneTermWithContext" per usare il contesto corrente durante la produzione di termini completati automaticamente.
fuzzy	query		boolean	Valore che indica se usare la corrispondenza fuzzy per la query di completamento automatico. L'impostazione predefinita è false. Se impostato su true, la query troverà termini anche se nel testo di ricerca è presente un carattere sostituito o mancante. Anche se questo offre un'esperienza migliore in alcuni scenari, si tratta di un costo di prestazioni come query di completamento automatico fuzzy sono più lente e utilizzano più risorse.
highlightPostTag	query		string	Tag stringa accodato alle evidenziazioni di hit. Deve essere impostato con highlightPreTag. Se omesso, l'evidenziazione dei colpi è disabilitata.
highlightPreTag	query		string	Tag stringa prependato per l'evidenziazione. Deve essere impostato con highlightPostTag. Se omesso, l'evidenziazione dei colpi è disabilitata.
minimumCoverage	query		number double	Numero compreso tra 0 e 100 che indica la percentuale dell'indice che deve essere coperta da una query di completamento automatico affinché la query venga segnalata come esito positivo. Questo parametro può essere utile per garantire la disponibilità di ricerca anche per i servizi con una sola replica. Il valore predefinito è 80.
searchFields	query		string[]	Elenco di nomi di campi da considerare quando si esegue una query per i termini completati automaticamente. I campi di destinazione devono essere inclusi nel suggerimento specificato.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-client-request-id		string uuid	ID di rilevamento inviato con la richiesta di assistenza per il debug.

Risposte

Nome	Tipo	Descrizione
200 OK	AutocompleteResult	Risposta contenente termini di query suggeriti che completano l'input parziale.
Other Status Codes	SearchError	Risposta di errore.

Esempio

SearchIndexAutocompleteDocumentsGet

Esempio di richiesta

HTTP

GET https://myservice.search.windows.net/indexes('myindex')/docs/search.autocomplete?api-version=2023-10-01-Preview&search=washington medic&suggesterName=sg&autocompleteMode=oneTerm&fuzzy=False&highlightPostTag=</em>&highlightPreTag=<em>&minimumCoverage=80&searchFields=title,description

Risposta di esempio

Codice di stato:: 200

[
  {
    "text": "medicaid",
    "queryPlusText": "washington medicaid"
  },
  {
    "text": "medicare",
    "queryPlusText": "washington medicare"
  },
  {
    "text": "medicine",
    "queryPlusText": "washington medicine"
  }
]

Definizioni

Nome	Descrizione
AutocompleteItem	Risultato delle richieste di completamento automatico.
AutocompleteMode	Specifica la modalità di completamento automatico. Il valore predefinito è "oneTerm". Usare "twoTerms" per ottenere shingles e "oneTermWithContext" per usare il contesto corrente nella produzione di termini di completamento automatico.
AutocompleteResult	Risultato della query di completamento automatico.
SearchError	Descrive una condizione di errore per l'API.

AutocompleteItem

Risultato delle richieste di completamento automatico.

Nome	Tipo	Descrizione
queryPlusText	string	Query insieme al termine.
text	string	Termine completato.

AutocompleteMode

Specifica la modalità di completamento automatico. Il valore predefinito è "oneTerm". Usare "twoTerms" per ottenere shingles e "oneTermWithContext" per usare il contesto corrente nella produzione di termini di completamento automatico.

Nome	Tipo	Descrizione
oneTerm	string	Viene suggerito un solo termine. Se la query ha due termini, viene completato solo l'ultimo termine. Ad esempio, se l'input è "washington medic", i termini suggeriti potrebbero includere "medicaid", "medicare" e "medicina".
oneTermWithContext	string	Completa l'ultimo termine in una query con due o più termini, in cui gli ultimi due termini sono una frase presente nell'indice. Ad esempio, se l'input è "washington medic", i termini suggeriti potrebbero includere "washington medicaid" e "washington medical".
twoTerms	string	Verrà suggerita la corrispondenza di frasi a due termini nell'indice. Ad esempio, se l'input è "medico", i termini suggeriti potrebbero includere "copertura medicare" e "assistente medica".

AutocompleteResult

Risultato della query di completamento automatico.

Nome	Tipo	Descrizione
@search.coverage	number	Valore che indica la percentuale dell'indice considerato dalla richiesta di completamento automatico o null se minimumCoverage non è stato specificato nella richiesta.
value	AutocompleteItem[]	Elenco di elementi compilati automaticamente.

SearchError

Descrive una condizione di errore per l'API.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	SearchError[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
message	string	Rappresentazione leggibile dell'errore.

Condividi tramite