Régionalisation et paramètres de localisation

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 de cette région, et Dialogflow 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 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 compatibilité des régions avec les différentes intégrations de téléphonie peut varier. Consultez la documentation de chaque intégration.
• Le paramètre Autoriser le ML à corriger l'orthographe est actuellement disponible dans les régions suivantes : us-central1 ,us-east1, us-west1, global.
• La compatibilité avec chaque entité système varie en fonction de la combinaison de régions et de langues. Pour en savoir plus, consultez les limites relatives aux entités système.

• L'analyse des sentiments est actuellement disponible dans les régions suivantes:

  • global (et donc us)
  • asia-southeast1 (en, fr, it, de, es uniquement)
  • europe-west1 (en, fr, it, de, es uniquement)
  • europe-west2 (en, fr, it, de, es uniquement)
  • europe-west3 (en, fr, it, de, es uniquement)
  • northamerica-northeast1 (en, fr, it, de, es uniquement)
  • us-central1
  • us-east1
  • us-west1

• 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.

Régions disponibles

Dialogflow CX accepte les régions suivantes comme emplacement pour les agents :

Regroupement de pays	Emplacement géographique.	ID de la région
Amériques	Iowa	us-central1
Amériques	Montréal	northamerica-northeast1
Amériques	Caroline du Sud	us-east1
Amériques	Oregon	us-west1
Europe	Belgique	europe-west1
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	Diffusion mondiale, données au repos aux États-Unis	global (à privilégier), us ou aucune région (par défaut)

Remarque :Les appels vers la région global peuvent présenter une latence plus élevée lorsqu'ils sont appelés depuis l'extérieur des États-Unis. Si possible, préférez une région plus spécifique et plus proche de vos services et des 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 des entités gouvernementales ou des 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 le projet, et chaque lieu possède ses propres paramètres de localisation. Une fois les paramètres d'un emplacement spécifique 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 projet.

Si vous créez un agent sans modifier les paramètres de localisation, 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 qu'un agent est 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.

Remarque:Actuellement, vous ne pouvez pas modifier les paramètres de localisation avec l'API.

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 région pour le paramètre de chemin d'URL location.

• Utilisez [region-id]-dialogflow.googleapis.com comme nom d'hôte.

Exemple :

• 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.

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, cette opération est effectuée en 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.