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 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 (più regioni) |
| Americhe | Carolina del Sud | us-east1 |
|
| Americhe | Oregon | us-west1 |
|
| Americhe | Montreal | northamerica-northeast1 |
global (più regioni) |
| Americhe | Multiregione Stati Uniti | us * |
us (più regioni) * |
| Europa | Belgio | europe-west1 |
eu (più regioni) |
| Europa | Londra | europe-west2 |
|
| Europa | Francoforte | europe-west3 |
|
| Europa | Eemshaven | europe-west4 |
eu (più regioni) |
| Europa | Zurigo | europe-west6 |
eu (più regioni) |
| Asia Pacifico | Singapore | asia-southeast1 |
|
| Asia Pacifico | Giacarta | asia-southeast2 |
global (più regioni) |
| Asia Pacifico | Tokyo | asia-northeast1 |
|
| Asia Pacifico | Mumbai | asia-south1 |
|
| Asia Pacifico | Sydney | australia-southeast1 |
|
| Globale | Più regioni globali (pubblicazione globale, dati at-rest negli Stati Uniti) | global (preferito) o nessuna regione (predefinita) ¶ |
global (più regioni) ¶ |
| 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à sugli endpoint esistenti delle singole regioni degli Stati Uniti. |
| ¶ | Le chiamate alla regione global potrebbero avere una latenza maggiore se effettuate al di fuori degli Stati Uniti. Se possibile, preferisci una regione più specifica e vicina ai tuoi servizi e utenti. |
Funzionalità disponibili per la pubblicazione regionale
| ID regione | Riepilogo con sezioni personalizzate v4.0 | Riepilogo con sezioni personalizzate v3.1/3.0 | Valutazione automatica del riepilogo (anteprima) | Analisi del sentiment | Assistente generativo di conoscenze (proattivo) | Crea il tuo assistente (anteprima) |
|---|---|---|---|---|---|---|
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:
- knowledge base e documenti della knowledge base.
- Profili di conversazione.
- Cronologie delle conversazioni e dei messaggi.
- Partecipanti alla conversione.
- Suggerimenti restituiti da Agent Assist.
- Feedbacks.
Limitazioni
Si applicano le seguenti limitazioni:
- La console di Assistente agente 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.
API Explorer, disponibile in molti documenti di riferimento REST, supporta solo la regione
globalper 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,usmultiregionale eeumultiregionale.
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, utilizzadialogflow.googleapis.comper il nome host. Per tutte le altre regioni, utilizza[region-id]-dialogflow.googleapis.comper il nome host.
Ad esempio:
dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_idus-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 ulteriori informazioni 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. 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.