Implementa il completamento automatico

Il completamento automatico di Cloud Search assiste un utente suggerendo le parole mentre sta digitando una query di ricerca. Ad esempio, i suggerimenti possono essere parole presenti nei titoli dei documenti, negli operatori di ricerca, nei valori degli operatori di ricerca o nei nomi e indirizzi email dell'organizzazione Google Workspace.

Il completamento automatico estrae frasi dai titoli dei documenti indicizzati e, utilizzando un modello n-gram, determina i suggerimenti da fornire utilizzando l'API Suggest. Per impostazione predefinita, le frasi dei titoli dei documenti vengono mostrate nel completamento automatico. Puoi anche contrassegnare le proprietà di testo ed enum come is_suggestable per completare automaticamente il nome e i valori della proprietà corrispondenti.

L'API Suggest esamina la query di ricerca per trovare suggerimenti sulla lingua della query, ad esempio inglese o spagnolo, e assegna la priorità ai risultati di conseguenza. Il campo languageCode di una richiesta viene utilizzato anche per migliorare i suggerimenti specifici per la lingua.

Scenario di esempio

Ad esempio, supponiamo che la seguente origine dati contenga dati sui film:

• L'origine dati contiene due documenti.
• Ogni documento ha un titolo (ItemMetadata.title) e due proprietà: genre e characters.
• Il primo documento è intitolato "Avengers Infinity War" con genre=science fiction e characters=Iron Man, Hulk
• Il secondo documento è intitolato "Harry Potter" con genre=Adventure, Fantasy andcharacters=Hermione, Harry Potter"

La Figura 1 illustra come i suggerimenti di completamento automatico vengono estratti dai titoli, dalle proprietà e dai valori delle proprietà dei documenti.

Figura 1. Due documenti e il n-gram risultante utilizzati per il completamento automatico

Dal documento 1, estraiamo ngrams (fino a trigrammi) "Avengers", "Infinity", "War", "Avengers Infinity", "Infinity War", "Avengers Infinity War". Analogamente dal documento 2, generiamo "Harry", "Potter", "Harry Potter".

Quando esegui una query su questa origine dati, supponiamo che l'utente inizi a digitare "h". Ecco i suggerimenti mostrati all'utente:

• Qual è il colmo per uno specchio?
• Hermione
• Hulk
• Harry Potter

Supponiamo che l'utente selezioni il suggerimento di completamento automatico "Hermione" e che il carattere "a" venga digitato successivamente. I suggerimenti di completamento automatico mostrati all'utente sono:

• Hermione Adventure
• Azione Hermione
• Avengers Hermione

Il completamento automatico tenta di completare l'ultima parola (o ngram) digitata. Nell'esempio precedente, espande semplicemente "a" ad "avventura", "azione" e "avengers" poiché non c'è testo che inizi con "hermione a" insieme. Questo suggerimento è chiamato suggerimento coda, con completamento automatico solo dell'ultima parola/n-grammo digitata.

Il completamento automatico di Cloud Search restituisce un massimo di 5 suggerimenti dai contenuti dei documenti e dai suggerimenti di 2 persone.

Importante: il completamento automatico di Cloud Search suggerisce frasi solo dai documenti a cui l'utente ha accesso.

Per impostazione predefinita, le frasi dei titoli dei documenti vengono mostrate nel completamento automatico. Le proprietà schema devono essere contrassegnate esplicitamente come is_suggestable affinché l'API di suggerimento possa completare automaticamente il nome e i valori della proprietà corrispondenti.

Nota: is_suggestable è supportato solo per le proprietà di testo ed enum.

Eseguire l'integrazione con l'API Autocomplete

Se usi l'applicazione di ricerca predefinita o il widget di ricerca incorporabile, la funzionalità di completamento automatico di Cloud Search è supportata in modo nativo senza alcuna azione aggiuntiva. Ricorda, per impostazione predefinita, le frasi dei titoli dei documenti vengono mostrate nel completamento automatico. Le proprietà dello schema devono essere contrassegnate esplicitamente come is_suggestable affinché l'API di suggerimento completi automaticamente il nome e i valori della proprietà corrispondenti.

Se stai creando un'applicazione di ricerca personalizzata, il completamento automatico è disponibile eseguendo una query sugli endpoint dell'API /query/suggest.

Nota: dopo l'indicizzazione dei documenti, sono necessarie almeno 48 ore prima che vengano visualizzati i risultati del completamento automatico. Inoltre, la reindicizzazione causa un ritardo nell'utilizzo del completamento automatico per quella proprietà.

Limitazioni

Il completamento automatico presenta le seguenti limitazioni:

• La limitazione delle frasi di completamento automatico di Cloud Search utilizzando l'elemento FilterOptions definito nello schema non è supportata, ad eccezione dei seguenti filtri integrati: objectype, mimetype e filtri di tipo.

• I suggerimenti basati sulla cronologia delle query (ricerche eseguite in precedenza dall'utente in un'applicazione di ricerca) non sono supportati

• Puoi contrassegnare come is_suggestable un massimo di 20 proprietà. Questo limite può essere aumentato contattando l'assistenza Cloud Search.

• Il completamento automatico dell'operatore di ricerca non è disponibile per le proprietà con exact_match_with_operator.

• Il completamento automatico di Cloud Search restituisce un massimo di 5 suggerimenti dai contenuti dei documenti e dai suggerimenti di 2 persone.

• La funzionalità di completamento automatico di Cloud Search suggerisce frasi solo dai documenti a cui l'utente ha accesso.