Dialogflow fornisce residente dei dati per mantenere dati at-rest fisicamente all'interno di un'area una regione o una località. 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 normativi che disciplinano dove devono risiedere 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 utenti sviluppatori e degli utenti finali Dialogflow sono inclusi in 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 sono state configurate con la console o l'API
- Cronologia delle query
- Risultati convalida
- Attività di creazione di modelli
- Attività di addestramento
- Attività di operazioni a lunga esecuzione
Aree geografiche disponibili
Dialogflow fornisce le seguenti regioni:
Raggruppamento per paese | Posizione geografica | ID regione |
---|---|---|
Europa | Belgio | europe-west1 |
Europa | Londra | europe-west2 |
Asia Pacifico | Sydney | australia-southeast1 |
Asia Pacifico | Tokyo | asia-northeast1 |
Globale | La gestione di Dialogflow è globale e i dati at-rest si trovano negli Stati Uniti | global (opzione preferita) o nessuna regione (valore predefinito)* |
Simbolo | Descrizione |
---|---|
* | Le chiamate verso la regione global potrebbero avere una latenza più elevata se effettuate al di fuori degli Stati Uniti. Se possibile, preferisci una regione più specifica più vicina ai tuoi servizi e agli utenti finali. |
Seleziona 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 che viene 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, devi fornire un parametro location
alle richieste API.
Per le chiamate REST, esegui entrambe le seguenti operazioni:
- Fornisci il parametro del percorso dell'URL
location
. Per la regione multiplaglobal
, utilizzaglobal
. - Per la regione multipla
global
, utilizzadialogflow.googleapis.com
per il nome host. Per tutte le altre regioni, utilizza[REGION_ID]-dialogflow.googleapis.com
per 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 di servizio di 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 le Guida di Cloud Logging per controllare la regione in cui sono archiviati i log.
Limitazioni
Quando nella console Dialogflow è selezionata una regione non predefinita, le seguenti funzionalità non sono disponibili:
La
Explorer API,
presenti su molti
documenti di riferimento REST,
supporta solo la regione global
per le chiamate API.