Dialogflow fornisce la residenza dei dati per mantenere i dati at-rest fisicamente all'interno di una regione o località geografica. Quando viene specificata una regione, i dati a riposo non vengono replicati al di fuori della regione. I prezzi sono gli stessi per tutte le regioni.
Le regioni vengono utilizzate per i seguenti motivi:
- Il tuo sistema potrebbe avere requisiti normativi o di norme che regolano la posizione in cui devono trovarsi i dati.
- Le latenze di rete possono essere migliorate quando i dati si trovano nella stessa regione dei tuoi clienti.
Ad esempio, se i clienti del Regno Unito utilizzano
europe-west2, possono aspettarsi una latenza migliore.
Dati at-rest
Tutti i dati degli sviluppatori e degli utenti finali di Dialogflow sono inclusi nei dati a riposo. Ad esempio:
- Tutte le risorse dell'agente impostate con la console o l'API (intent, entità e così via)
- Tutte le impostazioni dell'agente impostate con la console o l'API
- Cronologia delle query
- Risultati convalida
- Attività di creazione del modello
- Attività di addestramento
- Attività di operazioni a lunga esecuzione
Aree geografiche disponibili
Dialogflow fornisce le seguenti regioni:
| Raggruppamento dei paesi | Posizione geografica | ID regione |
|---|---|---|
| Europa | Belgio | europe-west1 |
| Europa | Londra | europe-west2 |
| Asia Pacifico | Sydney | australia-southeast1 |
| Asia Pacifico | Tokyo | asia-northeast1 |
| Globale | La pubblicazione di Dialogflow è globale, i dati at-rest si trovano negli Stati Uniti | global (opzione preferita) o nessuna regione (valore predefinito) * |
| Simbolo | Descrizione |
|---|---|
| * | 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 agli utenti finali. |
Selezionare una regione con la console
L'area in alto a sinistra della console Dialogflow ES contiene un menu a discesa per la selezione della regione.
Ogni agente ha una regione immutabile specificata al momento della creazione.
Quando selezioni una regione dalla console,
puoi elencare o creare agenti solo per la regione selezionata.
La regione predefinita è global.
Selezionare una regione con l'API
Se l'agente è stato creato in una regione non predefinita, devi specificare questa regione quando chiami l'API per le richieste di compilazione o di runtime.
Per fornire una regione, fornisci un parametro location alle richieste API.
Per le chiamate REST, esegui entrambe le seguenti operazioni:
- Fornisci il parametro percorso dell'URL
location. Per la regioneglobal, utilizzaglobal. - Per la regione
global, utilizzadialogflow.googleapis.comper il nome host. Per tutte le altre regioni, utilizza[REGION_ID]-dialogflow.googleapis.comper il nome host.
Esempi:
https://dialogflow.googleapis.com/v2/projects/PROJECT/locations/global/agents/https://asia-northeast1-dialogflow.googleapis.com/v2/projects/PROJECT/locations/asia-northeast1/agents/
Per le librerie client, consulta la documentazione delle librerie client. Procedi come segue:
Imposta l'endpoint del servizio Dialogflow su uno dei seguenti valori:
dialogflow.googleapis.com:443 REGION_ID-dialogflow.googleapis.com:443
Imposta il nome della sessione su:
projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID
Cloud Logging
Consulta la guida di Cloud Logging per controllare la regione in cui vengono archiviati i log.
Limitazioni
Quando nella console di Dialogflow è selezionata una regione non predefinita, le seguenti funzionalità non sono disponibili:
L'Explorer API, presente in molti documenti di riferimento REST, supporta solo la regione global per le chiamate API.