Configura il completamento automatico avanzato

Sperimentale

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Importante: il completamento automatico avanzato è disponibile per alcuni clienti Google Cloud. Per scoprire di più o registrarti per utilizzare questa funzionalità, contatta il tuo Rappresentante di vendita di Google Cloud.

Questa pagina descrive la funzionalità di completamento automatico avanzato di Vertex AI Search.

Come il completamento automatico di base, il completamento automatico avanzato genera suggerimenti per le query in base ai primi caratteri inseriti per la query.

Prima di leggere questa pagina, familiarizza con il completamento automatico di base di Vertex AI Search. Vedi Configurare il completamento automatico.

Funzionalità principali del completamento automatico avanzato

Le principali caratteristiche del completamento automatico avanzato che lo distinguono dalla versione di base autocomplete sono i seguenti:

• Ricerca combinata: il completamento automatico avanzato può essere utilizzato con la ricerca combinata , si tratta di app di ricerca generiche che collegate a più di un datastore.

• Controllo dell'accesso: il completamento automatico avanzato rispetta i controlli dell'accesso. (Accesso i controlli dell'accesso sono noti anche come ACL, elenchi di controllo dell'accesso.) Avanzata il completamento automatico suggerisce solo le ricerche correlate a documenti a cui l'utente ha accesso. Per informazioni sul controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.

• Miglioramento della lingua: è possibile impostare il completamento automatico avanzato per migliorare i suggerimenti in uno o più lingue diverse. Ad esempio, se la lingua del browser è l'olandese, il completamento automatico i suggerimenti in quella lingua potrebbero essere migliorati. Per saperne di più, consulta Inviare una richiesta di completamento automatico con un miglioramento linguistico.

• Diversi tipi di suggerimenti:con il completamento automatico avanzato, invece, dei normali suggerimenti di query di completamento automatico, puoi specificare che diversi tipi di suggerimenti:

  • Suggerimenti avanzati: come suggerimenti di completamento automatico, gli utenti ricevono informazioni sui documenti in cui il prefisso dei titoli corrisponde alle lettere che digitano. Per ulteriori informazioni, consulta l'articolo Inviare una richiesta di completamento automatico e restituire suggerimenti.

  • Query recenti: come suggerimenti di completamento automatico, gli utenti visualizzano le query recenti che corrispondono al prefisso delle lettere che digitano. Per saperne di più, consulta Inviare una richiesta di completamento automatico e restituire le query recenti.

Invia richieste di completamento automatico

Di seguito viene illustrato come inviare richieste di completamento automatico avanzate utilizzando il metodo completionConfig.completeQuery.

REST

Per inviare una richiesta di completamento automatico utilizzando l'API, segui questi passaggi:

1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

   1. Nella console Google Cloud, vai alla pagina Agent Builder.

      Vai ad App

   2. Nella pagina App, trova il nome della tua app e recupera l'ID dall'app la colonna ID.

2. Chiama il metodo completionConfig.completeQuery.

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING"
       }'
   

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.

   • APP_ID: l'ID dell'app Vertex AI Search.

   • QUERY_STRING: il typeahead inserito per recuperare i suggerimenti.

Invia una richiesta di completamento automatico con un miglioramento della lingua

Puoi potenziare i suggerimenti di completamento automatico bury in base al codice lingua, per Ad esempio, rendi più o meno probabile la visualizzazione dei suggerimenti di completamento automatico in alcune lingue.

Il valore di incremento deve essere compreso tra -1 e 1. Impostazione del numero negativo "sepolti" suggerimenti di completamento automatico in quella lingua e un numero positivo aumenta lingua.

Utilizza tag di due lettere della lingua definiti da BCP 47, ad esempio en, fr, hi, e zh.

REST

Per inviare una richiesta di completamento automatico che include un valore di miglioramento della lingua: segui questi passaggi:

1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

   1. Nella console Google Cloud, vai alla pagina Agent Builder.

      Vai ad App

   2. Nella pagina App, trova il nome della tua app e recupera l'ID dall'app la colonna ID.

