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écifique. 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 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 (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 de région unique 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, privilégiez 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 | Récapitulatif avec des sections personnalisées v6.0/5.0/4.0 | Évaluation automatique des résumés | Analyse des sentiments (v3) | Assistance générative (proactive) | Créer votre propre assistance (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 :
- Bases de connaissances et documents de base de connaissances.
- Profils de conversation.
- Historiques 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 n'est 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 vocale) dans l'UE, aux États-Unis et en Amérique du Nord (Canada).
Seules les régions suivantes sont compatibles avec les data stores utilisés par la fonctionnalité d'assistance générative (proactive) :
global,us(multirégional) eteu(multirégional).L'ancrage avec la recherche Google (GWGS) n'est pas compatible avec la résidence des données (DRZ). Lorsque cette option est activée, ce contrôle ne s'applique pas aux requêtes de recherche. Pour en savoir plus, consultez la section 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 :
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/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, les étapes suivantes sont requises :
- 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.