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.
Le registre d'agents s'intègre parfaitement 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é. L'Agent Registry est compatible avec les versions 0.3 et 1.0 de la spécification A2A. Pour en savoir plus, consultez la section Schéma de la fiche d'agent.
En fonction de vos Agent Runtimes, 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 runtimes d'agent.
Enregistrement automatique
Les environnements d'exécution Google Cloud compatibles enregistrent vos agents auprès d'Agent Registry dans le même projet, par défaut ou via une étape de déploiement facultative. L'enregistrement automatique fonctionne au niveau du projet et ne détecte pas automatiquement les agents déployés dans d'autres projets Google Cloud.
L'enregistrement automatique est compatible avec les runtimes 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 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 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 fiche d'agent. Le contrôleur 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 Enregistrer des agents depuis 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 et le type de l'agent (
AGENT) dans l'Agent Registry. Pour en savoir plus, consultez Enregistrer des agents depuis 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 ses 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 registre d'agents enregistre l'agent, mais ne peut pas capturer automatiquement les métadonnées telles que l'URL du point de terminaison, l'identité de l'agent et les compétences A2A. Pour associer des fonctionnalités à des agents non A2A, utilisez l'enregistrement manuel ou l'enregistrement des compétences.
Pour en savoir plus sur les runtimes Google Cloud qui prennent en charge l'enregistrement automatique, consultez Utiliser l'enregistrement automatique.
Enregistrement manuel
Pour les agents hébergés sur des plates-formes externes, sur site, sur des runtimes Google Cloud qui ne sont pas compatibles avec la découverte automatique ou dans différents projetsGoogle Cloud , vous devez utiliser l'enregistrement manuel.
Pour enregistrer manuellement un agent, utilisez l'API Agent Registry, la 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 à l'agent. Une fois le Service créé, le registre génère une ressource Agent en lecture seule que vous pouvez utiliser pour la découverte.
Vous pouvez enregistrer manuellement deux types d'agents :
- Agents conformes à A2A : agents qui implémentent la spécification A2A (
A2A_AGENT_CARD). Le registre analyse leur point de terminaison Agent Card (agent-card.json) pour indexer leurs compétences A2A. - Agents REST standards : agents à distance 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 Utiliser l'enregistrement manuel.
Points à prendre en compte pour 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 charge de travail ou rayons.
É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 central. L'enregistrement multiprojets permet à la passerelle centrale de localiser et de gouverner les agents. Pour obtenir des instructions, consultez Enregistrer un agent provenant 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 des agents en tant que ressources de premier niveau.
Les compétences autonomes sont enregistrées en tant que ressources Skill 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 faire référence à 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 Enregistrer des compétences et Gérer des compétences.