Configurare il completamento automatico

Questa pagina descrive la funzionalità di completamento automatico di base di Gemini Enterprise. Il completamento automatico genera suggerimenti di query in base ai primi caratteri inseriti per la query.

Attenzione: questa versione del completamento automatico non supporta datastore di terze parti o app con più datastore collegati. Google consiglia di utilizzare invece il completamento automatico avanzato.

Per i dati strutturati e non strutturati, per impostazione predefinita, il completamento automatico genera suggerimenti in base ai contenuti dei documenti nel datastore. Dopo l'importazione dei documenti, per impostazione predefinita il completamento automatico non inizia a generare suggerimenti finché non sono disponibili dati di qualità sufficiente, in genere un paio di giorni. Se effettui richieste di completamento automatico tramite l'API, il completamento automatico può generare suggerimenti basati sulla cronologia della Ricerca o sugli eventi utente.

Il modello di suggerimenti di query determina il tipo di dati utilizzato dal completamento automatico per generare suggerimenti. Esistono quattro modelli di suggerimenti di query:

• Documento. Il modello di documento genera suggerimenti dai documenti importati dall'utente.

• Campi configurabili. Il modello dei campi completabili suggerisce il testo preso direttamente dai campi di dati strutturati. Solo i campi annotati con completable vengono utilizzati per i suggerimenti di completamento automatico. Questo modello è disponibile solo per i dati strutturati.

• Cronologia della Ricerca. Il modello della cronologia della Ricerca genera suggerimenti dalla cronologia delle chiamate API SearchService.search. Non utilizzare questo modello se non è disponibile traffico per il metodo servingConfigs.search.

• Evento utente. Il modello di eventi utente genera suggerimenti dagli eventi di ricerca importati dall'utente.

Le richieste di completamento automatico vengono inviate utilizzando il metodo dataStores.completeQuery.

La tabella seguente mostra i tipi di modelli di suggerimenti di query disponibili per ogni tipo di dati.

Modello di suggerimenti di query	Origine dati	Dati del sito web	Dati strutturati	Dati non strutturati
Documento	Importato dall'utente		✔* (predefinito)	✔ (valore predefinito)
Campi configurabili	Importato dall'utente		✔
Cronologia delle ricerche	Raccolti automaticamente	✔ (predefinito)	✔	✔
Eventi utente	Importati dall'utente o raccolti automaticamente dal widget	✔	✔	✔

* : lo schema del documento deve contenere i campi title o description oppure devono essere presenti campi specificati come proprietà chiave title o description. Consulta Aggiorna uno schema per i dati strutturati.

Se non vuoi utilizzare il modello predefinito per il tuo tipo di dati, puoi specificare un modello diverso quando invii la richiesta di completamento automatico. Le richieste di completamento automatico vengono inviate utilizzando il metodo dataStores.completeQuery. Per informazioni, consulta Istruzioni API: invia una richiesta di completamento automatico per scegliere un modello diverso.

Funzionalità di completamento automatico

Gemini Enterprise supporta le seguenti funzionalità di completamento automatico per mostrare le previsioni più utili durante la ricerca:

Funzionalità	Descrizione	Esempio o ulteriori informazioni
Correggere gli errori di battitura	Correggi l'ortografia delle parole che contengono errori di battitura.	Milc → Milk.
Rimuovi i termini non sicuri	Basato su Google SafeSearch. Rimuovere le query inappropriate. Supportato in inglese (en), francese (fr), tedesco (de), italiano (it), polacco (pl), portoghese (pt), russo (ru), spagnolo (es) e ucraino (uk).	Testo offensivo, ad esempio pornografico, osé, volgare o violento.
Impedisci la visualizzazione delle informazioni che consentono l'identificazione personale (PII) di base	Basato su Sensitive Data Protection, Gemini Enterprise compie uno sforzo ragionevole per impedire la visualizzazione di tipi di PII di base, come numeri di telefono e indirizzi email.	Se nel datastore è presente un indirizzo email [e-mail], Gemini Enterprise non lo restituirà come suggerimento di completamento automatico se l'utente digita jef nella barra di ricerca. Per proteggerti in modo più completo dalle fughe di PII, Google consiglia di applicare la tua soluzione di Prevenzione della perdita di dati (DLP) oltre ai rilevatori forniti da Gemini Enterprise. Per saperne di più, consulta Protezione dalle fughe di PII.
Lista bloccata	Rimuovi i termini elencati nella lista bloccata.	Per saperne di più, consulta Usa una lista bloccata a completamento automatico.
Deduplica i termini	Basato sulla comprensione semantica basata sull'AI. Per i termini quasi identici, entrambi i termini corrispondono, ma viene suggerito solo quello più popolare.	Shoes for Women, Womens Shoes e Womans Shoes vengono deduplicati e viene suggerito solo quello più popolare.
Suggerimenti per la corrispondenza della coda	Non disponibile nelle multiregioni US ed EU. Impostazione facoltativa. Se non sono presenti corrispondenze di completamento automatico per l'intera query, suggerisci corrispondenze solo per la parola finale della query. Non disponibile per la ricerca di servizi sanitari.	Per saperne di più, consulta Suggerimenti per la corrispondenza finale.

