Implementa il completamento automatico

Il completamento automatico di Cloud Search aiuta un utente suggerendogli delle parole mentre digita una query di ricerca. Ad esempio, i suggerimenti possono essere costituiti da parole provenienti da titoli di documenti, operatori di ricerca, valori degli operatori di ricerca o nomi e indirizzi email dell'organizzazione Google Workspace.

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

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

Scenario di esempio

Ad esempio, supponiamo di avere la seguente origine dati contenente 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 si intitola "Avengers Infinity War" con genre=science fiction e characters=Iron Man, Hulk
• Il secondo documento si intitola "Harry Potter" e contiene 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 l'n-gramma risultante utilizzato per il completamento automatico

Dal documento 1 estraiamo n-gram (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". I suggerimenti mostrati all'utente saranno:

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

Supponiamo che l'utente selezioni il suggerimento di completamento automatico "Hermione" e che la successiva pulsazione di tasti sia il carattere "a". I suggerimenti di completamento automatico mostrati all'utente saranno:

• Hermione Adventure
• Azione Hermione
• Hermione Avengers

Il completamento automatico tenta di completare l'ultima parola (o n-gramma) digitata. Nell'esempio precedente, espande semplicemente "a" in "avventura", "azione" e "avengers" poiché non esiste testo che inizi con "hermione a". Questo suggerimento è chiamato suggerimento finale; completa automaticamente solo l'ultima parola/n-gramma in fase di digitazione.

Il completamento automatico di Cloud Search restituisce un massimo di 5 suggerimenti provenienti dai contenuti del documento e 2 suggerimenti di persone.

Importante: la funzionalità di completamento automatico di Ricerca Google suggerisce frasi solo da i documenti a cui un 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 completi automaticamente il nome e i valori delle proprietà corrispondenti.

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

Eseguire l'integrazione con l'API Autocomplete

Se utilizzi l'applicazione di ricerca predefinita o il widget di ricerca embeddabile, la funzionalità di completamento automatico di Cloud Search è supportata in modo nativo senza alcuna operazione aggiuntiva. Ricorda che 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à corrispondente.

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

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

Limitazioni

Il completamento automatico presenta le seguenti limitazioni:

• La limitazione delle frasi di completamento automatico di Ricerca Google tramite il valore FilterOptions definito nello schema non è supportata, ad eccezione dei seguenti filtri integrati: objectype, mimetype e i filtri di tipo.

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

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

• Il completamento automatico degli operatori di ricerca non è disponibile per le proprietà con exact_match_with_operator.

• Il completamento automatico di Cloud Search restituisce un massimo di 5 suggerimenti provenienti dai contenuti del documento e 2 suggerimenti di persone.

• Il completamento automatico di Ricerca Cloud suggerisce frasi solo dai documenti a cui un utente ha accesso.