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 :
- 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
Principal de l'agent
Identifiant unique de Identity and Access Management (IAM) 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 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 gérer. Le registre classe les composants agentifs en trois types principaux : les agents, les serveurs MCP et les points de terminaison.
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, 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 fonctionnalités axées sur la consommation que vos orchestrateurs d'IA peuvent utiliser. Vous découvrez les fonctionnalité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'enregistrement suivants :
- Enregistrement automatique : ingestion automatique des ressources d'IA compatibles, comme dans Agent Runtime. Google Cloud
- Enregistrement manuel : intégration manuelle de composants agentifs personnalisés 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 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.
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
Capacité de haut niveau possédée par un agent. Les compétences sont extraites
des cartes d'agent Agent2Agent (A2A) et servent de points de données principaux pour la découverte d'agents
.
Agent Registry est compatible avec les versions 0.3 et 1.0 de la spécification A2A.
Outil
Fonction déterministe fournie par un serveur MCP qu'un agent peut appeler.