Ce document explique les termes et concepts clés liés à Agent Registry.
Agent
Acteur autonome de votre écosystème d'IA, défini par son identifiant et les compétences spécifiques qu'il possède.
Identifiant de l'agent
Nom immuable et unique au monde pour l'agent. Cet identifiant logique fournit une référence stable permettant aux consommateurs d'appeler l'agent. Il reste constant, quelles que soient les modifications apportées à l'infrastructure sous-jacente.
Les identifiants d'agent sont générés automatiquement par le registre d'agents lors de l'ingestion et suivent un format URN (Uniform Resource Name). Le format exact dépend de l'emplacement de déploiement de l'agent. Voici quelques exemples :
- Vertex AI Agent Engine :
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
Agent principal
Identifiant IAM unique attribué à un agent, lui permettant de détenir des autorisations et d'être audité. Elle se présente sous la forme d'un compte de service Google Cloudvérifiable ou d'une identité de charge de travail gérée, telle qu'un ID SPIFFE, lié à un agent ou à un serveur.
Étant donné que cette identité est directement liée à la ressource de calcul du runtime de l'agent, la chaîne principale intègre le chemin exact vers cette ressource sous-jacente. Par exemple, un principal d'agent pour un déploiement Vertex AI Agent Engine 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
Le registre d'agents affiche cette identité en tant qu'attribut de sortie uniquement lorsque vous affichez les détails d'un agent.
Workflow agentique
Séquence d'étapes dans laquelle un agent d'IA détermine de manière indépendante 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 les identifiants, tels que les clés API ou les jetons OAuth, pour connecter votre agent à des outils et applications externes spécifiques, et définir le type d'authentification.
Binding
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 d'orchestration d'interagir avec les fonctionnalité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écifiques exposés par un serveur MCP auquel un agent peut accéder pour ancrer ses réponses ou éclairer ses actions.
Discovery
Processus d'interrogation du registre pour trouver des agents ou des outils MCP existants en fonction des descriptions, des tags ou des compétences. La découverte par compétences est disponible pour les agents qui exposent leurs capacités via une carte d'agent, comme ceux qui implémentent le protocole Agent2Agent (A2A).
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 dans des ressources gérables, le registre d'agents 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 les modèles d'IA aux sources de données et aux outils, en remplacement des plug-ins personnalisés.
Serveur MCP (ou serveur)
Service qui implémente le Model Context Protocol (MCP) pour fournir des outils et des ressources de données standardisés aux agents d'IA.
Identifiant du serveur MCP
Nom de ressource uniforme (URN) immuable et unique au niveau mondial pour un serveur MCP. Semblable aux 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 agentique au registre. Le registre d'agents fournit les mécanismes d'enregistrement suivants :
- Enregistrement automatique : ingestion automatique des charges de travail Google Cloudprises en charge, par exemple dans Vertex AI Agent Engine.
- Enregistrement manuel : intégration manuelle des charges de travail personnalisées ou externes.
URI de ressource
Emplacement ou infrastructure d'exécution physique qui héberge un agent ou un serveur MCP. L'URI (Uniform Resource Identifier) 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 Vertex AI, un déploiement GKE ou un service Cloud Run.
L'URI de la ressource diffère de l'identifiant de l'agent ou de l'identifiant du serveur MCP. Ces valeurs sont les noms uniques au format URN qui identifient vos agents et vos 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 principal de l'agent pour identifier de manière unique cette charge de travail dans les règles IAM.
L'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 la 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 charges de travail personnalisées 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 charges de travail que le Registre d'agents n'ingère pas automatiquement.
En fonction de la spécification que vous fournissez, Agent Registry projette automatiquement cette 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 devez interroger les ressources en lecture seule Agent, McpServer ou Endpoint.
Compétence
Capacité de haut niveau possédée par un agent A2A. Les compétences sont extraites des cartes d'agent A2A et servent de points de données principaux pour la découverte des agents.
Outil
Fonction déterministe fournie par un serveur MCP qu'un agent peut appeler.