Suggerimenti per la corrispondenza della coda

I suggerimenti di corrispondenza finale vengono generati utilizzando la corrispondenza esatta del prefisso con l'ultima parola di una stringa di query.

Ad esempio, supponiamo che la query "canzoni con lui" venga inviata in una richiesta di completamento automatico. Quando la corrispondenza della coda è attivata, il completamento automatico potrebbe rilevare che il prefisso completo "canzoni con lui" non ha corrispondenze. Tuttavia, l'ultima parola della query, "he", ha una corrispondenza esatta del prefisso con "hello world" e "hello kitty". In questo caso, i suggerimenti restituiti sono "canzoni con hello world" e "canzoni con hello kitty" perché non esistono suggerimenti con corrispondenza esatta.

Puoi utilizzare questa funzionalità per ridurre i risultati dei suggerimenti vuoti e aumentare la diversità dei suggerimenti, il che è particolarmente utile nei casi in cui le origini dati (conteggio degli eventi utente, cronologia della Ricerca e copertura degli argomenti dei documenti) sono limitate. Tuttavia, l'attivazione dei suggerimenti di corrispondenza finale può ridurre la qualità complessiva dei suggerimenti. Poiché la corrispondenza finale corrisponde solo alla parola finale del prefisso, alcuni suggerimenti restituiti potrebbero non avere senso. Ad esempio, una query come "canzoni con lui" potrebbe ricevere un suggerimento di corrispondenza finale come "canzoni con guide per aiutanti".

I suggerimenti di corrispondenza finale vengono restituiti solo se:

1. include_tail_suggestions è impostato su true nella richiesta dataStores.completeQuery.

2. Non esistono suggerimenti di corrispondenza con prefisso completo per la query.

Proteggiti dalle fughe di PII

La definizione di PII è ampia e le PII possono essere difficili da rilevare. Di conseguenza, Gemini Enterprise non può garantire che le PII non vengano restituite nei suggerimenti di completamento automatico.

Gemini Enterprise applica il servizio di ispezione di Sensitive Data Protection per cercare e bloccare i tipi comuni di PII in modo che non vengano visualizzati come suggerimenti. Tuttavia, se i tuoi datastore contengono PII o se utilizzi i modelli di suggerimenti di query basati sulla cronologia delle ricerche o sugli eventi utente, esamina quanto segue e intraprendi l'azione appropriata:

1. Se i tipi di PII che vuoi proteggere sono abbastanza standard, come numeri di telefono e indirizzi email, inizia testando in modo approfondito i suggerimenti di completamento automatico per la tua app. Gemini Enterprise non può garantire che le PII non vengano restituite nei suggerimenti di completamento automatico.

2. Se durante i test di completamento automatico vengono rilevate fughe di PII o se sai già di avere PII non standard da proteggere (ad esempio ID utente proprietari), prova a regolare la soglia di completamento automatico e i parametri di pubblicazione dei contenuti. Per saperne di più, consulta Riduci il rischio di restituire suggerimenti che contengono PII.

3. Se la modifica dei parametri non è sufficiente per impedire la fuga di PII, implementa la tua soluzione DLP. Personalizza la soluzione DLP per i tipi di PII che più probabilmente si trovano nei tuoi datastore, negli eventi utente o nelle query di ricerca degli utenti. Puoi utilizzare Sensitive Data Protection o un servizio DLP di terze parti. Scegli uno dei metodi seguenti:

   • Filtra le PII prima di importare i documenti e gli eventi utente nei datastore.

   • Esamina i suggerimenti di completamento automatico prima di presentarli all'utente al momento della pubblicazione e blocca quelli che contengono PII.

4. Se utilizzi il modello di cronologia delle ricerche o di eventi utente, aggiungi un testo informativo nella barra di ricerca per invitare gli utenti a non inserire PII nelle query di ricerca.

5. Se hai domande o riscontri problemi particolari con il blocco delle PII, contatta il tuo Customer Engineer (CE) o il team dedicato all'Account Google.

Attiva o disattiva il completamento automatico per un widget

Per attivare o disattivare il completamento automatico per un widget, segui questi passaggi:

Console

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

   Gemini Enterprise

2. Fai clic sul nome dell'app da modificare.

3. Fai clic su Configurations (Configurazione).

4. Fai clic sulla scheda UI.

5. Attiva o disattiva l'opzione Mostra suggerimenti di completamento automatico per attivare o disattivare i suggerimenti di completamento automatico per il widget. Se attivi il completamento automatico, dovrai attendere uno o due giorni prima che i suggerimenti vengano visualizzati.

Aggiorna le impostazioni di completamento automatico

Per configurare le impostazioni di completamento automatico nella UI, segui questi passaggi:

Console

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

   Gemini Enterprise

2. Fai clic sul nome dell'app da modificare.

3. Fai clic su Configurations (Configurazione).

4. Fai clic sulla scheda Completamento automatico.

