Ce document explique les termes et concepts clés liés au registre d'agents.
Compétence A2A
Comparer avec les compétences
Description d'une capacité listée en ligne dans la carte d'agent d'un agent (agent-card.json). Les compétences A2A décrivent les tâches qu'un agent peut effectuer et ses interfaces de communication afin que les autres agents sachent quand et comment lui déléguer du travail.
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 compétences spécifiques qu'il possède.
Identifiant de l'agent
Nom de ressource uniforme (URN) immuable et unique au niveau mondial pour un agent. Cet identifiant fournit une référence stable aux consommateurs pour rechercher et appeler l'agent. Il reste constant, quels que soient les changements d'infrastructure sous-jacents ou les mises à jour du code.
Pour en savoir plus sur les formats de syntaxe URN dans les runtimes compatibles, consultez Identifiants d'agent.
Le registre d'agents utilise des identifiants d'agent pour le suivi de l'inventaire, la découverte du registre et le filtrage. Si vous souhaitez régir l'accès et l'authentification dans IAM, utilisez plutôt le principal de l'agent.
Agent principal
Identité IAM (Identity and Access Management) unique attribuée à un agent, lui permettant de détenir des autorisations, d'accéder aux ressources en aval et de générer des journaux d'audit. Il se présente sous la forme d'un compte de service Google Cloud vérifiable ou d'une Workload Identity gérée, telle qu'un ID SPIFFE, directement lié à l'environnement d'exécution de calcul de l'agent.
Les chaînes de comptes principaux intègrent le chemin d'accès aux ressources d'exécution et sont compatibles avec trois niveaux d'application : l'instance de moteur, les ensembles de comptes principaux à l'échelle du projet et les ensembles de comptes principaux à l'échelle de l'organisation.
Pour obtenir des conseils complets sur la syntaxe et le contrôle des accès, consultez Principaux de l'agent.
Composant agentique
Entité fonctionnelle et modulaire au sein d'un écosystème d'IA que le registre d'agents vous permet d'enregistrer, de découvrir et de gouverner. Le registre classe les composants agentiques en quatre types principaux : agents, serveurs MCP, points de terminaison et compétences.
Workflow agentif
Séquence d'étapes dans laquelle un agent 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.
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 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écifiques exposés par un serveur MCP auquel un agent peut accéder pour ancrer ses réponses ou éclairer ses actions.
Discovery
Processus de requête du registre pour trouver des agents, des outils MCP ou des points de terminaison existants en fonction des descriptions, des tags ou des compétences.
La découverte dans le registre d'agents se concentre sur les capacité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 projets Google Cloud .
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, Agent Registry vous permet de contrôler de manière centralisée les services externes auxquels un agent peut accéder.
Identifiant du point de terminaison
Nom de ressource uniforme (URN) immuable et unique au niveau mondial pour un point de terminaison enregistré. Semblable aux identifiants d'agent et aux identifiants de serveur MCP, cet URN fournit une référence de registre stable pour découvrir les destinations d'API cibles. Pour en savoir plus, consultez Identifiants de point de terminaison.
Champ d'application de la gouvernance
Limite géographique et architecturale où les ressources du registre d'agents sont enregistrées et régies.
Les serveurs MCP gérés par Google sont enregistrés exclusivement dans l'emplacement global.
Vous pouvez enregistrer manuellement des agents, des serveurs MCP et des points de terminaison, et créer des liaisons dans une région prise en charge ou dans l'emplacement global. Les passerelles régionales peuvent régir et acheminer le trafic vers les ressources régionales et les serveurs MCP global.
Pour connaître l'ensemble des règles de portée régionale et des exigences du règlement, consultez Emplacements du registre d'agents.
Protocole MCP (Model Context Protocol)
Norme ouverte utilisée pour connecter les 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 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, cet URN fournit une référence stable pour découvrir des ensembles d'outils spécifiques.
Les identifiants de serveur MCP sont des noms logiques utilisés pour la recherche dans le registre et la gestion de l'inventaire. Pour en savoir plus, consultez Identifiants de serveur MCP.
Inscription
Processus d'ajout d'un composant agentique, tel qu'un agent, un serveur MCP ou un point de terminaison, au registre. Agent Registry propose les mécanismes d'enregistrement suivants :
- Enregistrement automatique : ingestion automatique des ressources d'IAGoogle Cloud compatibles, comme dans Agent Runtime. L'enregistrement automatique fonctionne dans le champ d'application d'un seul projet.
- Enregistrement manuel : intégration manuelle de composants agentiques personnalisés ou externes, ou d'agents déployés dans plusieurs projets Google Cloud pour une découverte et une gouvernance centralisées.
Référence d'exécution
Emplacement d'exécution physique ou infrastructure de calcul hébergeant un agent, un serveur MCP ou un point de terminaison, représenté dans l'API Agent Registry par l'attribut agentregistry.googleapis.com/system/RuntimeReference. Par exemple, une référence d'exécution peut pointer vers un moteur de raisonnement Agent Runtime, un déploiement GKE ou un service Cloud Run.
Le chemin d'accès de référence du runtime est intégré à l'entité principale de l'agent pour l'évaluation des règles IAM. Pour en savoir plus, consultez Références d'exécution.
Service
Pour l'API Agent Registry, la ressource accessible en écriture utilisée pour enregistrer manuellement des composants agentiques personnalisés ou externes dans le registre. Service représente un agent, un serveur MCP ou un point de terminaison qui a été 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 agentiques que le Registre d'agents 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 devez interroger les ressources en lecture seule Agent, McpServer ou Endpoint.
Compétence
Comparer avec les skills A2A
Package autonome enregistré en tant que ressource de premier niveau dans le registre d'agents. Il étend les capacités d'un agent en fournissant des instructions spécifiques et des scripts facultatifs pour accomplir une tâche. Les compétences contiennent des fichiers d'instructions (SKILL.md), des scripts facultatifs et des éléments de métadonnées.
Les skills sont identifiés par un nom de ressource uniforme (URN). Le format exact dépend de l'éditeur. Voici quelques exemples :
- Skills créées par Google :
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID. Exemple :urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing. - Compétences enregistrées manuellement :
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID. 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 sœurs des agents et des serveurs MCP. Chaque skill possède une révision par défaut et peut contenir plusieurs révisions de skill avec des numéros de version.
Les administrateurs de plate-forme gèrent 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'exécution.
Révision de la compétence
Il s'agit d'un instantané immuable et versionné d'un package de skill. Les révisions vous permettent de mettre à jour les instructions ou les scripts d'une skill sans modifier l'identifiant de la skill parente.
Vous pouvez gérer les révisions des skills pour contrôler les versions de vos skills.
É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 le registre d'agents.
Les skills que vous créez sont automatiquement attribués à l'éditeur private par défaut. La référence éditeur d'un skill spécifique est donc précédée de private-. Vous ne pouvez pas enregistrer de ressources d'éditeur personnalisées.
Examinez et inspectez les informations sur l'éditeur pour vos skills enregistrées.
Outil
Fonction déterministe fournie par un serveur MCP qu'un agent peut appeler.