Questa pagina è stata tradotta dall'API Cloud Translation.

Configurare il completamento automatico avanzato

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. Consulta Configurare il completamento automatico.

Funzionalità principali 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 generiche collegate a più di un datastore.
Controllo dell'accesso:il completamento automatico avanzato rispetta i controlli dell'accesso. I controlli di accesso sono noti anche come ACL, elenchi di controllo dell'accesso. Il completamento automatico avanzato suggerisce solo ricerche correlate ai documenti a cui l'utente che effettua la ricerca ha accesso. Per informazioni sul controllo dell'accesso, consulta Utilizzare il controllo dell'accesso alle origini dati.
Miglioramento della lingua:il completamento automatico avanzato può essere impostato per migliorare i suggerimenti in una o più lingue. Ad esempio, se la lingua del browser è l'olandese, i suggerimenti di completamento automatico 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 di utilizzare i normali suggerimenti di query per il completamento automatico, puoi specificare che vuoi 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 saperne di più, consulta Inviare una richiesta di completamento automatico e restituire suggerimenti avanzati.
- Query recenti: come suggerimenti di completamento automatico, gli utenti ricevono 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.

Prima di iniziare

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

In particolare durante i test, per gli archivi di dati più piccoli, consigliamo di impostare Attiva il completamento automatico su Ora. Questo accade perché i piccoli datastore potrebbero non contenere dati sufficienti per fornire suggerimenti accurati.

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:

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.

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: l'input di tipoahead utilizzato per recuperare i suggerimenti.

Inviare una richiesta di completamento automatico con un miglioramento della lingua

Puoi aumentare o diminuire la probabilità di visualizzazione dei suggerimenti di completamento automatico in base al codice lingua, ad esempio, puoi aumentare o diminuire la probabilità di visualizzazione dei suggerimenti di completamento automatico in alcune lingue.

Il valore di boost 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 ne favorisce la utilizzazione.

Utilizza i tag 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:

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.

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: l'input di tipoahead utilizzato per recuperare i suggerimenti.
LANG_CODE: il codice di due lettere per una o più lingue, tra virgolette eseguibili. 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 (vengono visualizzati più in basso nell'elenco dei suggerimenti). Quando il valore è positivo, 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 messi in evidenza (posizionati più in alto nell'elenco dei suggerimenti automatici) se sono in francese o spagnolo e nascosti (posizionati più in basso nell'elenco dei suggerimenti automatici) se sono in inglese.

Invia una richiesta di completamento automatico e restituisci suggerimenti avanzati

Il completamento automatico avanzato restituisce i 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 le mappature delle proprietà principali nella scheda Schema della pagina del datastore.

Come per tutti i suggerimenti di completamento automatico avanzati, le ACL vengono rispettate per tutti i 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.

Con i suggerimenti avanzati, per ciascuno di questi documenti suggeriti puoi visualizzare tutte le seguenti informazioni: il titolo del documento (title), un link al documento (uri), la data dell'ultimo aggiornamento (update_time) e la sorgente (source_type), ad esempio se il documento è stato trovato in Confluence Cloud o Slack. Sapere quanto di recente è stato aggiornato un documento e la relativa fonte aiuta il dipendente a scegliere quale documento esaminare per primo.

Limitazioni

Il completamento automatico avanzato si applica solo ai connettori di terze parti e solo a determinati magazzini di dati delle entità per questi connettori di terze parti. La tabella seguente mostra le entità supportate per ciascun connettore.

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 restituisca un suggerimento avanzato:

REST

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.

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: l'input di tipoahead utilizzato 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"
  }]
}

Invia una richiesta di completamento automatico e restituisce le query recenti

Restituisce come suggerimenti un elenco delle query più recenti dell'utente che hanno una corrispondenza del prefisso con la 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 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 dal più recente al 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 alla digitazione di vac da parte del dipendente nella casella di ricerca, i suggerimenti di completamento automatico saranno 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

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.

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 pseudonimo 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.

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": "hol",
      "suggestionTypes": ["RECENT_SEARCH"],
      "userPseudoId": "test_user"
    }'

{
  "recentSearchSuggestions": [
    {
      "suggestion": "holiday readiness",
      "recentSearchTime": "2024-11-19T18:27:07.261698Z"
    },
    {
      "suggestion": "holiday freeze",
      "recentSearchTime": "2024-11-19T18:25:45.744021Z"
    },
    {
      "suggestion": "holiday",
      "recentSearchTime": "2024-11-19T18:20:08.916884Z"
    }
  ]
}

Utilizzare una lista bloccata per il completamento automatico

Puoi utilizzare 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 esclusione sono a livello di data store. Questo è importante se la tua app è un'app di ricerca combinata. Crea una lista di blocco per ogni datastore collegato all'app.

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