5. Inserisci o seleziona nuovi valori per le impostazioni di completamento automatico che vuoi aggiornare:

   • Numero massimo di suggerimenti: il numero massimo di suggerimenti di completamento automatico che possono essere offerti per una query.
   • Lunghezza minima per l'attivazione: il numero minimo di caratteri che è possibile digitare prima che vengano offerti i suggerimenti di completamento automatico.
   • Ordine corrispondente: la posizione in una stringa di query da cui il completamento automatico può iniziare ad abbinare i suggerimenti.
   • Modello di suggerimenti di query: il modello di suggerimenti di query utilizzato per generare i suggerimenti recuperati. Puoi eseguire l'override di questa impostazione in dataStores.completeQuery utilizzando il parametro queryModel.

   • Attiva il completamento automatico: per impostazione predefinita, il completamento automatico non inizia a fornire suggerimenti finché non dispone di dati di qualità sufficiente, in genere un paio di giorni. Se vuoi ignorare questa impostazione predefinita e iniziare a ricevere alcuni suggerimenti di completamento automatico prima, seleziona Ora.

     Anche se selezioni Ora, la generazione dei suggerimenti può richiedere un giorno e alcuni suggerimenti di completamento automatico potrebbero mancare o essere di scarsa qualità finché non saranno disponibili dati sufficienti.

   • Denylist: importa una denylist come file JSON in un bucket Cloud Storage. Per saperne di più sui vincoli e sulle specifiche della lista bloccata, consulta Utilizza una lista bloccata a completamento automatico.

6. Fai clic su Salva e pubblica. Le modifiche diventano effettive entro pochi minuti per i motori in cui il completamento automatico è già stato attivato.

Riduci il rischio di restituire suggerimenti che contengono PII

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Gli utenti finali dispongono di tutti i tipi di informazioni PII, come patenti di guida e numeri di telefono, che dovrebbero mantenere private. Tuttavia, queste PII potrebbero essere digitate nella barra di ricerca dagli utenti che cercano risultati specifici per loro.

Se utilizzi il modello di cronologia della ricerca o di eventi utente ed esiste la probabilità che gli utenti digitino PII nella barra di ricerca, puoi ridurre le fughe di PII modificando i seguenti parametri:

• queryFrequencyThreshold: prima che una query possa essere restituita come suggerimento di completamento automatico, deve essere stata inserita questo numero di volte.

• numUniqueUsersThreshold: prima che una query possa essere restituita come suggerimento di completamento automatico, deve essere stata inserita da questo numero di utenti unici. Il valore del campo userPseudoId nell'evento utente di ricerca determina se l'utente è unico.

Esempio di caso d'uso

Ad esempio, prendi in considerazione un caso in cui gli utenti hanno numeri di conto bancario che devono essere mantenuti privati.

Se è in uso il modello di suggerimento della cronologia della Ricerca o degli eventi utente, questi numeri di conto bancario, insieme a tutti gli altri termini cercati dagli utenti finali, vengono utilizzati per generare suggerimenti. Pertanto, se il numero di conto bancario dell'utente A YZ-46789A è stato inserito ripetutamente nella barra di ricerca e l'utente B ha un numero di conto bancario YZ-42345B, quando l'utente B digita YZ-4 nella barra di ricerca, il suggerimento di completamento automatico restituito potrebbe essere il numero di conto bancario dell'utente A.

Per ridurre la probabilità che si verifichi questo tipo di fuga di dati, l'amministratore di Gemini Enterprise decide di:

• Aumenta il valore del parametro queryFrequencyThreshold impostandolo su 30. In questo caso, è molto improbabile che un numero di conto bancario venga inserito così spesso. Tuttavia, le query di ricerca più frequenti verranno inserite almeno con questa frequenza.

• Aumenta il valore del parametro numUniqueUsersThreshold impostandolo su 6. L'amministratore ritiene improbabile che lo stesso numero di conto bancario venga inserito nella barra di ricerca in sei eventi di ricerca, ciascuno associato a un userPseudoId diverso.

Procedura

Esistono due parametri di soglia per il completamento automatico. Questi parametri non sono disponibili nella console Google Cloud , ma possono essere impostati con una chiamata API REST al metodo updateCompletionConfig.

Nota: questi parametri si applicano solo ai modelli di cronologia delle ricerche e di eventi utente.

Per configurare le impostazioni della soglia di completamento automatico, segui questi passaggi. Ogni passaggio è facoltativo, a seconda del parametro che vuoi modificare.

REST

