En tant qu'administrateur de Gemini Enterprise, vous pouvez ajouter un agent A2A depuis Agent Registry à une application Gemini Enterprise.
Vous pouvez appliquer des règles de contrôle des accès au trafic via Agent Gateway. Ces règles vous permettent d'appliquer une gouvernance de sortie pour contrôler le trafic vers les agents.
À propos des agents A2A et d'Agent Registry
Le protocole Agent2Agent (A2A) est un protocole de communication ouvert et un langage universel pour les agents. Il permet aux agents de différents créateurs et plates-formes de se découvrir, de collaborer et de déléguer des tâches de manière sécurisée.
Agent Registry est un catalogue centralisé, interrogeable qui sert de source unique de référence pour la découverte, le suivi et la gestion des agents A2A, des points de terminaison et des serveurs MCP.
Les agents A2A du registre peuvent être des agents personnalisés créés par vous et vos collègues, et déployés sur différents environnements d'exécution tels qu'Agent Runtime sur Gemini Enterprise Agent Platform, Cloud Run ou Google Kubernetes Engine (GKE). Ces agents peuvent également être des agents intégrés à nos produits Google, tels que Google Workspace.
Vous pouvez associer les agents d'Agent Registry à vos applications Gemini Enterprise pour les mettre à la disposition des utilisateurs finaux de l'application.
À propos d'Agent Gateway
Agent Gateway est le composant de mise en réseau régional géré d'Agent Platform qui fait office de contrôleur de trafic et de point d'application des règles d'exécution pour les agents A2A, les serveurs MCP et les points de terminaison. Il sécurise et gère la connectivité entre les clients et les agents A2A, les agents A2A et les outils de backend, ou les agents A2A et d'autres agents.
Avant de pouvoir associer des agents A2A à vos applications Gemini Enterprise, vous devez configurer une Agent Gateway via laquelle le trafic des agents peut être acheminé. Consultez la section Avant de commencer ci-dessous.
Contraintes régionales pour le registre, la passerelle et l'application
Pour garantir la conformité avec les exigences de résidence des données, les ressources Agent Registry et Agent Gateway sont spécifiques au projet et à la région.
Une passerelle d'agent doit être configurée pour être associée à un registre d'agents situé dans une région compatible avec la région opérationnelle de l'application Gemini Enterprise. Cela évite les violations des conventions de résidence des données. Par exemple, une application Gemini Enterprise créée dans la région des États-Unis doit utiliser une Agent Gateway configurée avec un Agent Registry régional des États-Unis, et non un registre global.
Pour les applications Gemini Enterprise, l'alignement régional est strictement appliqué via un processus d'association spécifique :
L'application Gemini Enterprise ne doit être associée qu'à une Agent Gateway située dans l'une des régions autorisées pour cette application.
La passerelle d'agent sélectionnée doit être associée à un registre d'agents. Ce registre d'agents doit également être situé dans la même région spécifique que la passerelle d'agent et l'application.
Cela signifie que les trois composants (application, passerelle et registre) doivent être alignés au niveau régional. Le tableau ci-dessous fournit les mappages de régions spécifiques :
| Emplacement de l'application Gemini Enterprise | Emplacement de la passerelle d'agent | Emplacement d'Agent Registry |
|---|---|---|
global |
us-central1 |
us-central1, us ou global |
us |
us-central1 |
us-central1 ou us |
eu |
europe-west1 |
europe-west1 ou eu |
Limites
Les limites suivantes s'appliquent lorsque vous importez des agents depuis Agent Registry :
Vous ne pouvez découvrir et importer des agents depuis Agent Registry que si le registre est associé à l'Agent Gateway configuré pour votre application Gemini Enterprise.
Vous ne pouvez appliquer des règles de gouvernance qu'aux agents résidant dans le registre unique associé à l'Agent Gateway.
La communication directe entre des agents Gemini Enterprise, ou entre un agent Gemini Enterprise et un connecteur de données Gemini Enterprise (y compris les connecteurs basés sur MCP tels que le serveur MCP personnalisé) ne déclenche pas l'application des règles de la passerelle d'agent.
Avant de commencer
Avant de commencer, assurez-vous d'avoir rempli les conditions préalables suivantes :
Vous disposez du rôle Gemini Enterprise Administrateur.
Vous avez configuré une passerelle pour acheminer le trafic des agents via Agent Gateway. Pour en savoir plus, consultez Acheminer le trafic Gemini Enterprise via Agent Gateway.
Importer des agents depuis Agent Registry vers une application Gemini Enterprise
L'importation d'un agent A2A depuis Agent Registry dans votre application Gemini Enterprise vous permet de mettre l'agent à la disposition des utilisateurs finaux de l'application.
Console
Pour importer un agent depuis Agent Registry vers une application Gemini Enterprise, procédez comme suit :
Dans la Google Cloud console, accédez à la Gemini Enterprise page.
Cliquez sur le nom de l'application à laquelle vous souhaitez associer un agent A2A.
Cliquez sur Agents.
Cliquez sur + Ajouter un agent, puis sur Ajouter pour Agent personnalisé via Agent Runtime.
Recherchez l'agent que vous souhaitez ajouter, puis cliquez sur Ajouter un agent.
Vérifiez les détails de l'agent, puis cliquez sur Suivant.
Effectuez l'une des opérations suivantes :
Si l'agent est disponible publiquement ou si une autorisation pour un environnement d'exécution existe déjà, cliquez sur Ignorer et terminer.
Sinon, examinez ou saisissez les identifiants du fournisseur et informations supplémentaires, puis cliquez sur Terminer.
Champ Description ID client Identifiant unique de l'application OAuth que vous avez enregistrée auprès de votre fournisseur d'identité pour représenter Gemini Enterprise. Code secret du client Clé confidentielle associée à l'application OAuth que vous avez enregistrée auprès de votre fournisseur d'identité pour représenter Gemini Enterprise. URL d'autorisation URL que les utilisateurs utilisent pour autoriser Gemini Enterprise à accéder à l'agent. Par exemple, https://accounts.google.com/o/oauth2/v2/auth?client_id=123...abc.apps.googleusercontent&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Foauth-redirect&oauth-redirect&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent.URL du jeton Point de terminaison utilisé pour échanger le code d'autorisation contre un jeton d'accès. Par exemple, si l'agent est hébergé par Google, l'URL du jeton est https://oauth2.googleapis.com/token.Niveaux d'accès Autorisations qui définissent les actions que Gemini Enterprise peut effectuer au nom d'un utilisateur ou les données auxquelles il peut accéder. Gemini Enterprise demande ces niveaux d'accès lors de l'autorisation de l'utilisateur. Par exemple, https://www.googleapis.com/auth/cloud-platform.
Lorsque vous spécifiez des niveaux d'accès, tenez compte des points suivants :- Saisissez une liste de niveaux d'accès séparés par un espace. Exemple :
read write. - Assurez-vous que les niveaux d'accès sont suffisants pour permettre à l'utilisateur de se connecter et d'utiliser l'agent.
Vérification PKCE activée Sélectionnez cette option si l'agent nécessite une clé de vérification pour l'échange de code. - Saisissez une liste de niveaux d'accès séparés par un espace. Exemple :
Pour mettre l'agent à la disposition des utilisateurs finaux de l'application, procédez comme suit :
Accédez à l'onglet Autorisations utilisateur de l'agent : Applications > APP_NAME > Agents > AGENT_NAME > Autorisations utilisateur.
Cliquez sur Ajouter un utilisateur.
Dans la boîte de dialogue Ajouter des rôles d'autorisations utilisateur à l'agent , attribuez le rôle Utilisateur de l'agent à un utilisateur, à un groupe ou à tous les utilisateurs.
Configurer et appliquer des règles de gouvernance de sortie
À l'aide d'Agent Gateway, vous pouvez évaluer et appliquer des règles de contrôle sémantique et IAM policies au trafic sortant des agents. Vous pouvez créer des règles de sortie précises pour gérer l'accès entre les agents pour vos agents A2A.
Vous définissez des règles d'autorisation et de refus qui limitent l'accès d'un agent à des entrées spécifiques dans Agent Registry.
Pour créer et appliquer des règles de gouvernance de sortie aux agents, effectuez l'une des opérations suivantes :