Régionalisation et résidence des données

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

Spécifier une région est particulièrement utile dans les cas d'utilisation suivants:

  • Votre système est soumis à des exigences réglementaires ou de conformité 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 belges peuvent s'attendre à une meilleure latence s'ils utilisent la région europe-west1.

Régions disponibles

Regroupement de pays Emplacement géographique. ID de la région ID de la région du data store
Amériques Iowa us-central1 us (multirégional)
Amériques Caroline du Sud us-east1
Amériques Oregon us-west1
Amériques Montréal northamerica-northeast1
Amériques États-Unis (multirégional) us * us (multirégional) *
Europe Belgique europe-west1 eu (multirégional)
Europe Londres europe-west2
Europe Francfort europe-west3
Asie-Pacifique Singapour asia-southeast1
Asie-Pacifique Tokyo asia-northeast1
Asie-Pacifique Mumbai asia-south1
Asie-Pacifique Sydney australia-southeast1
Monde Multirégionale mondiale (diffusion mondiale, données au repos aux États-Unis) global (à privilégier) ou aucune région (par défaut) ¶ global (multirégional) ¶
Symbole Description
* Vertex AI n'est pas compatible avec l'emplacement multirégional "États-Unis". Par conséquent, l'utilisation des fonctionnalités d'IA générative d'Agent Assist dans la zone multirégionale "us" reposera sur les points de terminaison régionaux existants aux États-Unis.
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 de vos utilisateurs.

Fonctionnalités disponibles pour la diffusion régionale

ID de la région Résumer avec des sections personnalisées (v3.1/3.0) Analyse des sentiments (Proactif) Generative Knowledge Assist
us-central1 ✓ ✓ ✓
us-east1 ✓ ✓ ✓
us-west1 ✓ ✓ ✓
us ✓ ✓ ✓
northamerica-northeast1 ✓ ✓ ✓
europe-west1 ✓ ✓ ✓
europe-west2 ✓ ✓ ✓
europe-west3 ✓ ✓ ✓
asia-southeast1 ✓ ✓ ✓
asia-northeast1 ✓ ✓ ✓
asia-south1 ✓ ✓ ✓
australia-southeast1 ✓ ✓ ✓
global ✓ ✓ ✓

Données au repos

Toutes les données des développeurs et des utilisateurs finaux d'Agent Assist sont incluses dans les données au repos. Exemple :

Limites

Les limites suivantes s'appliquent :

  • La console Agent Assist n'est pas encore compatible avec la régionalisation. Vous ne pouvez implémenter la régionalisation qu'en appelant directement l'API.
  • L'entraînement de modèle n'est pas compatible avec la régionalisation. Vos données peuvent être acheminées en dehors de la région au cours de ce processus.

  • API Explorer, disponible dans de nombreux documents de référence REST, n'est compatible qu'avec la région global pour les appels d'API.

  • La transcription avec IA conversationnelle n'est actuellement compatible qu'avec les données multirégionales en cours d'utilisation et les données au repos (si vous n'utilisez pas la fonctionnalité d'adaptation de la parole) en Europe, aux États-Unis et en Amérique du Nord (Canada).

  • Seules les régions suivantes sont compatibles avec les magasins de données utilisés par la fonctionnalité d'assistance générative (proactive) : global, us multirégional et eu multirégional.

Spécifier une région à l'aide de l'API

Pour utiliser la régionalisation, vous devez spécifier une région pour chaque requête API.

Champs obligatoires :

  • Fournissez l'ID de région pour le paramètre de chemin d'URL location.

  • Pour la région 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.

Exemple :

  • dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_id

  • us-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id

Pour utiliser les bibliothèques clientes, procédez comme suit:

  • Définissez le point de terminaison du service sur: REGION_ID-dialogflow.googleapis.com.

  • Définissez le nom de la ressource avec l'emplacement approprié, par exemple:

    projects/project_id/locations/region_id/knowledgeBases/knowledge_base_id

Identifiants

Nous vous recommandons d'utiliser la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS pour fournir des identifiants à vos bibliothèques clientes. Pour en savoir plus sur la définition de cette variable, consultez les instructions de configuration de Dialogflow.

Si vous devez fournir des identifiants manuels dans votre code, une étape supplémentaire est requise avant de pouvoir appeler un point de terminaison régionalisé. Vous devez définir le champ d'application sur https://www.googleapis.com/auth/cloud-platform lorsque vous générez vos identifiants d'authentification. L'exemple suivant montre comment procéder 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 la documentation de Cloud Logging pour contrôler la région dans laquelle vos journaux sont stockés.