1. Aggiorna il campo CompletionConfig.queryFrequencyThreshold:

   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -H "X-Goog-User-Project: PROJECT_ID" \
     https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/completionConfig?updateMask=queryFrequencyThreshold \
     -d '{
       "name": "projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/completionConfig",
       "queryFrequencyThreshold": QUERY_FREQUENCY_THRESHOLD
     }'
   

   Sostituisci quanto segue:

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

   • DATA_STORE_ID: l'ID del datastore associato alla tua app.

   • QUERY_FREQUENCY_THRESHOLD: un valore intero che indica il numero minimo di volte in cui una query di ricerca deve essere inserita prima di poter essere restituita come suggerimento di completamento automatico. Il conteggio viene sommato in una finestra temporale mobile di un mese. Il valore predefinito è 8.

   Esempio di comando e risultato

   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \$ curl -X PATCH \
     -H "X-Goog-User-Project: my-project-123" \t-access-token)" \
     https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/dataStores/my-data-store/completionConfig?updateMask=queryFrequencyThreshold \
     -d '{
     "name": "projects/my-project-123/locations/global/collections/default_collection/dataStores/my-data-store/completionConfig",
     "queryFrequencyThreshold": 30
     }'
     
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/completionConfig",
     "matchingOrder": "exact-prefix",
     "maxSuggestions": 20,
     "minPrefixLength": 1,
     "queryModel": "automatic",
     "enableMode": "AUTOMATIC",
     "queryFrequencyThreshold": 30
   }
   

2. Aggiorna il campo CompletionConfig.numUniqueUsersThreshold:

   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -H "X-Goog-User-Project: PROJECT_ID" \
     https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/completionConfig?updateMask=numUniqueUsersThreshold \
     -d '{
       "name": "projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/completionConfig",
       "numUniqueUsersThreshold": UNIQUE_USERS
     }'
   

   Sostituisci UNIQUE_USERS con un valore intero che rappresenta il numero minimo di utenti unici che devono inserire una determinata query di ricerca prima che possa essere restituita come suggerimento di completamento automatico. Il conteggio viene sommato in un periodo di tempo continuo di un mese. Il valore predefinito è 3.

   Esempio di comando e risultato

   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -H "X-Goog-User-Project: my-project-123" \
     https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/dataStores/my-data-store/completionConfig?updateMask=numUniqueUsersThreshold \
     -d '{
     "name": "projects/my-project-123/locations/global/collections/default_collection/dataStores/my-data-store/completionConfig",
       "numUniqueUsersThreshold": 6
     }'
     
   
   {
   "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/completionConfig",
     "matchingOrder": "exact-prefix",
     "maxSuggestions": 20,
     "minPrefixLength": 1,
     "queryModel": "automatic",
     "enableMode": "AUTOMATIC",
     "numUniqueUsersThreshold": 6,
     "queryFrequencyThreshold": 30
   }
   

Aggiorna le annotazioni dei campi completabili nello schema

Per attivare il completamento automatico per i campi nello schema dei dati strutturati, segui questi passaggi:

Console

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

   Gemini Enterprise

2. Fai clic sul nome dell'app da modificare. Deve utilizzare dati strutturati.

3. Fai clic su Dati.

4. Fai clic sulla scheda Schema.

5. Fai clic su Modifica per selezionare i campi dello schema da contrassegnare come completable.

6. Fai clic su Salva per salvare le configurazioni dei campi aggiornate. La generazione e la restituzione di questi suggerimenti richiedono circa un giorno.

Invia richieste di completamento automatico

I seguenti esempi mostrano come inviare richieste di completamento automatico.

REST

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

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

   1. Nella console Google Cloud , vai alla pagina Gemini Enterprise e nel menu di navigazione, fai clic su Datastore.

      Vai alla pagina Datastore

   2. Fai clic sul nome del tuo datastore.

   3. Nella pagina Dati del datastore, recupera l'ID del datastore.

2. Chiama il metodo dataStores.completeQuery.

   curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID:completeQuery?query=QUERY_STRING"
   

   Sostituisci quanto segue:

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

   • DATA_STORE_ID: l'ID del datastore associato alla tua app.

   • QUERY_STRING: l'input di previsione del testo utilizzato per recuperare i suggerimenti.

Invia una richiesta di completamento automatico a un altro modello

Per inviare una richiesta di completamento automatico con un modello di suggerimenti di query diverso, segui questi passaggi:

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

   1. Nella console Google Cloud , vai alla pagina Gemini Enterprise e nel menu di navigazione, fai clic su Datastore.

      Vai alla pagina Datastore

   2. Fai clic sul nome del tuo datastore.

   3. Nella pagina Dati del datastore, recupera l'ID del datastore.

2. Chiama il metodo dataStores.completeQuery.

   curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID:completeQuery?query=QUERY_STRING&query_model=QUERY_SUGGESTIONS_MODEL"
   

   Sostituisci quanto segue:

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

   • DATA_STORE_ID: l'ID univoco del datastore associato alla tua app.

   • QUERY_STRING: l'input di previsione del testo utilizzato per recuperare i suggerimenti.

   • QUERY_SUGGESTIONS_MODEL: il modello di suggerimenti di query da utilizzare per la richiesta: document, document-completable, search-history o user-event. Per i dati sanitari, utilizza healthcare-default.

C#

Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Gemini Enterprise per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Gemini Enterprise C#.

Per eseguire l'autenticazione in Gemini Enterprise, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

using Google.Cloud.DiscoveryEngine.V1;

