Modèle de données Agent Registry

Agent Registry classe les composants agentiques de votre écosystème en quatre principaux types de ressources que vous pouvez gérer et découvrir :

  • Agents : acteurs d'IA autonomes qui exécutent des workflows d'IA spécifiques. Un agent comprend ses capacités de workflow en possédant des compétences spécifiques. Dans Agent Registry, les compétences des agents sont représentées sous forme de métadonnées déclaratives (compétences A2A) ou sous forme de package modulaire exécutable (compétences).
  • Serveurs MCP : fournisseurs de ressources de données et d'outils standardisés. Les outils sont des fonctions déterministes exposées par un serveur MCP que les agents peuvent appeler pour effectuer des actions spécifiques.
  • Points de terminaison : URL cibles, généralement des API REST, auxquelles un agent accède. En abstrayant ces destinations en ressources gérables, Agent Registry vous permet de contrôler de manière centralisée les API externes auxquelles vos agents peuvent accéder.
  • Compétences : packages exécutables autonomes d'instructions, de code et de métadonnées gérés directement dans Agent Registry. Les compétences autonomes sont distinctes des compétences A2A, qui sont des manifestes de blocs de métadonnées déclaratives déclarés en ligne dans la carte d'agent d'un agent.

Pour en savoir plus sur ces concepts et d'autres concepts utilisés par Agent Registry, consultez Concepts clés.

Ressources de l'API

L'API Agent Registry sépare les opérations de lecture et d'écriture pour les agents, les points de terminaison et les serveurs MCP :

  • Ressource d'API accessible en écriture : vous gérez ces composants agentiques en créant, en mettant à jour ou en supprimant manuellement une ressource Service dans le registre.
  • Ressource d'API en lecture seule : pour interroger, lister ou rechercher ces composants agentiques, vous demandez la ressource Agent, McpServer ou Endpoint en lecture seule à l'API Agent Registry.

Les compétences autonomes n'utilisent pas le modèle de Service projection. Au lieu de cela, vous gérez, contrôlez les versions et listez les compétences directement à l'aide des ressources d'API Skill, SkillRevision, et Publisher.

Pour commencer, consultez Configurer Agent Registry. Pour en savoir plus sur l'API Agent Registry, consultez la documentation de référence de l'API.

Enregistrer des composants agentiques dans votre registre

Agent Registry gère votre catalogue d'agents et de serveurs MCP via deux mécanismes d'enregistrement : automatique et manuel.

Agent Registry enregistre automatiquement les agents et les serveurs déployés sur les environnements d'exécution Google Cloud pris en charge. Enregistrez et gérez vos agents, serveurs MCP et points de terminaison en activant l'API Agent Registry. Les compétences créées par Google sont également visibles immédiatement lorsque vous configurez Agent Registry.

Vous pouvez également utiliser la ressource Service pour créer, mettre à jour et supprimer des entrées manuellement. Ensuite, vous interrogez les ressources Agent, McpServer ou Endpoint en lecture seule pour obtenir, lister et rechercher respectivement vos agents, serveurs et points de terminaison enregistrés. Pour l'enregistrement manuel et la recherche de compétences, utilisez la ressource Skill.

Mécanisme d'enregistrement Description Composant enregistré Produits compatibles Google Cloud
Enregistrement automatique Vous pouvez configurer et utiliser Agent Registry pour découvrir et ingérer automatiquement des ressources spécifiques déployées sur les environnements d'exécution pris en charge Google Cloud . Pour les agents implémentant le protocole Agent2Agent (A2A) ouvert, le registre extrait également automatiquement leurs compétences et capacités A2A de leur carte d'agent. Agents
Serveurs MCP Serveurs MCP Google et Google Cloud distants officiels
Compétences Les compétences publiques de Google sont détectables à l'échelle mondiale depuis tous les projets
Enregistrement manuel Pour les ressources externes, les composants agentiques personnalisés sur les environnements d'exécution non compatibles ou les agents REST standards qui n'implémentent pas le protocole A2A, vous devez les enregistrer manuellement en créant une ressource Service dans le registre. Pour les compétences autonomes, vous utilisez la ressource Skill. Agents Agents distants
Serveurs MCP Composants agentiques personnalisés sur des environnements d'exécution non compatibles ou des serveurs MCP externes
Compétences Vos propres compétences autonomes

Étape suivante