L'enregistrement d'un agent le transforme en service détectable. En publiant les compétences de votre agent, vous aidez les autres développeurs et agents d'orchestration de votre organisation à trouver et à réutiliser votre travail, ce qui accélère le développement global de l'IA.
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 environnements d'exécution compatibles enregistrent vos agents dans Agent Registry par défaut ou via une étape de déploiement avec activation. Google Cloud
L'enregistrement automatique est compatible avec les environnements d'exécution suivants : Google Cloud
- Vertex AI Agent Engine : 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 GKE sont enregistrés lorsqu'ils incluent une annotation de type fonctionnel Agent Registry spécifique.
Les métadonnées et les compétences 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 de l'agent 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. Pour fournir ces informations afin que votre agent soit détectable, utilisez l'enregistrement manuel.
Pour en savoir plus sur les environnements d'exécution compatibles avec l'enregistrement automatique, consultez la section Utiliser l'enregistrement automatique. Google Cloud
Enregistrement manuel
Pour les agents hébergés sur des plates-formes externes, sur site ou sur Google Cloud des environnements d'exécution qui ne sont pas compatibles avec la détection automatique, vous devez utiliser l'enregistrement manuel.
Pour enregistrer manuellement un agent, vous utilisez l'API Agent Registry afin de créer une ressource Service qui définit le point de terminaison et la configuration de l'agent. Cette ressource 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 Agent2Agent (A2A)
(
A2A_AGENT_CARD). Le registre analyse leur point de terminaison de carte d'agent (agent-card.json) pour indexer leurs compétences. - 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.