Régionalisation et résidence des données

Dialogflow assure la résidence des données de manière à conserver physiquement vos données au repos dans une région ou un emplacement. Lorsque vous spécifiez une région, les données au repos ne sont pas répliquées en dehors de cette région. Les tarifs sont identiques pour toutes les régions.

Les régions sont utilisées pour les raisons suivantes :

• Votre système peut être soumis à des exigences réglementaires qui régissent l'emplacement de vos données.
• Les latences réseau peuvent être améliorées lorsque les données se trouvent dans la même région que vos clients. Par exemple, les clients du Royaume-Uni peuvent s'attendre à une meilleure latence s'ils utilisent la région europe-west2.

Remarque :La régionalisation et la résidence des données Dialogflow ne s'appliquent pas aux données en cours d'utilisation ni aux données en transit.

Données au repos

Toutes les données des développeurs et des utilisateurs finaux de Dialogflow sont incluses dans les données au repos. Exemple :

• Toutes les ressources de l'agent définies avec la console ou l'API (intents, entités, etc.)
• Tous les paramètres de l'agent définis avec la console ou l'API
• Historique des requêtes
• Résultats de validation
• Tâches de création de modèle
• Tâches d'entraînement
• Tâches d'opération de longue durée

Régions disponibles

Dialogflow fournit les régions suivantes :

Regroupement de pays	Emplacement géographique.	ID de la région
Europe	Belgique	europe-west1
Europe	Londres	europe-west2
Asie-Pacifique	Sydney	australia-southeast1
Asie-Pacifique	Tokyo	asia-northeast1
International	La diffusion Dialogflow est globale, les données au repos sont disponibles aux États-Unis	global (de préférence) ou aucune région (par défaut) *

Symbole	Description
*	Les appels vers la région global peuvent présenter une latence plus élevée lorsqu'ils sont appelés en dehors des États-Unis. Si possible, privilégiez une région plus spécifique, plus proche de vos services et de vos utilisateurs finaux.

Remarque :Le point de terminaison us-dialogflow.googleapis.com et l'emplacement de la ressource locations/us qui servaient d'alias aux ressources de la région global ont été abandonnés depuis le 21 mai 2024. Pour spécifier correctement la région global, consultez les notes de version.

Sélectionner une région avec la console

En haut à gauche de la console Dialogflow ES, une liste déroulante permet de sélectionner une région. Chaque agent dispose d'une région immuable qui est spécifiée lors de sa création. Lorsque vous sélectionnez une région dans la console, vous pouvez uniquement répertorier ou créer des agents dans cette région. La région par défaut est global.

Remarque :Vous pouvez créer un agent par région pour un projet Google Cloud.

Sélectionner une région avec l'API

Si votre agent a été créé dans une région autre que celle par défaut, vous devez spécifier cette région lorsque vous appelez l'API pour les requêtes d'exécution et lors de la conception.

Pour indiquer une région, vous devez fournir un paramètre location aux requêtes API. Pour les appels REST, effectuez les deux opérations suivantes :

• Fournissez le paramètre de chemin d'URL location. Pour l'emplacement multirégional global, utilisez global.
• Pour l'emplacement multirégional global, utilisez dialogflow.googleapis.com comme nom d'hôte. Pour toutes les autres régions, utilisez [REGION_ID]-dialogflow.googleapis.com comme nom d'hôte.

Exemples :

• https://dialogflow.googleapis.com/v2/projects/PROJECT/locations/global/agents/
• https://asia-northeast1-dialogflow.googleapis.com/v2/projects/PROJECT/locations/asia-northeast1/agents/

Pour les bibliothèques clientes, consultez la documentation de la bibliothèque cliente. Vous devez procéder comme suit :

• Définissez le point de terminaison du service Dialogflow sur l'une des valeurs suivantes:

  dialogflow.googleapis.com:443
  REGION_ID-dialogflow.googleapis.com:443
  

• Définissez le nom de la session sur :

  projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID
  

Attention:Comme décrit dans la documentation de configuration, vous devez utiliser la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS pour fournir des identifiants à vos bibliothèques clientes. Toutefois, si vous devez fournir manuellement un fichier d'identifiants dans votre code, vous devez effectuer une étape supplémentaire lorsque vous appelez un point de terminaison régionalisé. Définissez le champ d'application sur https://www.googleapis.com/auth/cloud-platform lors de la génération de vos identifiants d'authentification. Par exemple, cela est possible dans Java lors de la création d'un objet GoogleCredentials :

GoogleCredentials.fromStream(new FileInputStream("credential_file"))
  .createScoped("https://www.googleapis.com/auth/cloud-platform")
  

Cloud Logging

Consultez le guide Cloud Logging pour contrôler la région dans laquelle les journaux sont stockés.

Limites

Lorsqu'une région autre que celle par défaut est sélectionnée dans la console Dialogflow, les fonctionnalités suivantes ne sont pas disponibles :

• Intégrations
• Connecteurs de connaissances
• Agents prédéfinis
• Small Talk
• Outil d'entraînement

L'explorateur d'API, disponible dans de nombreux documents de référence REST, n'accepte que la région global pour les appels d'API.