Il completamento automatico di Google Cloud Search aiuta gli utenti suggerendo parole mentre digitano una query di ricerca. Ad esempio, i suggerimenti potrebbero includere parole tratte da titoli di documenti, operatori di ricerca o nomi della tua organizzazione Google Workspace.
Il completamento automatico estrae le frasi dai titoli dei documenti indicizzati e utilizza un modello n-grammi per determinare i suggerimenti utilizzando l'API Suggest. Per impostazione predefinita, il completamento automatico mostra le frasi dei titoli dei documenti. Puoi anche contrassegnare le proprietà dello schema di testo ed enum come is_suggestable per
completare automaticamente i nomi e i valori delle proprietà.
L'API Suggest esamina le query di ricerca per suggerimenti sulla lingua, ad esempio inglese o
spagnolo, e assegna la priorità ai risultati. Il campo
languageCode
in una richiesta migliora anche i suggerimenti specifici per la lingua.
Scenario di esempio
Considera un'origine dati contenente dati sui film:
- L'origine dati contiene due documenti.
- Ogni documento ha un titolo (
ItemMetadata.title) e due proprietà:genreecharacters. - Titolo del documento 1: "Avengers: Infinity War";
genre=science fiction;characters=Iron Man, Hulk. - Titolo del documento 2: "Harry Potter";
genre=Adventure, Fantasy;characters=Hermione, Harry Potter.
La Figura 1 mostra come il completamento automatico estrae i suggerimenti.
Dal documento 1, il modello estrae n-grammi (fino a trigrammi) come "Avengers", "Infinity", "War", "Avengers Infinity", "Infinity War" e "Avengers Infinity War". Dal documento 2, genera "Harry", "Potter" e "Harry Potter".
Se un utente digita "h" quando esegue una query su questa origine dati, potrebbe visualizzare i seguenti suggerimenti:
- Qual è il colmo per uno specchio?
- Hermione
- Hulk
- Harry Potter
Se l'utente seleziona "Hermione" e poi digita "a", il completamento automatico potrebbe mostrare:
- Hermione Adventure
- Azione di Hermione
- Hermione Avengers
Il completamento automatico tenta di completare l'ultima parola o l'ultimo n-gramma digitato. In questo esempio, "a" viene espanso in "adventure", "action" e "avengers" perché nessun testo indicizzato inizia con "hermione a.". Questo è un suggerimento di coda.
Il completamento automatico di Cloud Search restituisce un massimo di cinque suggerimenti dai contenuti dei documenti e due suggerimenti di persone.
Per impostazione predefinita, il completamento automatico mostra le frasi dei titoli dei documenti. Devi
contrassegnare esplicitamente le proprietà dello schema come is_suggestable affinché l'API Suggest
completi automaticamente i nomi e i valori delle proprietà.
Integrare l'API Suggest
Se utilizzi l'applicazione di ricerca predefinita o il widget di ricerca incorporabile,
Cloud Search supporta in modo nativo il completamento automatico. Ricorda di contrassegnare
le proprietà dello schema come is_suggestable se vuoi che vengano completate automaticamente.
Se stai creando un'applicazione di ricerca personalizzata, il completamento automatico
è disponibile utilizzando gli endpoint dell'API /query/suggest.
Limitazioni
Il completamento automatico presenta le seguenti limitazioni:
- La limitazione delle frasi di completamento automatico tramite
FilterOptionsnon è supportata, ad eccezione dei filtri integrati comeobjecttypeemimetype. - I suggerimenti basati sulla cronologia delle query di un utente non sono supportati.
- Puoi contrassegnare un massimo di 20 proprietà come
is_suggestable. Contatta l'assistenza di Cloud Search per aumentare questo limite. - Il completamento automatico degli operatori di ricerca non è disponibile per le proprietà con
exact_match_with_operator. - Il completamento automatico restituisce un massimo di cinque suggerimenti per i contenuti dei documenti e due suggerimenti per le persone.
- Il completamento automatico suggerisce solo frasi tratte da documenti a cui l'utente può accedere.