Regionalizzazione e localizzazione dei dati

Dialogflow fornisce la residente dei dati per mantenere i dati at-rest fisicamente all'interno di una regione o località geografica. Quando si specifica una regione, i dati at-rest non vengono replicati all'esterno della regione. Il prezzo è lo stesso per tutte le regioni.

Le regioni vengono utilizzate per i seguenti motivi:

• Il sistema potrebbe prevedere requisiti normativi o normativi che regolano il luogo 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.

Nota: la regionalizzazione e la residenza dei dati di Dialogflow non si applicano ai dati in uso o ai dati in transito.

Dati at-rest

Tutti i dati degli utenti degli sviluppatori e degli utenti finali Dialogflow sono inclusi in data-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 query
• Risultati convalida
• Attività di creazione di modelli
• Attività di addestramento
• Attività operative 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 (predefinita) *

Simbolo	Descrizione
*	Le chiamate verso la regione global potrebbero avere una latenza più elevata se effettuate al di fuori degli Stati Uniti. Preferisci una regione più specifica e più vicina ai tuoi servizi e utenti finali, se possibile.

Nota: l'endpoint us-dialogflow.googleapis.com e la località delle risorse locations/us che fungevano da alias per le risorse della regione global non sono più disponibili dal 21 maggio 2024. Per specificare correttamente la regione global, consulta le note di rilascio.

Seleziona una regione con la console

Nell'area in alto a sinistra della console Dialogflow ES è presente 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.

Nota: puoi creare un agente per regione per un progetto Google Cloud.

Seleziona una regione con l'API

Se l'agente è stato creato in una regione non predefinita, devi specificare tale regione quando chiami l'API per le richieste in fase di progettazione 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 l'area multiregionale global, utilizza global.
• Per la località multiregionale global, utilizza dialogflow.googleapis.com come nome host. Per tutte le altre regioni, utilizza [REGION_ID]-dialogflow.googleapis.com come 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 relativa alle 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
  

Attenzione:come descritto nella documentazione di configurazione, devi utilizzare la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS per fornire le credenziali alle librerie client. Tuttavia, se devi fornire manualmente un file di credenziali nel codice, devi eseguire un passaggio aggiuntivo quando chiami un endpoint regionalizzato. Imposta l'ambito su https://www.googleapis.com/auth/cloud-platform quando generi le credenziali di autenticazione. Ad esempio, questa operazione viene eseguita 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 guida di Cloud Logging per controllare la regione in cui sono archiviati i log.

Limitazioni

Quando nella console Dialogflow viene selezionata una regione non predefinita, le seguenti funzionalità non sono disponibili:

• Integrazioni
• Connettori di conoscenza
• Agenti predefiniti
• Una chiacchierata
• Strumento di addestramento

Explorer API, disponibile in molti documenti di riferimento REST, supporta solo la regione global per le chiamate API.