Configurare il completamento automatico avanzato

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

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

Prima di leggere questa pagina, acquisisci familiarità con il completamento automatico di base di Agent Search. Consulta Configura il completamento automatico.

Funzionalità chiave del completamento automatico avanzato

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

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

  • Controllo dell'accesso: il completamento automatico avanzato rispetta i controlli dell'accesso. I controlli dell'accesso sono anche chiamati ACL, elenchi di controllo dell'accesso. Il completamento automatico avanzato suggerisce solo le query di ricerca correlate ai documenti a cui il ricercatore ha accesso. Per informazioni sul controllo dell'accesso, consulta Utilizza il controllo dell'accesso all'origine dati.

Prima di iniziare

Prima di iniziare a utilizzare il completamento automatico avanzato:

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

  • Per i datastore più piccoli, imposta Attiva completamento automatico su Ora. Ti consigliamo di farlo 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 di query della cronologia delle ricerche o degli eventi utente, consulta Proteggere dalle perdite di PII e configura le misure di protezione dalla perdita di dati (DLP) che potrebbero essere necessarie per impedire la perdita di PII.

Inviare richieste di completamento automatico

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

REST

Per inviare una richiesta di completamento automatico utilizzando l'API:

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

    1. Nella Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

    2. Nella pagina App, trova il nome dell'app e recupera il relativo ID dalla colonna ID.

  2. Chiama il completionConfig.completeQuery metodo.

    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 del tuo Google Cloud progetto.

    • APP_ID: l'ID dell'app Agent Search.

    • QUERY_STRING: l'input di tipo "digita in anticipo" utilizzato per recuperare i suggerimenti.

Inviare una richiesta di completamento automatico con un potenziamento della lingua

Puoi potenziare o nascondere i suggerimenti di completamento automatico in base al codice della lingua, ad esempio rendendo più o meno probabile la visualizzazione dei suggerimenti di completamento automatico in alcune lingue.

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

Utilizza i 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 potenziamento della lingua:

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

    1. Nella Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

    2. Nella pagina App, trova il nome dell'app e recupera il relativo ID dalla colonna ID.

  2. Chiama il completionConfig.completeQuery metodo.

    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 del tuo Google Cloud progetto.

    • APP_ID: l'ID dell'app Agent Search.

    • QUERY_STRING: l'input di tipo "digita in anticipo" 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 potenziamento allo spagnolo e al 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 (appaiono più in alto nell'elenco).

Inviare una richiesta di completamento automatico e restituire le query recenti

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

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

Esempio

Un dipendente sta eseguendo una query sul sito intranet della sua azienda per ottenere informazioni sulle 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 restituisca le query più recenti dell'utente:

REST

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

    1. Nella Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

    2. Nella pagina App, trova il nome dell'app e recupera il relativo ID dalla colonna ID.

  2. Chiama il completionConfig.completeQuery metodo.

    
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 del tuo Google Cloud progetto.

    • APP_ID: l'ID dell'app Agent Search.

    • QUERY_STRING: l'input di tipo "digita in anticipo" 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 loro 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 bloccate sono a livello di datastore. Questo è importante se la tua app è un'app di ricerca combinata. Crea una lista bloccata 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 i suggerimenti di completamento automatico generati da un modello dei dati di completamento automatico.

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