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 effectuent des tâches spécifiques, invoquent des outils et collaborent avec d'autres agents.
  • 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 dans des 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 : capacités modulaires qui étendent les possibilités d'un agent. L'Agent Registry fait la distinction entre les compétences autonomes, qui sont des ensembles d'instructions et de scripts facultatifs gérés directement dans le registre, et les compétences A2A, qui sont des descriptions de capacités listées sur la carte d'agent d'un agent et qui indiquent aux autres agents quand et comment communiquer avec lui.

Pour en savoir plus sur ces concepts et d'autres 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 flags de spécification que vous utilisez lorsque vous créez un Service déterminent la collection de ressources en lecture seule qui en résulte :

Options Collection de ressources Cas d'utilisation Valeurs valides
--agent-spec-type
--agent-spec-content		 Agent (agents) Agents distants (agents REST conformes à A2A ou standards) a2a-agent-card, no-spec
--endpoint-spec-type
--endpoint-spec-content		 Endpoint (endpoints) URL de service ou API REST cibles externes no-spec
--mcp-server-spec-type
--mcp-server-spec-content		 McpServer (mcp-servers) Serveurs MCP (Model Context Protocol) externes tool-spec

Ces paires d'indicateurs s'excluent mutuellement. Si vous spécifiez des indicateurs non valides, votre ressource est créée dans la mauvaise collection et peut ne pas fonctionner avec les règles spécifiques au type.

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

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

Produits et composants compatibles

Le registre des agents classe les produits et composants compatibles en fonction de leur enregistrement (automatique ou manuel).

Enregistrement automatique

Le registre d'agents détecte et ingère automatiquement les charges de travailGoogle Cloud compatibles déployées dans votre projet. Pour les agents qui implémentent le protocole ouvert Agent2Agent (A2A), le registre extrait automatiquement leurs compétences et capacités A2A à partir de leur carte d'agent. Les compétences autonomes créées par Google sont également détectables dans le monde entier lorsque vous configurez Agent Registry.

Le tableau suivant liste les produits et composants que le registre d'agents enregistre automatiquement :

Type de composant Produits compatibles
Agents
Serveurs MCP
Compétences Les skills publics de Google sont détectables dans tous les projets.

Enregistrement manuel

Pour les charges de travail personnalisées, les runtimes Cloud externes, l'infrastructure sur site ou les agents qui n'implémentent pas le protocole A2A, vous devez enregistrer manuellement les composants à l'aide de la ressource Service accessible en écriture. Pour les skills autonomes personnalisés, vous utilisez la ressource Skill.

Le tableau suivant liste les produits et composants que vous enregistrez manuellement :

Type de composant Ressources compatibles
Agents Agents à distance déployés sur Compute Engine, Google Kubernetes Engine, Cloud Run, des systèmes sur site ou des clouds externes
Serveurs MCP Composants agentiques personnalisés sur des environnements d'exécution non compatibles ou des serveurs MCP externes
Points de terminaison URL de service ou API REST cibles externes régies en tant que points de terminaison
Compétences Vos propres compétences autonomes créées par votre organisation

Étapes suivantes