2. Chiama il metodo completionConfig.completeQuery.

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING",
         "boostSpec": {
            "conditionBoostSpecs": [{
              "condition": "(langCode: ANY(LANG_CODE))",
              "boost": BOOST_VALUE
            }]
         }
       }'
   
   

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.

   • APP_ID: l'ID dell'app Vertex AI Search.

   • QUERY_STRING: il typeahead inserito per recuperare i suggerimenti.

   • LANG_CODE: il codice di due lettere per una o più lingue tra virgolette. Ad esempio, \"fr\", \"es\" per applicare il valore dell'incremento allo spagnolo e al francese.

   • BOOST_VALUE: un numero a virgola mobile compreso tra -1 e 1. Quando il valore è negativo, i suggerimenti automatici nella lingua vengono retrocessi (lo vengono visualizzate in basso nell'elenco dei suggerimenti). Se il valore corrisponde a positivi, i suggerimenti vengono promossi (vengono visualizzati più in alto nell'elenco).

   Comando di esempio

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
   -H "Content-Type: application/json"
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery"
   -d '{
        "query": { "text": "Co"}
        "boostSpec": {
           "conditionBoostSpecs": [{
             "condition": "(langCode: ANY(\"es\", \"fr\"))",
             "boost": 0.75 }, {
             "condition": "(langCode: ANY(\"en\"))",
             "boost": -1
           }]
         }
       }'
    

   In questo esempio, i suggerimenti di completamento automatico per la query Co sono migliorati (posizionati più in alto nell'elenco dei suggerimenti automatici) se sono in francese o spagnolo e sepolto (posizionato più in basso nell'elenco dei suggerimenti automatici) se sono solo in inglese.

Invia una richiesta di completamento automatico e restituisci suggerimenti avanzati

Il completamento automatico avanzato restituisce contenuti (documenti) in cui i titoli contengono parole che iniziano con la query.

Oltre al titolo del documento, la richiesta di completamento automatico restituisce l'oggetto source_type e entity_type e, se disponibili, le proprietà principali: uri, create_time e update_time. Puoi visualizzare e modificare le mappature delle proprietà principali nella scheda Schema della pagina del data store.

Come per tutti i suggerimenti di completamento automatico avanzato, gli ACL vengono rispettati per qualsiasi documenti suggeriti.

Esempio

Un dipendente esegue una query sul sito intranet della sua azienda per cercare informazioni tecniche sulle autorizzazioni di accesso.

Il dipendente inizia a digitare tec e potrebbero essere restituiti i seguenti documenti: Data technicians handbook, Access technology guide e Techniques for troubleshooting access issues.

Grazie ai suggerimenti avanzati, per ciascuno di questi documenti puoi visualizzare tutte le seguenti informazioni sul documento: titolo (title), un link al documento (uri), data dell'ultimo aggiornamento (update_time) e l'origine (source_type), ad esempio, se il documento è stato trovato in Confluence Cloud o Slack. Sapere come di recente un documento è stato aggiornato e l'origine del documento aiuta e il dipendente scelgono quale documento esaminare per primo.

Limitazioni

Il completamento automatico avanzato si applica solo ai connettori di terze parti e solo ad alcuni i datastore delle entità per i connettori di terze parti. La tabella seguente mostra quali entità sono supportate e per quali connettori.

Connettore di terze parti	Entità supportate
Box	File
Confluence Cloud	Pagina	Spazio
Dropbox	File
Cloud Jira	Problema	Spazio
OneDrive	File
Salesforce	Account	Lead	Opportunità
ServiceNow	Incidente	Conoscenza
SharePoint Online	Allegato	Evento	File	Pagina
Slack	Messaggio

Procedura

Per inviare una richiesta di completamento automatico che restituisce un suggerimento avanzato, segui questi passaggi:

REST

1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

   1. Nella console Google Cloud, vai alla pagina Agent Builder.

      Vai ad App

   2. Nella pagina App, trova il nome della tua app e recupera l'ID dell'app da nella colonna ID.