public sealed partial class GeneratedCompletionServiceClientSnippets
{
    /// <summary>Snippet for CompleteQuery</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void CompleteQueryRequestObject()
    {
        // Create client
        CompletionServiceClient completionServiceClient = CompletionServiceClient.Create();
        // Initialize request argument(s)
        CompleteQueryRequest request = new CompleteQueryRequest
        {
            DataStoreAsDataStoreName = DataStoreName.FromProjectLocationDataStore("[PROJECT]", "[LOCATION]", "[DATA_STORE]"),
            Query = "",
            QueryModel = "",
            UserPseudoId = "",
            IncludeTailSuggestions = false,
        };
        // Make the request
        CompleteQueryResponse response = completionServiceClient.CompleteQuery(request);
    }
}

Go

Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Gemini Enterprise per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Gemini Enterprise Go.

Per eseguire l'autenticazione in Gemini Enterprise, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

//go:build examples

package main

import (
	"context"

	discoveryengine "cloud.google.com/go/discoveryengine/apiv1"
	discoveryenginepb "cloud.google.com/go/discoveryengine/apiv1/discoveryenginepb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := discoveryengine.NewCompletionClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &discoveryenginepb.CompleteQueryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/discoveryengine/apiv1/discoveryenginepb#CompleteQueryRequest.
	}
	resp, err := c.CompleteQuery(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

Java

Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Gemini Enterprise per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Gemini Enterprise Java.

Per eseguire l'autenticazione in Gemini Enterprise, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

import com.google.cloud.discoveryengine.v1.CompleteQueryRequest;
import com.google.cloud.discoveryengine.v1.CompleteQueryResponse;
import com.google.cloud.discoveryengine.v1.CompletionServiceClient;
import com.google.cloud.discoveryengine.v1.DataStoreName;

public class SyncCompleteQuery {

  public static void main(String[] args) throws Exception {
    syncCompleteQuery();
  }

  public static void syncCompleteQuery() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CompletionServiceClient completionServiceClient = CompletionServiceClient.create()) {
      CompleteQueryRequest request =
          CompleteQueryRequest.newBuilder()
              .setDataStore(
                  DataStoreName.ofProjectLocationDataStoreName(
                          "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
                      .toString())
              .setQuery("query107944136")
              .setQueryModel("queryModel-184930495")
              .setUserPseudoId("userPseudoId-1155274652")
              .setIncludeTailSuggestions(true)
              .build();
      CompleteQueryResponse response = completionServiceClient.completeQuery(request);
    }
  }
}

Node.js

Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Gemini Enterprise per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Gemini Enterprise Node.js.

Per eseguire l'autenticazione in Gemini Enterprise, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The parent data store resource name for which the completion is
 *  performed, such as
 *  `projects/* /locations/global/collections/default_collection/dataStores/default_data_store`.
 */
// const dataStore = 'abc123'
/**
 *  Required. The typeahead input used to fetch suggestions. Maximum length is
 *  128 characters.
 */
// const query = 'abc123'
/**
 *  Specifies the autocomplete data model. This overrides any model specified
 *  in the Configuration > Autocomplete section of the Cloud console. Currently
 *  supported values:
 *  * `document` - Using suggestions generated from user-imported documents.
 *  * `search-history` - Using suggestions generated from the past history of
 *  SearchService.Search google.cloud.discoveryengine.v1.SearchService.Search 
 *  API calls. Do not use it when there is no traffic for Search API.
 *  * `user-event` - Using suggestions generated from user-imported search
 *  events.
 *  * `document-completable` - Using suggestions taken directly from
 *  user-imported document fields marked as completable.
 *  Default values:
 *  * `document` is the default model for regular dataStores.
 *  * `search-history` is the default model for site search dataStores.
 */
// const queryModel = 'abc123'
/**
 *  Optional. A unique identifier for tracking visitors. For example, this
 *  could be implemented with an HTTP cookie, which should be able to uniquely
 *  identify a visitor on a single device. This unique identifier should not
 *  change if the visitor logs in or out of the website.
 *  This field should NOT have a fixed value such as `unknown_visitor`.
 *  This should be the same identifier as
 *  UserEvent.user_pseudo_id google.cloud.discoveryengine.v1.UserEvent.user_pseudo_id 
 *  and
 *  SearchRequest.user_pseudo_id google.cloud.discoveryengine.v1.SearchRequest.user_pseudo_id.
 *  The field must be a UTF-8 encoded string with a length limit of 128
 *  characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
 */
// const userPseudoId = 'abc123'
/**
 *  Indicates if tail suggestions should be returned if there are no
 *  suggestions that match the full query. Even if set to true, if there are
 *  suggestions that match the full query, those are returned and no
 *  tail suggestions are returned.
 */
// const includeTailSuggestions = true

// Imports the Discoveryengine library
const {CompletionServiceClient} = require('@google-cloud/discoveryengine').v1;

// Instantiates a client
const discoveryengineClient = new CompletionServiceClient();

async function callCompleteQuery() {
  // Construct request
  const request = {
    dataStore,
    query,
  };

  // Run request
  const response = await discoveryengineClient.completeQuery(request);
  console.log(response);
}

callCompleteQuery();

Python

Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Gemini Enterprise per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Gemini Enterprise Python.

Per eseguire l'autenticazione in Gemini Enterprise, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import discoveryengine_v1


