Dialogflow provides la residenza dei dati per mantenere i dati at-rest fisicamente all'interno di un'area geografica o una località. Quando viene specificata una regione, i dati at-rest 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 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 del Regno Unito utilizzano
europe-west2, possono aspettarsi una latenza migliore.
Dati at-rest
Tutti i dati degli utenti sviluppatori e degli utenti finali di Dialogflow sono inclusi nei dati at-rest. 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 paesi | Posizione geografica | ID regione |
|---|---|---|
| Europa | Belgio | europe-west1 |
| Europa | Londra | europe-west2 |
| Asia Pacifico | Sydney | australia-southeast1 |
| Asia Pacifico | Tokyo | asia-northeast1 |
| Globale | Il servizio Dialogflow è globale, i dati at-rest si trovano negli Stati Uniti | global (preferita) o nessuna regione (predefinita) * |
| Simbolo | Descrizione |
|---|---|
| * | 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 e 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
include 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 la regione quando chiami l'API per le richieste di progettazione 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 del percorso 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 della libreria client. Procedi come segue:
Imposta l'endpoint del servizio Dialogflow su uno dei seguenti:
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 Dialogflow viene selezionata una regione non predefinita, le seguenti funzionalità non sono disponibili:
Explorer API,
disponibile in molti
documenti di riferimento REST,
supporta solo la regione global per le chiamate API.