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 specificata. Quando specifichi una regione, i dati archiviati non vengono memorizzati al di fuori di questa regione. I prezzi sono gli stessi 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 (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 Multiregionale globale (servizio globale, dati at-rest negli Stati Uniti) global (preferito) o nessuna regione (predefinita) ¶ global (multiregionale) ¶
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 per una singola regione degli Stati Uniti.
Le chiamate alla regione global potrebbero avere una latenza maggiore se effettuate al di fuori degli Stati Uniti. Se possibile, scegli una regione più specifica e vicina ai tuoi servizi e utenti.

Funzionalità disponibili per la pubblicazione regionale

ID regione Riepilogo con sezioni personalizzate v5.0/4.0 Valutazione automatica del riepilogo (anteprima) Analisi del sentiment (v3) Assistente generativo di conoscenze (proattivo) 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 inattivi. 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 questa procedura, i tuoi dati potrebbero essere indirizzati al di fuori della regione.

  • Explorer API, presente 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 della conoscenza generativa (proattiva) sono supportate solo le seguenti regioni: global, us multiregionale e eu multiregionale.

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ù sull'impostazione di 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. Il seguente esempio 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.