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 traitées par les services Google dans cette région et Dialogflow CX conserve les données au repos physiquement 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 configuration système requise 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), consultez la section Paramètres de localisation.
Limites
Les limites suivantes s'appliquent :
La prise en charge des régions pour les différentes intégrations de téléphonie peut varier. Consultez la documentation de chaque intégration.
La prise en charge des entités système diffère pour chaque langue. Pour en savoir plus, consultez les limites des entités système.
L' explorateur d'API, disponible dans de nombreux documents de référence REST, n'est compatible qu'avec la région
globalpour les appels d'API.
Régions disponibles
Dialogflow CX est compatible avec les régions suivantes pour l'emplacement des agents. Les agents de datastore sont également compatibles avec les régions listées dans le tableau suivant, mais les identifiants de la région utilisés par les datastores diffèrent légèrement des régions d'agent (comme indiqué). Tous les emplacements pour lesquels une valeur est saisie dans la colonne ID de région du datastore sont compatibles avec les agents de data store dans Vertex AI Agents.
| Regroupement de pays | Emplacement géographique. | ID de région de l'agent | ID de région du datastore |
|---|---|---|---|
| Amériques | Iowa | us-central1 |
us (multirégional) |
| Amériques | Montréal | northamerica-northeast1 |
global (multirégional) |
| Amériques | Caroline du Sud | us-east1 |
us (multirégional) |
| Amériques | Oregon | us-west1 |
us (multirégional) |
| Amériques | États-Unis (multirégional) | us * |
us (multirégional) |
| Europe | Belgique | europe-west1 |
eu (multirégional) |
| Europe | Londres | europe-west2 |
eu (multirégional) |
| Europe | Francfort | europe-west3 |
eu (multirégional) |
| Europe | Pays-Bas | europe-west4 |
eu (multirégional) |
| Europe | Zurich | europe-west6 |
eu (multirégional) |
| Asie-Pacifique | Sydney | australia-southeast1 |
global (multirégional) |
| Asie-Pacifique | Tokyo | asia-northeast1 |
global (multirégional) |
| Asie-Pacifique | Mumbai | asia-south1 |
global (multirégional) |
| Asie-Pacifique | Singapour | asia-southeast1 |
global (multirégional) |
| Asie-Pacifique | Jakarta | asia-southeast2 |
global (multirégional) |
| Monde | Multirégional (diffusion mondiale, données au repos aux États-Unis) | global (préféré) ou aucune région (par défaut) ¶ |
global (multirégional) ¶ |
| Symbole | Description |
|---|---|
| * | Pour les modèles Gemini 2.x, Vertex AI n'est pas compatible avec les emplacements multirégionaux us ni eu. Par conséquent, l'utilisation des fonctionnalités d'IA générative de Dialogflow CX dans les régions multirégionales us ou eu repose sur les points de terminaison à région unique existants aux États-Unis ou dans l'UE, respectivement. Pour les modèles Gemini 3 et versions ultérieures (tels que gemini-3.1-flash-lite), les emplacements multirégionaux us et eu sont compatibles et utilisés pour les régions des États-Unis et d'Europe. Pour en savoir plus, consultez la section Quotas génératifs. |
| ¶ | Les appels vers la région global peuvent présenter une latence plus élevée lorsqu'ils sont effectués en dehors des États-Unis. Si possible, préférez 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 entités gouvernementales ou les secteurs réglementés), vous pouvez utiliser les paramètres de localisation pour configurer cette fonctionnalité.
Les paramètres de localisation sont partagés dans l'ensemble du projet, et chaque emplacement unique possède ses propres paramètres de localisation.
Une fois les paramètres d'un emplacement spécifique configurés pour un projet, une ressource immuable
dialogflow.googleapis.com/LocationSettings
est créée, et les paramètres
ne peuvent plus être modifiés pour cet emplacement. Si vous devez modifier ces paramètres ou supprimer la ressource, vous devez créer un projet.
Si vous devez autoriser les développeurs de votre organisation à configurer des agents uniquement dans des emplacements spécifiques, vous pouvez configurer une règle d'administration incluant une contrainte d'emplacement des ressources.
Si vous créez un agent sans modifier les paramètres de localisation, les paramètres par défaut sont configurés pour cet emplacement et ne peuvent pas être modifiés pour le projet. De plus, 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.
Les paramètres de localisation suivants sont disponibles :
- Chiffrement: ce paramètre contrôle si les clés de chiffrement gérées par Google ou les clés de chiffrement gérées par le client sont utilisées pour protéger les données. 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 d'un 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 :
Fournissez l'ID de région pour le paramètre de chemin d'URL
location.Pour la région
global, utilisezdialogflow.googleapis.comcomme nom d'hôte. Pour toutes les autres régions, utilisez[region-id]-dialogflow.googleapis.comcomme nom d'hôte.
Exemple :
dialogflow.googleapis.com/projects/{PROJECT_ID}/locations/global/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.