Lorsque vous créez un agent, vous devez spécifier une région comme emplacement de l'agent. Les requêtes envoyées à votre agent sont gérées par les services Google dans cette région, et Dialogflow conserve physiquement les données au repos dans la région ou l'emplacement géographique. Pour des performances optimales, vous devez choisir une région proche de vos services et de vos utilisateurs finaux.
Une fois l'agent créé, son emplacement ne peut pas être modifié. Pour modifier l'emplacement d'un agent, vous devez l'exporter puis le restaurer dans un nouvel agent situé dans un autre emplacement.
Chaque emplacement est associé à des paramètres qui s'appliquent à l'ensemble de votre projet. Dans la plupart des cas, il n'est pas nécessaire de modifier ces paramètres de localisation. Les paramètres par défaut fonctionnent correctement. Si votre système requiert des clés de chiffrement gérées par le client (souvent requises par des entités administratives ou des secteurs réglementés), lisez la documentation sur les paramètres de localisation.
Limites
Les limites suivantes s'appliquent :
La prise en charge régionale des différentes intégrations téléphoniques peut varier. Consultez la documentation de chaque intégration.
La compatibilité des entités système diffère pour chaque langue. Pour en savoir plus, consultez les limites applicables aux entités système.
APIs Explorer, disponible dans de nombreux documents de référence REST, n'accepte que la région
globalpour les appels d'API.
Régions disponibles
Dialogflow CX est disponible dans les régions suivantes pour l'emplacement de l'agent. Les agents de data store sont compatibles avec un sous-ensemble de ces régions, et les ID de région utilisés par les data stores diffèrent légèrement des régions de l'agent. Toutes les régions dont la colonne "ID de région du data store" contient une valeur sont compatibles avec les agents de datastore dans Vertex AI Conversation.
| Regroupement de pays | Emplacement géographique. | ID de la région de l'agent | ID de la région du data store |
|---|---|---|---|
| Amériques | Iowa | us-central1 |
us (multirégional) |
| Amériques | Montréal | northamerica-northeast1 |
|
| Amériques | Caroline du Sud | us-east1 |
|
| Amériques | Oregon | us-west1 |
|
| Amériques | Multirégion des États-Unis | us * |
us (multirégional) * |
| Europe | Belgique | europe-west1 |
eu (multirégional) |
| Europe | Londres | europe-west2 |
|
| Europe | Francfort | europe-west3 |
|
| Asie-Pacifique | Sydney | australia-southeast1 |
|
| Asie-Pacifique | Tokyo | asia-northeast1 |
|
| Asie-Pacifique | Mumbai | asia-south1 |
|
| Asie-Pacifique | Singapour | asia-southeast1 |
|
| Mondial | Emplacement multirégional mondial (diffusion mondiale, données au repos aux États-Unis) | global (de préférence) ou aucune région (par défaut) ¶ |
global (multirégional) ¶ |
| Symbole | Description |
|---|---|
| * | Vertex AI n'est pas compatible avec l'emplacement multirégional "us". Par conséquent, l'utilisation des fonctionnalités d'IA générative de Dialogflow CX dans l'emplacement multirégional "us" repose sur les points de terminaison américains uniques existants. |
| ¶ | 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. |
Pour en savoir plus sur les régions utilisées par Google Cloud, consultez les pages emplacements Google Cloud et zones géographiques et régions Google Cloud.
Paramètres de localisation
Si votre système nécessite des clés de chiffrement gérées par le client (souvent requises par les organismes gouvernementaux ou les secteurs réglementés), vous pouvez utiliser les paramètres de localisation pour configurer cette fonctionnalité.
Les paramètres d'emplacement sont partagés entre le projet, et chaque emplacement unique possède ses propres paramètres d'emplacement. Une fois que les paramètres d'un emplacement spécifique sont configurés pour un projet, ils ne peuvent plus être modifiés pour cet emplacement. Si vous devez modifier ces paramètres, vous devez créer un autre projet.
Si vous créez un agent sans modifier les paramètres d'emplacement, les paramètres par défaut seront configurés pour cet emplacement et ne pourront pas être modifiés pour le projet. De plus, une fois l'agent créé, son emplacement ne peut plus changer. Pour modifier l'emplacement d'un agent, vous devez l'exporter puis le restaurer dans un nouvel agent situé dans un autre emplacement.
Les paramètres de localisation suivants sont disponibles :
- Chiffrement : ce paramètre contrôle si les clés de chiffrement servant à protéger les données sont gérées par Google ou par le client. Par défaut, les clés utilisées sont gérées par Google. Vous devez demander l'accès (en contactant votre représentant Google) à la fonctionnalité clés de chiffrement gérées par le client pour modifier ce paramètre.
Vous pouvez configurer les paramètres de localisation de deux manières :
- Cliquez sur Paramètres de localisation dans l'interface du sélecteur d'agent.
- Cliquez sur le bouton Modifier à côté de la liste déroulante Emplacement lors de la création de l'agent.
Spécifier une région avec l'API
Vous devez spécifier une région pour toutes les requêtes API.
Pour les appels REST, vous devez effectuer les deux opérations suivantes :
Indiquez l'ID de la région pour le paramètre de chemin d'URL
location.Pour l'emplacement multirégional
us, utilisezusa-dialogflow.googleapis.compour le nom d'hôte. Pour toutes les autres régions, utilisez[region-id]-dialogflow.googleapis.comcomme nom d'hôte.
Exemple :
usa-dialogflow.googleapis.comt/projects/{PROJECT_ID}/locations/us/agents/{AGENT_ID}us-central1-dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/us-central1/agents/{AGENT_ID}
Pour plus d'informations sur les options de configuration des régions dans les bibliothèques clientes, consultez la documentation des bibliothèques clientes.
Vous trouverez des exemples dans le guide de démarrage rapide de l'API.
Cloud Logging
Consultez le guide Cloud Logging pour contrôler la région dans laquelle les journaux sont stockés.