def sample_complete_query():
    # Create a client
    client = discoveryengine_v1.CompletionServiceClient()

    # Initialize request argument(s)
    request = discoveryengine_v1.CompleteQueryRequest(
        data_store="data_store_value",
        query="query_value",
    )

    # Make the request
    response = client.complete_query(request=request)

    # Handle the response
    print(response)

Ruby

Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Gemini Enterprise per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Gemini Enterprise Ruby.

Per eseguire l'autenticazione in Gemini Enterprise, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

require "google/cloud/discovery_engine/v1"

##
# Snippet for the complete_query call in the CompletionService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::DiscoveryEngine::V1::CompletionService::Client#complete_query.
#
def complete_query
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::DiscoveryEngine::V1::CompletionService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::DiscoveryEngine::V1::CompleteQueryRequest.new

  # Call the complete_query method.
  result = client.complete_query request

  # The returned object is of type Google::Cloud::DiscoveryEngine::V1::CompleteQueryResponse.
  p result
end

Usa una lista bloccata a completamento automatico

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

Ad esempio, prendiamo un'azienda farmaceutica. Se un farmaco non è più approvato dalla FDA, ma è menzionato nei documenti del datastore, l'utente potrebbe voler impedire che venga visualizzato come query suggerita. L'azienda potrebbe aggiungere il nome del farmaco a una lista bloccata per evitare che venga suggerito.

I limiti sono i seguenti:

• Una lista bloccata per datastore
• Il caricamento di una lista bloccata sovrascrive qualsiasi lista bloccata esistente per quel datastore
• Fino a 1000 termini per lista bloccata
• I termini non fanno distinzione tra maiuscole e minuscole
• Dopo aver importato una lista bloccata, l'applicazione richiede 1-2 giorni

Ogni voce della lista bloccata è composta da un blockPhrase e un matchOperator:

• blockPhrase: inserisci una stringa come termine della lista bloccata. I termini non sono sensibili alle maiuscole.
• matchOperator: accetta i seguenti valori:
  • EXACT_MATCH: impedisce che una corrispondenza esatta del termine della lista bloccata venga visualizzata come query suggerita.
  • CONTAINS: impedisce la visualizzazione di qualsiasi suggerimento che contenga il termine della lista bloccata.

Di seguito è riportato un esempio di lista bloccata con quattro voci:

{
    "entries": [
        {"blockPhrase":"Oranges","matchOperator":"CONTAINS"},
        {"blockPhrase":"bAd apples","matchOperator":"EXACT_MATCH"},
        {"blockPhrase":"Cool as A Cucumber","matchOperator":"EXACT_MATCH"},
        {"blockPhrase":"cherry pick","matchOperator":"CONTAINS"}
    ]
}

Prima di importare una lista bloccata, verifica che siano impostati i controlli di accesso necessari per l'accesso come editor di Discovery Engine.

Le liste bloccate possono essere importate da dati JSON locali o da Cloud Storage. Per rimuovere una lista bloccata da un datastore, eliminala definitivamente.

Importa una lista bloccata da dati JSON locali

Per importare una lista bloccata da un file JSON locale contenente la tua lista bloccata:

1. Crea la tua lista bloccata in un file JSON locale con il seguente formato. Assicurati che ogni voce della lista bloccata si trovi su una nuova riga senza interruzioni di riga.

   {
       "inlineSource": {
           "entries": [
               { "blockPhrase":"TERM_1","matchOperator":"MATCH_OPERATOR_1" },
               { "blockPhrase":"TERM_2","matchOperator":"MATCH_OPERATOR_2" }
           ]
       }
   }

2. Invia una richiesta POST al metodo suggestionDenyListEntries:import, fornendo il nome del file JSON.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json; charset=utf-8" \
       --data @DENYLIST_FILE \
     "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/suggestionDenyListEntries:import"
   

   Sostituisci quanto segue:

   • DENYLIST_FILE: il percorso locale del file JSON contenente i termini della lista bloccata.

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

   • DATA_STORE_ID: l'ID del datastore associato alla tua app.

Dopo aver importato la lista bloccata, sono necessari 1-2 giorni per iniziare a filtrare i suggerimenti.

Importa una lista bloccata da Cloud Storage

Per importare una lista bloccata da un file JSON in Cloud Storage, segui questi passaggi:

1. Crea la tua lista bloccata in un file JSON con il seguente formato e importala in un bucket Cloud Storage. Assicurati che ogni voce della lista bloccata si trovi su una nuova riga senza interruzioni di riga.

   { "blockPhrase":"TERM_1","matchOperator":"MATCH_OPERATOR_1" }
   { "blockPhrase":"TERM_2","matchOperator":"MATCH_OPERATOR_2" }

2. Crea un file JSON locale contenente l'oggetto gcsSource. Utilizza questo campo per indicare la posizione del file della lista bloccata in un bucket Cloud Storage.

   {
       "gcsSource": {
           "inputUris": [ "DENYLIST_STORAGE_LOCATION" ]
       }
   }

   Sostituisci DENYLIST_STORAGE_LOCATION con la posizione della tua lista bloccata in Cloud Storage. Puoi inserire un solo URI. L'URI deve essere inserito in questo formato: gs://BUCKET/FILE_PATH.

