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.
Sélectionnez le mécanisme d'enregistrement adapté à vos environnements d'exécution d'agent.
Enregistrement automatique
Les environnements d'exécution compatibles Google Cloud enregistrent vos agents auprès d'Agent Registry dans le 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 les environnements 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. Pour en savoir plus, consultez la section Enregistrer des agents à partir d'Agent Runtime.
- 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. Pour en savoir plus, consultez la section Enregistrer des agents Google intégrés.
- Google Kubernetes Engine : les agents conteneurisés déployés sur Google Kubernetes Engine (GKE) sont enregistrés lorsqu'ils sont configurés avec le libellé de type fonctionnel d'agent d'IA et l'annotation de carte d'agent. Le contrôleur d'environnement d'exécution du cluster GKE exécute l'analyse d'introspection et publie les métadonnées dans Agent Registry. Pour en savoir plus, consultez la section Enregistrer des agents à partir de GKE.
- Cloud Run : les agents conteneurisés déployés sur des services ou des jobs
Cloud Run sont enregistrés lorsqu'ils sont déployés avec les indicateurs de type
fonctionnel et d'identité. Cloud Run enregistre automatiquement le nom, l'URL et le type (
AGENT) de l'agent auprès d'Agent Registry. Pour en savoir plus, consultez la section Enregistrer des agents à partir de Cloud Run.
Les métadonnées et les capacités indexées pour un agent lors de l'enregistrement dépendent de l'implémentation ou non du protocole Agent2Agent (A2A) par l'agent :
- Agents implémentant le protocole A2A : le système interroge la
carte d'agent (
/.well-known/agent-card.json) de l'agent pour extraire automatiquement ses compétences A2A et capacités annoncées dans le catalogue du registre. - Agents n'implémentant pas le protocole A2A (points de terminaison REST ou gRPC standards): le système enregistre l'URL de l'interface et la liaison de transport de l'agent, mais ne peut pas extraire automatiquement les capacités sémantiques. Pour associer des capacités à des points de terminaison non A2A, vous pouvez les décrire à l'aide de l'enregistrement manuel ou les lier à des compétences autonomes et à des serveurs MCP dans une application d'IA.
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 Google Cloud des environnements d'exécution qui ne sont pas compatibles avec la détection automatique ou dans différents Google Cloud projets, vous devez utiliser l'enregistrement manuel.
Pour enregistrer manuellement un agent, 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), comme un point de terminaison d'API REST standard.
Pour savoir comment enregistrer manuellement des agents, consultez la section Utiliser l'enregistrement manuel.
Considérations concernant 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ée et enregistrer les agents déployés dans plusieurs projets de rayons ou de charges 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ée. 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.