Régionalisation et résidence des données

Agent Assist provides 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 les mêmes 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 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, si les clients belges utilisent europe-west1, ils peuvent s'attendre à une meilleure latence.

Régions disponibles

Regroupement de pays Emplacement géographique. ID de la région ID de la région du datastore
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 global (multirégional)
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
Europe Eemshaven europe-west4 eu (multirégional)
Europe Zurich europe-west6 eu (multirégional)
Asie-Pacifique Singapour asia-southeast1
Asie-Pacifique Jakarta asia-southeast2 global (multirégional)
Asie-Pacifique Tokyo asia-northeast1
Asie-Pacifique Mumbai asia-south1
Asie-Pacifique Sydney australia-southeast1
Monde Multirégional (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 "us". Par conséquent, l'utilisation des fonctionnalités d'IA générative d'Agent Assist dans la région multirégionale "us" s'appuiera sur les points de terminaison régionaux uniques 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écapitulatif avec des sections personnalisées v5.0/4.0 Évaluation automatique du récapitulatif (preview) Analyse des sentiments (v3) Assistant de connaissances génératif (proactif) Créer votre propre assistant (preview) Coach IA
us-central1 ✓ ✓ ✓ ✓ ✓ ✓
us-east1 ✓ ✓ ✓ ✓ ✓
us-west1 ✓ ✓ ✓ ✓ ✓ ✓
us ✓ ✓ ✓ ✓ ✓
northamerica-northeast1 ✓ ✓ ✓ ✓ ✓
europe-west1 ✓ ✓ ✓ ✓ ✓
europe-west2 ✓ ✓ ✓ ✓ ✓
europe-west3 ✓ ✓ ✓ ✓ ✓
europe-west4 ✓ ✓ ✓ ✓ ✓
europe-west6 ✓ ✓ ✓ ✓ ✓
asia-southeast1 ✓ ✓ ✓ ✓ ✓
asia-southeast2 ✓ ✓ ✓ ✓ ✓
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 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.

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

  • CCAI Transcription n'est compatible qu'avec les données multirégionales en cours d'utilisation et les données au repos (si la fonctionnalité d'adaptation vocale n'est pas utilisée) dans l'UE, aux États-Unis et en Amérique du Nord (Canada).

  • Seules les régions suivantes sont compatibles avec les datastores utilisés par la fonctionnalité d'assistant de connaissances génératif (proactif) : 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, vous devez procéder 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'GOOGLE_APPLICATION_CREDENTIALS environnement 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, vous devez effectuer une étape supplémentaire 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.