3. Invia una richiesta POST al metodo suggestionDenyListEntries:import, incluso l'oggetto gcsSource.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json; charset=utf-8" \
       --data @GCS_SOURCE_FILE \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/suggestionDenyListEntries:import"
   

   Sostituisci quanto segue:

   • GCS_SOURCE_FILE: il percorso locale del file contenente l'oggetto gcsSource che punta alla tua lista bloccata.

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

   • DATA_STORE_ID: l'ID del datastore associato alla tua app.

Dopo aver importato la lista bloccata, sono necessari 1-2 giorni per iniziare a filtrare i suggerimenti.

Elimina una lista bloccata

Per eliminare definitivamente una lista bloccata dal datastore, segui questi passaggi:

1. Invia una richiesta POST al metodo suggestionDenyListEntries:purge.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/suggestionDenyListEntries:purge"
   

   Sostituisci quanto segue:

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

   • DATA_STORE_ID: l'ID del datastore associato alla tua app.

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

Nota: i suggerimenti importati non vengono sottoposti alla correzione ortografica. Tuttavia, prima della pubblicazione viene applicata la seguente elaborazione:

• Normalizzazione del testo. Il testo del suggerimento è in minuscolo, normalizzato in Unicode, ha spazi vuoti interni compressi, apostrofi curvi (U+2018, U+2019) convertiti nell'apostrofo ASCII (U+0027) e caratteri di virgolette doppie incorporati e punti finali rimossi.
• Filtro della lunghezza. I suggerimenti con meno di tre caratteri o più di 125 caratteri vengono ignorati.
• Deduplicazione tramite aggregazione dei punteggi. Se due o più suggerimenti importati vengono normalizzati nello stesso testo (ad esempio, "Pixel 10 Pro Moonstone" e "Pixel 10 Pro moonstone" o "jobseeker’s allowance" con un apostrofo curvo e "jobseeker's allowance" con un apostrofo ASCII), vengono uniti in un unico suggerimento il cui punteggio è la somma dei punteggi di input. Invia ogni suggerimento distinto una sola volta se vuoi che il suo punteggio venga conservato così com'è.
• Filtro delle PII. I suggerimenti identificati come contenenti informazioni che consentono l'identificazione personale vengono filtrati.
• Filtro della lista bloccata. I suggerimenti corrispondenti alle frasi nella lista bloccata dei suggerimenti del datastore vengono esclusi.

SafeSearch non viene applicato ai suggerimenti importati; è tua responsabilità assicurarti che i suggerimenti importati siano appropriati per i tuoi utenti.

Per la maggior parte delle applicazioni, l'utilizzo dei suggerimenti generati da uno dei modelli di dati di completamento automatico produce risultati migliori. Tuttavia, in rari casi i suggerimenti del modello potrebbero non corrispondere alle tue esigenze e fornire un elenco discreto di suggerimenti offre agli utenti un'esperienza di completamento automatico migliore.

Ad esempio, una piccola libreria online importa il proprio elenco di titoli di libri come suggerimenti di completamento automatico. Quando un cliente inizia a digitare nella barra di ricerca, il suggerimento di completamento automatico sarà sempre un titolo del libro dell'elenco importato. Quando l'elenco dei libri cambia, la libreria elimina l'elenco corrente e importa quello nuovo. Un estratto dell'elenco potrebbe essere simile al seguente:

{"suggestion": "Wuthering Heights", "globalScore": "0.52" },
{"suggestion": "The Time Machine", "globalScore": "0.26" },
{"suggestion": "Nicholas Nickleby", "globalScore": "0.38" },
{"suggestion": "A Little Princess", "globalScore": "0.71" },
{"suggestion": "The Scarlet Letter", "globalScore": "0.32" }

globalScore è un numero con rappresentazione in virgola mobile compreso nell'intervallo [0, 1] utilizzato per classificare il suggerimento. In alternativa, puoi utilizzare un punteggio frequency, ovvero un numero intero maggiore di uno. Il punteggio frequency viene utilizzato per classificare i suggerimenti quando globalScore non è disponibile (impostato su null).

Nota: anche se nei dati puoi fornire un solo punteggio (globalScore o frequency), nei passaggi seguenti per creare una tabella BigQuery, sia globalScore che frequency sono obbligatori nello schema. Uno schema errato comporterà l'errore di importazione dei suggerimenti.

Prima di iniziare

Per importare i suggerimenti di completamento automatico, devi disporre del ruolo IAM Discovery Engine Admin, che include l'autorizzazione discoveryengine.completionSuggestions.import.

Per saperne di più, consulta Ruoli e autorizzazioni IAM.

Configura e importa i suggerimenti di completamento automatico

Per configurare e importare un elenco di suggerimenti di completamento automatico da BigQuery, segui questi passaggi:

