L'enregistrement d'un agent le transforme en composant détectable dans Agent Registry. En publiant les compétences A2A de votre agent, vous aidez les autres développeurs et agents orchestrateurs de votre organisation à trouver et à réutiliser votre travail, ce qui accélère le développement global de l'IA.
Agent Registry s'intègre de manière transparente au
protocole Agent2Agent (A2A) et à ses
spécifications. A2A est une norme ouverte qui permet aux agents de déclarer leurs capacités et leur identité. Agent Registry est compatible avec les versions 0.3 et 1.0 de la spécification A2A. Pour en savoir plus, consultez le
schéma de la carte d'agent.
En fonction de vos environnements d'exécution d'agent, Agent Registry est compatible avec deux mécanismes d'enregistrement principaux : l'enregistrement automatique et l'enregistrement manuel.
Ce document vous aide à choisir le mécanisme d'enregistrement adapté à vos environnements d'exécution d'agent.
Enregistrement automatique
Les Google Cloud environnements d'exécution compatibles enregistrent vos agents dans Agent Registry au sein du même projet, par défaut ou via une étape de déploiement avec activation. L'enregistrement automatique s'effectue au niveau du projet et ne détecte pas automatiquement les agents déployés dans d'autres Google Cloud projets.
L'enregistrement automatique est compatible avec lesenvironnements d'exécution suivants Google Cloud :
- Agent Runtime sur Gemini Enterprise Agent Platform : les agents déployés à l'aide du SDK sont enregistrés sans configuration supplémentaire.
- Agents Google intégrés : les agents fournis directement par Google, tels que les agents Google Workspace et Gemini Enterprise, sont détectables sans aucune configuration.
- Google Kubernetes Engine : les agents conteneurisés déployés sur Google Kubernetes Engine (GKE) sont enregistrés lorsqu'ils incluent une étiquette de type fonctionnel Agent Registry spécifique.
Les métadonnées et les compétences A2A d'un agent capturées lors de son enregistrement dépendent du protocole de l'agent :
- Agents implémentant le protocole Agent2Agent (A2A): A2A est une norme ouverte qui permet aux agents de déclarer leurs capacités et leur identité. Si votre agent implémente ce protocole, Agent Registry extrait automatiquement les compétences A2A de l'agent à partir de sa carte d'agent et remplit le registre.
- Agents n'implémentant pas le protocole A2A : Agent Registry enregistre l' agent, mais ne peut pas capturer automatiquement les métadonnées telles que l'URL d'inférence et les compétences A2A. Pour fournir ces informations afin que votre agent soit détectable, utilisez l'enregistrement manuel.
Pour en savoir plus sur les Google Cloud environnements d'exécution compatibles avec l'enregistrement automatique, consultez la section Utiliser l'enregistrement automatique.
Enregistrement manuel
Pour les agents hébergés sur des plates-formes externes, sur site, sur des Google Cloud environnements d'exécution qui ne sont pas compatibles avec la détection automatique ou sur différents Google Cloud projets, vous devez utiliser l'enregistrement manuel.
Pour enregistrer manuellement un agent, vous utilisez l'API Agent Registry, Google Cloud CLI ou Terraform pour créer une ressource Service qui définit le point de terminaison et la configuration de l'agent. Cette ressource Service accessible en écriture contient également les informations spécifiques de l'agent. Une fois la ressource Service créée, le registre génère une ressource
Agent en lecture seule que vous pouvez utiliser pour la détection.
Vous pouvez enregistrer manuellement deux types d'agents :
- Agents compatibles A2A : agents qui implémentent la spécification A2A
(
A2A_AGENT_CARD). Le registre analyse leur carte d'agent (agent-card.json) point de terminaison pour indexer leurs compétences A2A. - Agents REST standards : agents distants qui n'implémentent pas la spécification A2A (
NO_SPEC), tels qu'un point de terminaison d'API REST standard.
Pour savoir comment enregistrer manuellement des agents, consultez la section Utiliser l'enregistrement manuel.
Considérations relatives à l'enregistrement multiprojets
Si votre organisation utilise une architecture de gouvernance centralisée avec Agent Gateway, vous pouvez déployer une passerelle de sortie Agent-to-Anywhere dans un projet de gouvernance centralisé et enregistrer les agents déployés dans plusieurs projets spoke ou de charge de travail.
Étant donné que l'enregistrement automatique ne détecte que les ressources du projet local, vous devez enregistrer manuellement les agents distants dans le registre du projet de gouvernance centralisé. L'enregistrement multiprojets permet à la passerelle centrale de localiser et de gérer les agents. Pour obtenir des instructions, consultez la section Enregistrer un agent à partir d'un autre projet.
Intégrer des compétences autonomes
Agent Registry vous permet de gérer et de contrôler les compétences autonomes
skills des agents en tant que ressources de premier niveau.
Les compétences autonomes sont enregistrées en tant que Skill ressources dans votre registre,
ce qui permet aux administrateurs d'appliquer des règles d'accès précises et de gérer l'historique des versions
à l'aide des révisions de compétences.
Lorsque vous créez et gérez des agents dans Gemini Enterprise, vous pouvez référencer ces compétences enregistrées pour étendre les capacités de votre agent. Pour savoir comment enregistrer et gérer des compétences autonomes, consultez les sections Enregistrer des compétences et Gérer des compétences.