Regionalizzazione e localizzazione dei dati

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

La specifica di una regione è particolarmente utile nei seguenti casi d'uso:

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

Aree geografiche disponibili

Raggruppamento 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 (multi-regione) *
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 Multi-regione globale (servizio globale, dati at-rest negli Stati Uniti) global (opzione preferita) o nessuna regione (impostazione predefinita) ¶ global (multi-regione) ¶
Simbolo Descrizione
* Vertex AI non supporta la località multi-regione "us". Di conseguenza, l'utilizzo delle funzionalità di AI generativa di Agent Assist nella multi-regione "us" si baserà sui rispettivi endpoint a singola regione degli Stati Uniti esistenti.
Le chiamate alla regione global potrebbero avere una latenza maggiore se vengono effettuate al di fuori degli Stati Uniti. Se possibile, preferisci una regione più specifica più vicina ai tuoi servizi e utenti.

Funzionalità disponibili per il servizio regionale

ID regione Riepilogo con sezioni personalizzate v6.0/5.0/4.0 Valutazione automatica del riepilogo Analisi del sentiment (v3) Assistenza knowledge base generativa (proattiva) Crea la tua assistenza (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 utente sviluppatore e utente finale di Agent Assist sono inclusi nei dati at-rest. Ad esempio:

Limitazioni

Si applicano le seguenti limitazioni:

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

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

  • CCAI Transcription supporta solo i dati in uso e i dati a riposo (se non utilizzi la funzionalità di adattamento vocale) multi-regionali in UE, Stati Uniti e Nord America (Canada).

  • Per i datastore utilizzati dalla funzionalità di assistenza knowledge base generativa (proattiva) sono supportate solo le seguenti regioni: global, multi-regione us e multi-regione eu.

  • Il grounding con la Ricerca Google (GWGS) non supporta la residenza dei dati (DRZ). Quando è abilitato, questo controllo non si applica alle richieste di ricerca. Per ulteriori 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 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 del 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 ulteriori informazioni sull'impostazione di questa variabile, consulta le istruzioni di configurazione di Dialogflow.

Se invece devi fornire le 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 vengono archiviati i log.