Modèle de données Agent Registry

Agent Registry organise votre écosystème d'IA en ressources standardisées afin que vous puissiez enregistrer, découvrir et gouverner des agents, des serveurs MCP, des points de terminaison et des compétences. Comprendre comment Agent Registry sépare les ressources Service accessibles en écriture des ressources de découverte en lecture seule, et quels produits sont compatibles avec l'enregistrement automatique et manuel, vous aide à concevoir et à gérer votre registre.

Composants agentiques

Agent Registry vous permet d'enregistrer, de découvrir et de gérer les types de composants d'agent suivants :

  • Agents : acteurs d'IA autonomes qui effectuent des tâches spécifiques, appellent des outils et collaborent avec d'autres agents.
  • Serveurs MCP : programmes qui implémentent le Model Context Protocol (MCP) pour exposer des ressources de données et des 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 transformant ces destinations en ressources gérables, Agent Registry vous permet de gérer de manière centralisée les API externes auxquelles vos agents peuvent accéder.
  • Compétences : fonctionnalités modulaires qui étendent les capacités d'un agent. Les compétences autonomes sont des packages d'instructions et de scripts facultatifs gérés directement dans le registre. Les compétences A2A sont des descriptions de capacités sur la carte d'un agent qui indiquent aux autres agents quand et comment communiquer avec lui. Pour en savoir plus, consultez Architecture des compétences.

Ressources de service et ressources de découverte

La façon dont le registre d'agents représente un composant dépend de son type de composant et de son modèle d'enregistrement. Pour en savoir plus sur le cycle de vie et la découverte des composants, consultez Cycle de vie et découverte des composants.

Agents, serveurs MCP et points de terminaison

Qu'un agent, un serveur MCP ou un point de terminaison soit enregistré automatiquement ou manuellement, Agent Registry le représente en tant que ressource de découverte Agent, McpServer ou Endpoint en lecture seule. Les consommateurs, tels que les agents d'orchestration, les applications clientes et les développeurs, utilisent ces ressources de découverte pour lister, rechercher et afficher les composants enregistrés.

Pour les composants enregistrés automatiquement, Agent Registry ingère les métadonnées directement à partir des environnements d'exécution compatibles et crée la ressource de découverte sans ressource Service.

Lorsque vous enregistrez manuellement un agent, un serveur MCP ou un point de terminaison, Agent Registry sépare les opérations de gestion de la découverte des composants en créant les éléments suivants :

  • Une ressource Service accessible en écriture : stocke les métadonnées du composant, y compris le type de composant agentif, l'URL de son interface, sa description, sa liaison de protocole et sa spécification de capacité. Vous créez, mettez à jour ou supprimez la ressource Service pour les opérations de gestion telles que la mise à jour des métadonnées ou l'annulation de l'enregistrement du composant, sans modifier ni supprimer le déploiement sous-jacent.
  • Une ressource de découverte : lorsque vous créez ou mettez à jour une ressource Service, Agent Registry lit les métadonnées et crée ou met à jour automatiquement une ressource de découverte Agent, McpServer ou Endpoint qui représente le composant dans votre registre.

Les options de spécification que vous utilisez lors de la création d'une ressource 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		 Ressource Agent dans la collection agents Agents REST distants standards ou compatibles avec A2A a2a-agent-card, no-spec
--endpoint-spec-type
--endpoint-spec-content		 Ressource Endpoint dans la collection endpoints API REST cibles externes ou URL de service no-spec
--mcp-server-spec-type
--mcp-server-spec-content		 Ressource McpServer dans la collection mcp-servers Serveurs MCP (Model Context Protocol) externes tool-spec, no-spec

Ces paires d'options s'excluent mutuellement. Spécifier des options de plusieurs paires renvoie une erreur. Si vous spécifiez la paire d'options pour le mauvais type de composant, Agent Registry crée la ressource de découverte dans la collection qui correspond à l'option que vous avez spécifiée. Par exemple, transmettre --agent-spec-type=no-spec lors de l'enregistrement d'un point de terminaison crée une ressource Agent au lieu d'une ressource Endpoint. Par conséquent, les requêtes et les règles de gouvernance spécifiques au type ne s'appliquent pas comme prévu.

Compétences autonomes

Les compétences autonomes n'utilisent pas de ressources Service distinctes. À la place, vous enregistrez, versionnez et interrogez les compétences directement à l'aide des ressources Skill de premier niveau, des ressources enfants SkillRevision et des ressources 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

Agent Registry classe les produits et composants compatibles en fonction de la manière dont ils sont enregistrés : automatiquement ou manuellement.

Enregistrement automatique

Le registre d'agents découvre 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 de leur carte d'agent. Les compétences autonomes gérées par Google sont également visibles dans tous les projets lorsque vous configurez le registre d'agents.

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 compétences gérées par Google sont visibles dans tous les projets.

Enregistrement manuel

Pour les composants distants, qui sont des agents, des serveurs MCP ou des points de terminaison hébergés en dehors de votre projet de gouvernance dans des projets Google Cloud distincts, une infrastructure sur site ou des clouds externes, vous enregistrez manuellement les composants dans le projet de gouvernance à l'aide d'une ressource Service. Vous utilisez également une ressource Service pour enregistrer manuellement des composants sur des environnements d'exécution non compatibles ou des agents qui n'implémentent pas le protocole A2A. Pour les compétences autonomes personnalisées, vous utilisez une ressource Skill.

Le tableau suivant répertorie les produits et composants que vous enregistrez manuellement :

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

Étapes suivantes