Agent Assist fornisce la residenza dei dati per mantenere i dati at-rest fisicamente all'interno di una regione o località geografica specificata. Quando specifichi una regione, i dati at-rest non vengono archiviati al di fuori di quella regione. I prezzi sono uguali per tutte le regioni.
La specifica di una regione è particolarmente utile nei seguenti casi d'uso:
- Il tuo sistema ha requisiti normativi o di norme che regolano la posizione in cui devono trovarsi i tuoi dati.
- Le latenze di rete potrebbero essere migliorate quando i dati si trovano nella stessa regione dei tuoi clienti. Ad esempio, se i clienti in Belgio utilizzano
europe-west1, possono aspettarsi una latenza migliore.
Aree geografiche disponibili
| Raggruppamento per paese | Posizione geografica | ID regione | ID regione del datastore |
|---|---|---|---|
| Americhe | Iowa | us-central1 |
us (più regioni) |
| Americhe | Carolina del Sud | us-east1 |
|
| Americhe | Oregon | us-west1 |
|
| Americhe | Montréal | northamerica-northeast1 |
|
| Americhe | Stati Uniti (multiregione) | us * |
us (più regioni) * |
| Europa | Belgio | europe-west1 |
eu (più regioni) |
| Europa | Londra | europe-west2 |
|
| Europa | Francoforte | europe-west3 |
|
| Asia Pacifico | Singapore | asia-southeast1 |
|
| Asia Pacifico | Tokyo | asia-northeast1 |
|
| Asia Pacifico | Mumbai | asia-south1 |
|
| Asia Pacifico | Sydney | australia-southeast1 |
|
| Globale | Multiregione globale (pubblicazione a livello globale, dati at-rest negli Stati Uniti) | global (opzione preferita) o nessuna regione (predefinita) ¶ |
global (più regioni) ¶ |
| Simbolo | Descrizione |
|---|---|
| * | Vertex AI non supporta la località multiregione "us". Di conseguenza, l'utilizzo delle funzionalità di IA generativa di Agent Assist nella regione multipla "us" si baserà sui rispettivi endpoint esistenti per una singola regione degli Stati Uniti. |
| ¶ | Le chiamate alla regione global potrebbero avere una latenza più elevata se effettuate da paesi diversi dagli Stati Uniti. Se possibile, preferisci una regione più specifica più vicina ai tuoi servizi e utenti. |
Funzionalità disponibili per la pubblicazione a livello regionale
| ID regione | Riepilogo con sezioni personalizzate v3.1/3.0 | Riepilogo con sezioni personalizzate v2.1 | Riepilogo con sezioni personalizzate v2.0/1.0 | Analisi del sentiment | Assistente generativo di conoscenze (proattivo) |
|---|---|---|---|---|---|
us-central1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us-east1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us-west1 |
✓ | ✓ | ✓ | ✓ | ✓ |
us |
✓ | ✓ | ✓ | ✓ | |
northamerica-northeast1 |
✓ | ✓ | ✓ | ✓ | |
europe-west1 |
✓ | ✓ | ✓ | ✓ | |
europe-west2 |
✓ | ✓ | ✓ | ✓ | |
europe-west3 |
✓ | ✓ | ✓ | ✓ | |
asia-southeast1 |
✓ | ✓ | ✓ | ✓ | |
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 a riposo. Ad esempio:
- Knowledge base e documenti di conoscenza.
- Profili di conversazione.
- Cronologie di conversazioni e messaggi.
- Partecipanti alla conversione.
- Suggerimenti restituiti da Agent Assist.
- Feedback.
Limitazioni
Si applicano le seguenti limitazioni:
- La console Agent Assist non supporta ancora la regionalizzazione. Puoi implementare la regionalizzazione solo chiamando direttamente l'API.
- L'addestramento del modello non supporta la regionalizzazione. I tuoi dati potrebbero essere instradati al di fuori della regione durante questa procedura.
API Explorer, disponibile in molti documenti di riferimento REST, supporta solo la regione
globalper le chiamate API.Al momento, Trascrizione di CCAI supporta solo i dati in uso e at-rest relativi a più regioni (se non utilizzi la funzionalità di adattamento vocale) nell'UE, negli Stati Uniti e in Nord America (Canada).
Per gli archivi di dati, utilizzati dalla funzionalità di assistenza della conoscenza generativa (proattiva), sono supportate solo le seguenti regioni:
global,usmulti-regione eeumulti-regione.
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, 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 del servizio su:
REGION_ID-dialogflow.googleapis.com. Imposta il nome della risorsa con la posizione 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 altro
passaggio prima di poter chiamare un endpoint regionalizzato. Devi impostare
l'ambito su https://www.googleapis.com/auth/cloud-platform quando generi
le tue credenziali di autenticazione. 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.