Ce document explique les termes et concepts clés liés à Agent Registry.
Compétence A2A
Comparer avec les compétences.
Bloc de métadonnées de capacité déclarative représenté de manière intégrée dans la carte d'agent d'un agent
Agent Card
(agent-card.json). Les compétences A2A décrivent les interfaces de communication entre agents
et les capacités de haut niveau d'un agent compatible A2A agent.
Agent Registry est compatible avec les versions 0.3 et 1.0 de la spécification Agent2Agent (A2A).
Agent
Acteur autonome de votre écosystème d'IA, défini par son identifiant et les compétences A2A ou les compétences spécifiques qu'il possède.
Identifiant d'agent
Nom immuable et unique au niveau mondial de l'agent. Cet identifiant logique fournit une référence stable permettant aux consommateurs d'appeler l'agent, qui reste constante quelles que soient les modifications apportées à l'infrastructure sous-jacente.
Les identifiants d'agent sont générés automatiquement par Agent Registry lors de l'ingestion et suivent un format URN (Uniform Resource Name). Le format exact dépend de l'endroit où l'agent est déployé. Voici quelques exemples :
- Agent Runtime sur Gemini Enterprise Agent Platform:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID - Services Cloud Run:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME - Déploiements GKE:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME - Gemini Enterprise:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root - Google Workspace:
urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a - Agents enregistrés manuellement:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID
Compte principal de l'agent
Identifiant Identity and Access Management (IAM) unique attribué à un agent, lui permettant de disposer d'autorisations et d'être audité. Il prend la forme d'un compte de service vérifiable Google Cloud ou d'une identité de charge de travail gérée, telle qu'un ID SPIFFE, lié à un agent ou serveur.
Étant donné que cette identité est directement liée à la ressource de calcul de l'environnement d'exécution de l'agent, la chaîne principale intègre le chemin d'accès exact à cette ressource sous-jacente. Par exemple, un compte principal d'agent pour un déploiement d'Agent Runtime sur Gemini Enterprise Agent Platform se présente comme suit :
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
Agent Registry affiche cette identité en tant qu'attribut en sortie uniquement lorsque vous affichez les détails d'un agent.
Composant agentif
Entité modulaire et fonctionnelle au sein d'un écosystème d'IA qu'Agent Registry vous permet d'enregistrer, de découvrir et de gouverner. Le registre classe les composants agentifs en quatre types principaux : les agents, les serveurs MCP, les points de terminaison, et les compétences.
Workflow agentif
Séquence d'étapes dans laquelle un agent IA détermine indépendamment l'utilisation des outils, le raisonnement et les chemins d'exécution pour accomplir une tâche.
Fournisseur d'authentification
Configuration dans le gestionnaire d'authentification des identités d'agent permettant de stocker, d'acquérir et de gérer des identifiants, tels que des clés API ou des jetons OAuth, pour connecter votre agent à des outils et applications externes spécifiques, et définir le type d'authentification.
Liaison
Connexion entre un agent source et une ressource cible, telle qu'un autre agent, un serveur MCP ou un point de terminaison. En créant des liaisons, vous établissez des relations explicites qui permettent à vos agents orchestrateurs d'interagir avec les capacités en aval. Les liaisons sont également utilisées pour associer un agent à un fournisseur d'authentification afin de prendre en charge les autorisations déléguées.
Ressource de données
Contexte de données ou ensemble de données spécifique exposé par un serveur MCP auquel un agent peut accéder pour fonder ses réponses ou informer ses actions.
Discovery
Processus d'interrogation du registre pour trouver des agents, des outils MCP ou des points de terminaison existants en fonction de descriptions, de tags ou de compétences.
La découverte dans Agent Registry se concentre sur les capacités axées sur la consommation que vos orchestrateurs d'IA peuvent utiliser. Vous découvrez les capacités déjà enregistrées pour créer et orchestrer des systèmes d'IA.
Ce processus dans Agent Registry diffère de la découverte d'infrastructure, comme dans App Hub, qui identifie les ressources de calcul non enregistrées dans vos Google Cloud projets.
Point de terminaison
Pour l'API Agent Registry, ressource qui représente une URL cible, généralement une API REST, à laquelle 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 services externes auxquels un agent peut accéder.
Protocole MCP (Model Context Protocol)
Norme ouverte utilisée pour connecter des modèles d'IA à des sources de données et à des outils, en remplacement des plug-ins personnalisés.
Serveur MCP (ou serveur)
Service qui implémente le protocole MCP (Model Context Protocol) pour fournir des outils et des ressources de données standardisés aux agents IA.
Identifiant de serveur MCP
Nom de ressource uniforme (URN) immuable et unique au niveau mondial pour un serveur MCP. Comme pour les identifiants d'agent, ce nom fournit une référence stable pour découvrir des ensembles d'outils spécifiques.
Le format dépend du fait qu'il s'agisse d'un service Google intégré ou d'un serveur externe enregistré. Voici quelques exemples :
- Google Cloud Serveurs MCP à distance:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME - Serveurs MCP enregistrés manuellement:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID
Inscription
Processus d'ajout d'un composant agentif, tel qu'un agent, un serveur MCP ou un point de terminaison, au registre. Agent Registry fournit les mécanismes d'inscription suivants :
- Inscription automatique : ingestion automatique des ressources d'IA compatibles Google Cloud , comme dans Agent Runtime. L'inscription automatique s'effectue dans le champ d'application d'un seul projet.
- Inscription manuelle : intégration manuelle de composants agentifs personnalisés ou externes, ou d'agents déployés sur plusieursprojets Google Cloud pour une découverte et une gouvernance centralisées.
URI de ressource
Emplacement d'exécution physique ou infrastructure qui héberge un agent ou serveur MCP. L'identifiant de ressource uniforme (URI) est la séquence unique de caractères qui identifie cette ressource d'exécution. Par exemple, un URI de ressource peut être un point de terminaison Agent Runtime, un déploiement Google Kubernetes Engine (GKE) ou un service Cloud Run.
L'URI de ressource diffère de l'identifiant d'agent ou de l'identifiant de serveur MCP. Ces valeurs sont les noms uniques au format URN qui identifient vos agents et serveurs MCP dans le registre. En revanche, l'URI de ressource pointe vers la ressource de calcul réelle sur laquelle l'agent ou le serveur s'exécute.
Le chemin d'accès à l'URI de ressource d'un agent est intégré à la chaîne principale de l'agent pour identifier de manière unique cette ressource dans les stratégies IAM. Pour les inscriptions inter-projets, l'URI de ressource fait référence au projet dans lequel réside la ressource de calcul.
Agent Registry affiche cet URI en tant qu'attribut en sortie uniquement lorsque vous affichez les détails d'un agent.
Vous pouvez utiliser l'URI de ressource pour créer des requêtes dans le graphique de topologie
afin de
visualiser les flux de trafic et les relations pour des agents spécifiques. Dans l'API Agent Registry, cette valeur est représentée par l'attribut agentregistry.googleapis.com/system/RuntimeReference.
Service
Pour l'API Agent Registry, ressource accessible en écriture utilisée pour enregistrer manuellement des composants agentifs personnalisés ou
externes dans le registre. Un Service représente un agent, un serveur MCP ou un point de terminaison qui est ajouté manuellement à votre registre. Vous créez et gérez une ressource Service pour définir le point de terminaison et les métadonnées des composants agentifs qu'Agent Registry n'ingère pas automatiquement.
En fonction de la spécification que vous fournissez, Agent Registry projette automatiquement ce Service côté consommateur en tant que ressource Agent, McpServer ou Endpoint en lecture seule pour la découverte.
Vous utilisez toujours la ressource Service pour créer, modifier ou supprimer des entrées de registre. Toutefois, pour obtenir, lister ou rechercher ces entrées, vous interrogez les ressources Agent, McpServer ou Endpoint en lecture seule.
Compétence
Comparer avec les compétences A2A.
Package exécutable autonome enregistré en tant que ressource de premier niveau dans
Agent Registry, qui étend les capacités d'un agent en
fournissant des instructions spécifiques, un langage naturel ou du code pour effectuer une tâche.
Les compétences contiennent des fichiers d'instructions (SKILL.md), des scripts d'exécution d'environnement d'exécution et des éléments de métadonnées.
Les compétences sont identifiées par un nom de ressource uniforme (URN). Le format exact dépend de l'éditeur. Voici quelques exemples :
- Compétences créées par Google:
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID. Par exemple,urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing. - Compétences enregistrées manuellement:
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID. Par exemple,urn:skill:projects-123456789:locations:global:private-create-docs.
Les compétences créées par Google sont visibles immédiatement lorsque vous configurez Agent Registry. Toutefois, vous pouvez également enregistrer vos propres compétences. Vous enregistrez les compétences dans Agent Registry en tant que ressources homologues des agents et des serveurs MCP. Chaque compétence comporte une révision par défaut et peut contenir plusieurs révisions de compétence versionnées.
Les administrateurs de plate-forme régissent les compétences en gérant leurs états de cycle de vie et en définissant des pointeurs de version par défaut pour la résolution de l'environnement d'exécution.
Révision de compétence
Instantané immuable et versionné d'un package de compétences. Les révisions vous permettent de mettre à jour les instructions ou le code de la compétence sans modifier l'identifiant de la compétence parent.
Vous pouvez gérer les révisions de compétence pour contrôler les versions de vos compétences.
Éditeur
Entité qui crée et enregistre des compétences dans Agent Registry.
Les éditeurs préremplis incluent les éditeurs Google, tels que cloud.google.com et discoveryengine.googleapis.com, ainsi que les partenaires validés. Les compétences créées par Google à partir de ces éditeurs sont visibles immédiatement lorsque vous configurez Agent Registry.
Les compétences que vous créez sont automatiquement attribuées à l'éditeur par défaut private
. L'ID publié d'une compétence particulière est donc précédé de
private-. Vous ne pouvez pas enregistrer de ressources d'éditeur personnalisées.
Vérifiez et inspectez les détails de l'éditeur pour vos compétences enregistrées.
Outil
Fonction déterministe fournie par un serveur MCP qu'un agent peut appeler.