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 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 de nom de ressource uniforme (URN). Le format exact dépend de l'endroit où l'agent est déployé. 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:SERVICE_ID
Compte principal de l'agent
Identifiant 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 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
Agent Registry affiche cette identité en tant qu'attribut en sortie uniquement lorsque vous affichez les détails d'un agent.
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 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é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 ou des outils MCP existants en fonction de descriptions, de tags ou de 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 représentant 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:SERVICE_NAME - Serveurs MCP enregistrés manuellement:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVICE_ID
Inscription
Processus d'ajout d'un service au registre. Agent Registry fournit les mécanismes d'inscription suivants :
- Inscription automatique : ingestion automatique des charges de travail compatibles, par exemple dans Vertex AI Agent Engine. Google Cloud
- Inscription manuelle : intégration manuelle des charges de travail personnalisées ou externes.
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 Vertex AI, un déploiement GKE ou un service Cloud Run.
L'URI de ressource est différent 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.
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 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 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
Capacité de haut niveau possédée par un agent A2A agent. Les compétences sont extraites des cartes d'agent A2A et servent de points de données principaux pour la découverte d'agents.
Outil
Fonction déterministe fournie par un serveur MCP qu'un agent peut appeler.