L'enregistrement d'un agent le transforme en composant détectable dans le registre d'agents. En publiant les compétences 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.
En fonction de vos runtimes d'agent, le registre d'agents 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 runtimes d'agent.
Enregistrement automatique
Les runtimes Google Cloud compatibles enregistrent vos agents auprès du registre d'agents par défaut ou via une étape de déploiement facultative.
L'enregistrement automatique est compatible avec les runtimes 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 enregistré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 fiche 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 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 ou sur des runtimes Google Cloudqui ne prennent pas en charge la découverte 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 modifiable 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 Agent2Agent (A2A) (
A2A_AGENT_CARD). Le registre analyse leur point de terminaison Carte d'agent (agent-card.json) pour indexer leurs compétences. - 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.