Agent Assist assure la résidence des données afin de 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 règles 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 latence plus faible.
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 |
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 mondial (diffusion mondiale, données au repos aux États-Unis) | global (recommandé) 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 existants pour la région unique "us". |
| ¶ | Les appels vers la région global peuvent avoir une latence plus élevée lorsqu'ils sont passé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. |
Fonctionnalités disponibles pour la diffusion régionale
| ID de la région | Agent associé | Synthèse avec des sections personnalisées v6.0/5.0/4.0 | Évaluation automatique de la synthèse | Analyse des sentiments (v3) | Assistance proactive basée sur les connaissances génératives | 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 utilisateurs développeurs et finaux d'Agent Assist sont incluses dans les données au repos. Exemple :
- Bases de connaissances et documents de connaissances.
- Profils de conversation :
- L'historique des conversations et des messages.
- Participants à la conversion.
- Suggestions renvoyées par Agent Assist.
- Feedbacks.
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 pendant ce processus.
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.La transcription CCAI ne prend en charge que les données utilisées et les données au repos (si vous n'employez pas la fonctionnalité d'adaptation vocale) dans les emplacements multirégionaux de l'UE, des États-Unis et d'Amérique du Nord (Canada).
Seules les régions suivantes sont compatibles avec les data stores utilisés par la fonctionnalité d'assistance proactive basée sur les connaissances génératives :
global,us(multirégion) eteu(multirégion).L'ancrage avec la recherche Google (AARG) n'est pas compatible avec la résidence des données (DRZ). Lorsque ce paramètre est activé, il ne s'applique pas aux requêtes de recherche. Pour en savoir plus, consultez Contrôles de sécurité de Gemini Enterprise Agent Platform.
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 :
Indiquez l'ID de région pour le paramètre de chemin d'URL
location.Pour la région
global, utilisezdialogflow.googleapis.compour le nom d'hôte. Pour toutes les autres régions, utilisez[region-id]-dialogflow.googleapis.compour le nom d'hôte.
Exemple :
dialogflow.googleapis.com/v2/projects/project_id/locations/global/knowledgeBases/knowledge_base_idus-central1-dialogflow.googleapis.com/v2/projects/project_id/locations/us-central1/knowledgeBases/knowledge_base_id
Pour utiliser les bibliothèques clientes, vous devez suivre les étapes suivantes :
- Définissez le point de terminaison du service sur
REGION_ID-dialogflow.googleapis.com. Définissez le nom de la ressource avec le bon emplacement, 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.