Regionalizzazione e localizzazione dei dati

Agent Assist offre la residenza dei dati per mantenere i tuoi dati at-rest fisicamente all'interno di una regione o località geografica specifica. Quando specifichi una regione, i dati at-rest non vengono archiviati al di fuori di questa regione. I prezzi sono uguali per tutte le regioni.

Specificare una regione è particolarmente utile nei seguenti casi d'uso:

  • Il tuo sistema ha requisiti normativi o di policy che regolano la posizione in cui devono risiedere i dati.
  • Le latenze di rete potrebbero migliorare quando i dati si trovano nella stessa regione dei tuoi clienti. Ad esempio, se i clienti belgi utilizzano europe-west1, possono aspettarsi una latenza migliore.

Regioni disponibili

Raggruppamento di paesi Posizione geografica ID regione ID regione datastore
Americhe Iowa us-central1 us (multi-regione)
Americhe Carolina del Sud us-east1
Americhe Oregon us-west1
Americhe Montreal northamerica-northeast1 global (multi-regione)
Americhe Stati Uniti (multi-regione) us * us (multiregionale) *
Europa Belgio europe-west1 eu (multi-regione)
Europa Londra europe-west2
Europa Francoforte europe-west3
Europa Eemshaven europe-west4 eu (multi-regione)
Europa Zurigo europe-west6 eu (multi-regione)
Asia Pacifico Singapore asia-southeast1
Asia Pacifico Giacarta asia-southeast2 global (multi-regione)
Asia Pacifico Tokyo asia-northeast1
Asia Pacifico Mumbai asia-south1
Asia Pacifico Sydney australia-southeast1
Globale Più regioni globali (servizio globale, dati at-rest negli Stati Uniti) global (preferito) o nessuna regione (impostazione predefinita) ¶ global (multi-regione) ¶
Simbolo Descrizione
* Vertex AI non supporta la località multiregionale "us". Di conseguenza, l'utilizzo delle funzionalità di AI generativa di Agent Assist nella multiregione "us" si baserà sui rispettivi endpoint esistenti di una singola regione degli Stati Uniti.
Le chiamate alla regione global potrebbero avere una latenza maggiore se chiamate da un paese diverso dagli Stati Uniti. Se possibile, scegli una regione più specifica e vicina ai tuoi servizi e utenti.

Funzionalità disponibili per la pubblicazione regionale

ID regione Agente complementare Riepilogo con sezioni personalizzate v6.0/5.0/4.0 Valutazione automatica del riepilogo Analisi del sentiment (v3) Assistenza knowledge base generativa (proattiva) Crea il tuo assistente (anteprima) coach AI
us-central1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
us-east1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
us-west1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
us ✓ ✓ ✓ ✓ ✓ ✓
northamerica-northeast1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
europe-west1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
europe-west2 ✓ ✓ ✓ ✓ ✓ ✓ ✓
europe-west3 ✓ ✓ ✓ ✓ ✓ ✓ ✓
europe-west4 ✓ ✓ ✓ ✓ ✓ ✓ ✓
europe-west6 ✓ ✓ ✓ ✓ ✓ ✓
asia-southeast1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
asia-southeast2 ✓ ✓ ✓ ✓ ✓ ✓
asia-northeast1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
asia-south1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
australia-southeast1 ✓ ✓ ✓ ✓ ✓ ✓ ✓
global ✓ ✓ ✓ ✓ ✓ ✓ ✓

Dati at-rest

Tutti i dati degli utenti sviluppatori e degli utenti finali di Agent Assist sono inclusi nei dati at-rest. Ad esempio:

Limitazioni

Si applicano le seguenti limitazioni:

  • La console Agent Assist non supporta la regionalizzazione. Puoi implementare la regionalizzazione solo chiamando direttamente l'API.
  • L'addestramento del modello non supporta la regionalizzazione. Durante questa procedura, i tuoi dati potrebbero essere indirizzati al di fuori della regione.

  • Explorer API, disponibile in molti documenti di riferimento REST, supporta solo la regione global per le chiamate API.

  • CCAI Transcription supporta solo i dati in uso e at-rest (se non si utilizza la funzionalità di adattamento del parlato) in più regioni di UE, Stati Uniti e Nord America (Canada).

  • Per gli archivi di dati utilizzati dalla funzionalità di assistenza generativa (proattiva), sono supportate solo le seguenti regioni: global, us multiregionale e eu multiregionale.

  • Il grounding con la Ricerca Google (GWGS) non supporta la residenza dei dati (DRZ). Se attivato, questo controllo non si applica alle richieste di ricerca. Per maggiori informazioni, consulta Controlli di sicurezza di Gemini Enterprise Agent Platform.

Specificare una regione utilizzando l'API

Per utilizzare la regionalizzazione, devi specificare una regione per ogni richiesta API.

Campi obbligatori:

  • Fornisci l'ID regione per il parametro del percorso dell'URL location.

  • Per la regione global, utilizza dialogflow.googleapis.com per il nome host. Per tutte le altre regioni, utilizza [region-id]-dialogflow.googleapis.com per il nome host.

Ad esempio:

  • dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_id

  • us-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id

Per utilizzare le librerie client, sono necessari i seguenti passaggi:

  • Imposta l'endpoint di servizio su: REGION_ID-dialogflow.googleapis.com.

  • Imposta il nome della risorsa con la località corretta, ad esempio:

    projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id

Credenziali

Ti consigliamo di utilizzare la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS per fornire le credenziali alle librerie client. Per saperne di più su come impostare questa variabile, consulta le istruzioni di configurazione di Dialogflow.

Se invece devi fornire credenziali manuali nel codice, è necessario un passaggio aggiuntivo prima di poter chiamare un endpoint regionalizzato. Quando generi le credenziali di autenticazione, devi impostare l'ambito su https://www.googleapis.com/auth/cloud-platform. L'esempio seguente mostra come eseguire questa operazione in Java durante la creazione di un oggetto GoogleCredentials:

    GoogleCredentials.fromStream(new FileInputStream("credential_file"))
      .createScoped("https://www.googleapis.com/auth/cloud-platform")

Cloud Logging

Consulta la documentazione di Cloud Logging per controllare la regione in cui sono archiviati i log.