1. Crea l'elenco di suggerimenti e caricalo in una tabella BigQuery.

   Come minimo, devi fornire ogni suggerimento come stringa e un punteggio globale o una frequenza.

   Utilizza il seguente schema di tabella per l'elenco di suggerimenti:

   [
     {
       "description": "The suggestion text",
       "mode": "REQUIRED",
       "name": "suggestion",
       "type": "STRING"
     },
     {
       "description": "Global score of this suggestion. Control how this suggestion would be scored and ranked. Set global score or frequency; not both.",
       "mode": "NULLABLE",
       "name": "globalScore",
       "type": "FLOAT"
     },
     {
       "description": "Frequency of this suggestion. Used to rank suggestions when the global score is not available.",
       "mode": "NULLABLE",
       "name": "frequency",
       "type": "INTEGER"
     }
   ]
   

   Consulta la documentazione di BigQuery per istruzioni su come creare una tabella BigQuery e caricare la tabella con l'elenco di suggerimenti di completamento automatico.

2. Importa l'elenco da BigQuery.

   Invia una richiesta POST al metodo completionSuggestions:import, includendo l'oggetto bigquerySource.

   curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/completionSuggestions:import" \
    -d '{
         "bigquery_source": {"project_id": "PROJECT_ID_SOURCE", "dataset_id": "DATASET_ID", "table_id": "TABLE_ID"}
    }'
   

   Sostituisci quanto segue:

   • PROJECT_ID: il numero o l'ID del tuo progetto Google Cloud .
   • DATA_STORE_ID: l'ID del datastore.
   • PROJECT_ID_SOURCE: il progetto che contiene il set di dati che vuoi importare.
   • DATASET_ID: l'ID del set di dati per l'elenco di suggerimenti che vuoi importare
   • TABLE_ID: l'ID tabella dell'elenco di suggerimenti che vuoi importare

   Esempio di comando e risultato

   curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -H "X-Goog-User-Project: my-project-123" \
    "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/dataStores/my-data-store/completionSuggestions:import" \
    -d '{
   "bigquery_source": {"project_id": "my-project-123", "dataset_id": "autocomplete", "table_id": "import_suggestion2"}
   }'
       
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/operations/import-completion-suggestion-7659310803143180509",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.ImportCompletionSuggestionsMetadata"
     }
   }
   

3. (Facoltativo) Prendi nota del valore name restituito e segui le istruzioni riportate in Ottieni dettagli su un'operazione a lunga esecuzione per vedere quando l'operazione di importazione è completata.

4. Se non hai attivato il completamento automatico per l'app, segui la procedura Aggiorna le impostazioni di completamento automatico. Assicurati di impostare l'opzione Abilita completamento automatico su Ora.

5. Attendi un paio di giorni per il completamento dell'indicizzazione e per rendere disponibili i suggerimenti importati.

Invia una richiesta di completamento automatico

Per inviare una richiesta di completamento automatico che restituisca un suggerimento importato anziché un suggerimento di un modello di completamento automatico:

1. Segui la procedura per inviare una richiesta di completamento automatico a un modello diverso e imposta QUERY_SUGGESTIONS_MODEL su imported-suggestion.

   Esempio di comando e risultato

   curl -X GET \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "X-Goog-User-Project: my-project-123" \
       "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/dataStores/my-data-store:completeQuery?query=t&query_model=imported-suggestion"
       
   
   Response:
   {
     "querySuggestions": [
       {
         "suggestion": "The Time Machine"
       },
       {
         "suggestion": "The Scarlet Letter"
       }
     ]
   }
   

Elimina l'elenco dei suggerimenti di completamento automatico importati

Prima di importare un nuovo elenco di suggerimenti di completamento automatico, rimuovi quello esistente.

Per eliminare un elenco esistente di suggerimenti di completamento automatico, segui questo passaggio:

1. Invia una richiesta POST al metodo completionSuggestions:purge.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/completionSuggestions:purge"
   

   Sostituisci quanto segue:

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

   • DATA_STORE_ID: l'ID del datastore associato alla tua app.

   Esempio di comando e risultato

   curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -H "X-Goog-User-Project: my-project-123" \
    "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/dataStores/my-data-store/completionSuggestions:purge"
       
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/operations/purge-customer-imported_suggestions-3197526711414652502",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.PurgeCompletionSuggestionsMetadata",
       "createTime": "2024-06-27T17:07:09.551726728Z",
       "updateTime": "2024-06-27T17:07:09.551726728Z"
     }
   }
   

2. (Facoltativo) Prendi nota del valore name restituito e segui le istruzioni riportate in Ottieni dettagli su un'operazione a lunga esecuzione per vedere quando l'operazione di eliminazione è completata.

Modello dei dati dei documenti avanzato

Sperimentale

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Gemini Enterprise fornisce un modello dei dati avanzato per il completamento automatico. In base ai documenti che importi, questo modello dei dati genera suggerimenti di completamento automatico di alta qualità sfruttando i modelli linguistici di grandi dimensioni (LLM) di Google.

Si tratta di una funzionalità sperimentale. Se ti interessa utilizzare questa funzionalità, contatta il team dedicato all'account Google Cloud e chiedi di essere aggiunto alla lista consentita.

Il modello dei dati dei documenti avanzato non è disponibile per la ricerca nel settore sanitario o nelle multiregioni degli Stati Uniti e dell'UE.