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
.
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 |
Mondial | La diffusion Dialogflow est globale, les données au repos sont disponibles aux États-Unis | global (option recommandée) ou aucune région (par défaut) * |
Symbole | Description |
---|---|
* | Les appels vers la région global peuvent avoir une latence plus élevée s'ils proviennent de l'extérieur des États-Unis. Si possible, choisissez une région plus spécifique, plus proche de vos services et de vos utilisateurs finaux. |
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
.
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
. - Utilisez le nom d'hôte propre à l'emplacement du formulaire
REGION_ID-dialogflow.googleapis.com
. Exemple :asia-northeast1-dialogflow.googleapis.com
. Si l'emplacement spécifié dans le nom d'hôte ne correspond pas à celui du chemin de l'URL, la requête est rejetée.
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 :
REGION_ID-dialogflow.googleapis.com:443
Définissez le nom de la session sur :
projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID
Exemple :
REST
Avant d'utiliser les données de requête, effectuez les remplacements suivants:
- PROJECT_ID : ID de votre projet Google Cloud
- REGION_ID : ID de région, par exemple
europe-west2
- SESSION_ID : un ID de session
Méthode HTTP et URL :
POST https://REGION_ID-dialogflow.googleapis.com/v2/projects/PROJECT_ID/locations/REGION_ID/agent/sessions/SESSION_ID:detectIntent
Corps JSON de la requête :
{ "query_input": { "text": { "text": "I want a pony.", "language_code": "en-US" } } }
Pour envoyer votre requête, développez l'une des options suivantes :
Java
Pour vous authentifier auprès de Dialogflow, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour vous authentifier auprès de Dialogflow, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Langages supplémentaires
C# : suivez les instructions de configuration de C# sur la page des bibliothèques clientes, puis consultez la documentation de référence de Dialogflow pour .NET.
PHP : suivez les instructions de configuration de PHP sur la page des bibliothèques clientes, puis consultez la documentation de référence de Dialogflow pour PHP.
Ruby : suivez les instructions de configuration de Ruby sur la page des bibliothèques clientes, puis consultez la documentation de référence de Dialogflow pour Ruby.
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 :
APIs Explorer, disponible dans de nombreux documents de référence REST, n'accepte que la région global
pour les appels d'API.