2. Chiama il metodo completionConfig.completeQuery.

   
   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING",
         "suggestionTypes": ["CONTENT"]
       }'
   
   

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.

   • APP_ID: l'ID dell'app Vertex AI Search.

   • QUERY_STRING: il typeahead inserito per recuperare i suggerimenti.

   Comando e risultato di esempio

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
   -H "Content-Type: application/json"
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery"
   - d {
         "query": "C",
         "suggestionTypes": ["CONTENT"]
       }
   
   {
     "contentSuggestions": [{
       "suggestion": "critical crash in payment module",
       "document": {
         "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/10000",
         "derivedStructData": {
           "title": "Critical Crash in Payment Module",
           "uri": "https://cymballabs.atlassian.net/browse/CPT-1",
           "source_type": "jira",
           "entity_type": "issue"
         }
       },
       "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
     }]
   }
   
   

Nota: se specifichi suggestionTypes come CONTENT, allora qualsiasi valore boostSpec, queryModel oppure Parametri includeTailSuggestions nel tuo curl vengono ignorati.

Invia una richiesta di completamento automatico e restituisce le query recenti

Restituisce come suggerimenti un elenco delle query più recenti dell'utente che corrisponde alla query nella richiesta.

I suggerimenti di query corrispondenti sono elencati dal più recente al meno recente. Per utilizzare ricerca recente, è necessario fornire lo pseudo ID utente.

Esempio

Un dipendente esegue una query sul sito intranet della sua azienda per ottenere informazioni su come prendere le ferie. Il dipendente ha eseguito le seguenti query, elencate dalla dalla più recente alla meno recente:

PTO, Vacation blackout periods, How much vacation time do I have?, Time off, Vacation policy, covering a vacant position during absences e Can I take unpaid time off?.

Ora, in risposta al dipendente che digita vac nella casella di ricerca, suggerimenti di completamento automatico sarebbe il seguente:

• Vacation blackout periods
• How much vacation time do I have?
• Vacation policy
• Covering a vacant position during absences

Procedura

Per inviare una richiesta di completamento automatico che restituisca le query più recenti dell'utente, segui questi passaggi:

REST

1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

   1. Nella console Google Cloud, vai alla pagina Agent Builder.

      Vai ad App

   2. Nella pagina App, trova il nome della tua app e recupera l'ID dell'app da nella colonna ID.

2. Chiama il metodo completionConfig.completeQuery.

   
   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
   -d '{
         "query":"QUERY_STRING",
         "suggestionTypes": ["RECENT_SEARCH"],
         "userPseudoId: "USER_PSEUDO_ID"
       }'
   
   

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.

   • APP_ID: l'ID dell'app Vertex AI Search.

   • QUERY_STRING: l'input di tipoahead utilizzato per recuperare i suggerimenti.

   • USER_PSEUDO_ID: un identificatore dell'utente a cui sono stati assegnati pseudonimi. Tu puoi usare un cookie HTTP per questo campo, che identifica in modo univoco visitatore su un singolo dispositivo. Non impostare questo campo sullo stesso identificatore per più utenti. In questo modo, le cronologie delle query verranno combinate. Azioni sconsigliate includi informazioni che consentono l'identificazione personale (PII) in questo campo.

   Comando e risultato di esempio

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
   -H "Content-Type: application/json"
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery"
   - d '{
         "query": "C",
         "suggestionTypes": ["RECENT_SEARCH"],
         "userPseudoId: "test_user"
       }
   
   {
     "contentSuggestions": [{
       "suggestion": "critical crash in payment module",
       "document": {
         "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/10000",
         "derivedStructData": {
           "title": "Critical Crash in Payment Module",
           "uri": "https://cymballabs.atlassian.net/browse/CPT-1",
           "source_type": "jira",
           "entity_type": "issue"
         }
       },
       "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
     }]
   }
   

Nota: se specifichi suggestionTypes come RECENT_SEARCH, tutti i parametri boostSpec, queryModel o includeTailSuggestions nel comando curl vengono ignorati.

Utilizzare una lista bloccata per il completamento automatico

Puoi utilizzare una lista bloccata per impedire che termini specifici vengano visualizzati come completamento automatico suggerimenti.

Anche se il completamento automatico avanzato è a livello di app, le liste bloccate si trovano a livello di datastore. Questo è importante se la tua app è un'app di ricerca combinata. Crea una lista di rifiuto per ogni datastore collegato all'app.

Per informazioni sulla creazione e sull'utilizzo delle liste bloccate, consulta Utilizzare una funzione di completamento automatico. lista bloccata.