Dialogflow fornisce la residenza dei dati per mantenere i tuoi dati at-rest fisicamente all'interno di una regione o località geografica. Quando viene specificata una regione, i dati inattivi 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 in cui 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 di Dialogflow sono inclusi nei dati inattivi. 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
Regioni disponibili
Dialogflow fornisce le seguenti regioni:
| Raggruppamento di 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 (preferito) o nessuna regione (predefinita) * |
| Simbolo | Descrizione |
|---|---|
| * | Le chiamate alla regione global potrebbero avere una latenza maggiore se effettuate al di fuori degli Stati Uniti. Se possibile, scegli una regione più specifica e vicina ai tuoi servizi e 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 quella regione quando chiami l'API per le richieste in fase di progettazione o di runtime.
Per fornire una regione, devi specificare un parametro location nelle richieste API.
Per le chiamate REST, esegui entrambe le seguenti operazioni:
- Fornisci il parametro del 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 di 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 a 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:
L'Explorer API, disponibile in molti documenti di riferimento REST, supporta solo la regione global per le chiamate API.