Importer des agents A2A depuis Agent Registry

En tant qu'administrateur de Gemini Enterprise, vous pouvez ajouter un agent A2A d'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. Le protocole 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é et interrogeable qui sert de source unique de vérité pour découvrir, suivre et gérer les agents A2A, les points de terminaison et les 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 que 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, comme 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.

Connectivité des agents A2A compatibles

La connectivité des agents A2A est compatible avec Agent Gateway dans les configurations de routage et de sécurité suivantes :

  • Routage sur réseau public : le trafic est acheminé sur l'Internet public vers des points de terminaison A2A accessibles de l'extérieur, via une Agent Gateway déployée avec ou sans modèle de connectivité (AgentConnectivityTemplate).

  • Routage sur réseau privé : le trafic est acheminé sur des réseaux VPC internes vers des points de terminaison A2A privés, via une Agent Gateway déployée avec un modèle de connectivité (AgentConnectivityTemplate), une interface Private Service Connect (PSC-I) et l'appairage Cloud DNS.

  • Exigence concernant l'autorité de certification (CA) : dans les scénarios de déploiement public et privé, le point de terminaison de l'agent A2A cible doit utiliser TLS/HTTPS soutenu par une autorité de certification (CA) de confiance publique ou privée. Les points de terminaison qui utilisent une autorité de certification privée ou un certificat autosigné nécessitent une ressource Certificate Manager TrustConfig configurée dans le modèle de connectivité (AgentConnectivityTemplate).

À propos d'Agent Gateway

Agent Gateway est le composant réseau régional géré d'Agent Platform qui agit en tant que contrôleur de trafic et 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 passerelle d'agent 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 Agent Gateway doit être configurée pour être associée à un Agent Registry situé dans une région compatible avec la région opérationnelle de l'application Gemini Enterprise. Cela permet d'éviter les cas de non-respect des conventions de résidence des données. Par exemple, une application Gemini Enterprise créée dans la région US doit utiliser une passerelle d'agent configurée avec un registre d'agents régional US, et non un registre d'agents global.

Pour les applications Gemini Enterprise, l'alignement régional est strictement appliqué via un processus de liaison spécifique :

  • L'application Gemini Enterprise ne doit être liée qu'à une passerelle d'agent située dans l'une des régions autorisées pour cette application.

  • L'Agent Gateway sélectionnée doit être associée à un registre d'agents. Cet Agent Registry doit également se trouver dans la même région que l'Agent Gateway 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 indique 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 us-central1 us-central1
eu europe-west1 europe-west1

Limites

Les limites suivantes s'appliquent lorsque vous importez des agents depuis le registre d'agents :

  • 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é à Agent Gateway.

  • La communication directe entre les 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, comme le serveur MCP personnalisé), ne déclenche pas l'application des règles d'Agent Gateway.

Avant de commencer

Avant de commencer, assurez-vous de remplir les conditions préalables suivantes :

Importer des agents d'Agent Registry dans une application Gemini Enterprise

En important un agent A2A depuis Agent Registry dans votre application Gemini Enterprise, vous pouvez le mettre à la disposition des utilisateurs finaux de l'application.

Console

Pour importer un agent depuis le registre d'agents vers une application Gemini Enterprise, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur le nom de l'application à laquelle vous souhaitez associer un agent A2A.

  3. Cliquez sur Agents.

  4. Cliquez sur + Ajouter un agent.

  5. Dans le volet Choisir un type d'agent, recherchez Agents d'Agent Registry, puis cliquez sur Ajouter.

  6. Recherchez l'agent que vous souhaitez ajouter ou recherchez-le dans la liste des agents du registre d'agents associé à votre Agent Gateway. Sur la fiche de l'agent, cliquez sur Ajouter un agent.

  7. Vérifiez les détails de l'agent, puis cliquez sur Suivant.

  8. Effectuez l'une des opérations suivantes :

    • Si l'agent est accessible au public ou si l'autorisation pour un environnement d'exécution existe déjà, cliquez sur Ignorer et terminer.

    • Sinon, vérifiez ou saisissez les identifiants du fournisseur et les 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 La 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.
      Champs d'application 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 champs d'application lors de l'autorisation de l'utilisateur. Par exemple, https://www.googleapis.com/auth/cloud-platform.

      Lorsque vous spécifiez des champs d'application, tenez compte des points suivants :
      • Fournissez une liste de champs d'application séparés par un espace. Exemple : read write.
      • Assurez-vous que les champs d'application sont suffisants pour permettre à l'utilisateur de se connecter et d'utiliser l'agent.
      Vérification PKCE activée Sélectionnez cette option si la clé de vérification pour l'échange de code est requise par l'agent.
      Utiliser l'authentification HTTP de base Sélectionnez cette option pour envoyer l'ID client et le code secret du client dans l'en-tête HTTP Authorization à l'aide de l'authentification de base, plutôt que dans le corps de la requête de jeton. Certains fournisseurs OAuth exigent cette méthode.

  9. Pour mettre l'agent à la disposition des utilisateurs finaux de l'application, procédez comme suit :

    1. Accédez à l'onglet Autorisations utilisateur de l'agent : Applications > APP_NAME > Agents > AGENT_NAME > Autorisations utilisateur.

    2. Cliquez sur Ajouter un utilisateur.

    3. Dans la boîte de dialogue Ajouter des rôles avec des 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

Avec Agent Gateway, vous pouvez évaluer et appliquer des stratégies de contrôle sémantique et IAM au trafic sortant des agents. Vous pouvez créer des règles de sortie précises pour gérer l'accès d'agent à agent 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 du registre d'agents.

Pour créer et appliquer des règles de gouvernance de sortie aux agents, effectuez l'une des opérations suivantes :

Étapes suivantes