Configurare il completamento automatico avanzato

Questa pagina descrive la funzionalità di completamento automatico avanzato di Gemini Enterprise.

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, acquisisci familiarità con il completamento automatico di base di Gemini Enterprise. Vedi Configurare il completamento automatico.

Funzionalità chiave del completamento automatico avanzato

Le funzionalità chiave del completamento automatico avanzato che lo distinguono da quello di base sono le seguenti:

  • Ricerca combinata:il completamento automatico avanzato può essere utilizzato con le app collegate a più di un datastore.

  • Controllo dell'accesso:il completamento automatico avanzato rispetta i controlli dell'accesso. (I controlli di accesso sono anche chiamati ACL, elenchicontrollo dell'accessoo.) Il completamento automatico avanzato suggerisce solo query di ricerca correlate a documenti a cui l'utente che esegue la ricerca ha accesso. Per informazioni sul controllo dell'accesso, vedi Identità e autorizzazioni.

  • Potenziamento della lingua:il completamento automatico avanzato può essere impostato per potenziare i suggerimenti in una o più lingue. Ad esempio, se la lingua del browser è l'olandese, i suggerimenti di completamento automatico in questa lingua potrebbero essere migliorati. Per ulteriori informazioni, vedi Inviare una richiesta di completamento automatico con un boost della lingua.

Prima di iniziare

Prima di iniziare a utilizzare il completamento automatico avanzato, segui questi passaggi:

  • Rivedi e, se vuoi, modifica le impostazioni di completamento automatico per la tua app. Vedi Aggiornare le impostazioni di completamento automatico.

  • Per i datastore più piccoli, imposta Attiva completamento automatico su Ora. Ti consigliamo questa opzione perché i datastore di piccole dimensioni potrebbero non contenere dati sufficienti per fornire suggerimenti accurati.

  • Se i tuoi datastore contengono informazioni che consentono l'identificazione personale (PII) o se utilizzi il modello di suggerimenti per le query della cronologia delle ricerche o degli eventi utente, consulta Protezione dalle fughe di PII e configura le misure di protezione per la prevenzione della perdita di dati (DLP) che potrebbero essere necessarie per evitare fughe di PII.

Inviare richieste di completamento automatico

Di seguito viene mostrato come inviare richieste di completamento automatico avanzato 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 Gemini Enterprise.

      Vai ad App

    2. Nella pagina App, trova il nome della tua app e recupera il relativo ID dalla 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/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING"
    }'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto.

    • APP_ID: l'ID dell'app.

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

Inviare una richiesta di completamento automatico con un boost della lingua

Puoi aumentare o diminuire la priorità dei suggerimenti di completamento automatico in base al codice lingua, ad esempio, puoi fare in modo che i suggerimenti di completamento automatico in alcune lingue abbiano maggiori o minori probabilità di essere visualizzati.

Il valore boost deve essere compreso tra -1 e 1. L'impostazione di un numero negativo "seppellisce" i suggerimenti di completamento automatico in quella lingua, mentre un numero positivo la promuove.

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

REST

Per inviare una richiesta di completamento automatico che includa un valore di incremento 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 Gemini Enterprise.

      Vai ad App

    2. Nella pagina App, trova il nome della tua app e recupera il relativo ID dalla 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/v1/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
         }]
      }
    }'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto.

    • APP_ID: l'ID dell'app.

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

    • LANG_CODE: il codice di due lettere per una o più lingue, tra virgolette con caratteri di escape. Ad esempio, \"fr\", \"es\" per applicare il valore di incremento a spagnolo e francese.

    • BOOST_VALUE: un numero con rappresentazione in virgola mobile compreso tra -1 e 1. Quando il valore è negativo, i suggerimenti automatici nella lingua vengono declassati (appaiono più in basso nell'elenco dei suggerimenti). Quando il valore è positivo, i suggerimenti vengono promossi (vengono visualizzati più in alto nell'elenco).

Invia una richiesta di completamento automatico e restituisci suggerimenti avanzati

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

Oltre al titolo del documento, la richiesta di completamento automatico restituisce source_type e entity_type e, se disponibili, le proprietà chiave: uri, create_time e update_time. Puoi visualizzare e modificare i mapping delle proprietà chiave nella scheda Schema della pagina del datastore.

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

Esempio

Un dipendente sta interrogando il sito intranet della sua azienda alla ricerca di 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.

Con i suggerimenti avanzati, per ciascuno di questi documenti suggeriti puoi visualizzare le seguenti informazioni:

  • il titolo del documento (title), un link al documento (uri)

  • data dell'ultimo aggiornamento (update_time)

  • l'origine (source_type), ad esempio se il documento è stato trovato in Confluence Cloud o Slack.

Sapere quando è stato aggiornato un documento e la sua origine aiuta il dipendente a scegliere quale documento consultare per primo.

Limitazioni

Il completamento automatico avanzato si applica solo ai connettori di terze parti e solo a determinati datastore di entità per questi connettori di terze parti. La tabella seguente mostra quali entità sono supportate per quali connettori.

Connettore di terze parti Entità supportate
Box File
Confluence Cloud Pagina Spazio
Dropbox File
Jira Cloud 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:

REST

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

    1. Nella console Google Cloud , vai alla pagina Gemini Enterprise.

      Vai ad App

    2. Nella pagina App, trova il nome della tua app e recupera il relativo ID dalla 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/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "suggestionTypes": ["CONTENT"]
    }'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto.

    • APP_ID: l'ID dell'app.

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

Invia una richiesta di completamento automatico e restituisci le query recenti

Restituisci, come suggerimenti, un elenco delle query più recenti dell'utente che corrispondono al prefisso della query nella richiesta.

I suggerimenti per le query corrispondenti sono elencati dalla più recente alla meno recente. Per utilizzare la ricerca recente, è necessario fornire lo pseudo ID utente.

Esempio

Un dipendente sta interrogando il sito intranet della sua azienda per ottenere informazioni su come prendere le ferie. Il dipendente ha eseguito le seguenti query, elencate 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, i suggerimenti di completamento automatico sarebbero i seguenti:

  • 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 restituisce 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 Gemini Enterprise.

      Vai ad App

    2. Nella pagina App, trova il nome della tua app e recupera il relativo ID dalla 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/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "suggestionTypes": ["RECENT_SEARCH"],
      "userPseudoId": "USER_PSEUDO_ID"
    }'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto.

    • APP_ID: l'ID dell'app.

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

    • USER_PSEUDO_ID: un identificatore pseudonimizzato dell'utente. Puoi utilizzare un cookie HTTP per questo campo, che identifica in modo univoco un visitatore su un singolo dispositivo. Non impostare questo campo sullo stesso identificatore per più utenti. In questo modo, le cronologie delle query verranno combinate. Non includere informazioni che consentono l'identificazione personale (PII) in questo campo.

Utilizzare una lista bloccata a completamento automatico

Puoi usare una lista bloccata per evitare che termini specifici appaiano come suggerimenti di completamento automatico.

Sebbene il completamento automatico avanzato sia a livello di app, le liste di blocco sono a livello di datastore. Questo è importante se la tua app è un'app di ricerca combinata. Crea una denylist per ogni datastore collegato all'app.

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

Utilizzare un elenco importato di suggerimenti di completamento automatico

Puoi scegliere di fornire il tuo elenco di suggerimenti di completamento automatico anziché utilizzare quelli generati da unmodello dei datii di completamento automatico.

Per informazioni su come importare un elenco, consulta Utilizzare un elenco importato di suggerimenti di completamento automatico.