Agent Registry utilise une terminologie standardisée pour décrire les composants, les ressources et les mécanismes de gouvernance de votre écosystème d'IA. Comprendre ces concepts fondamentaux vous aide à enregistrer, découvrir, connecter et gérer les agents, les serveurs MCP, les points de terminaison et les compétences dans Agent Registry.
Compétence A2A
Comparez avec la compétence.
Description d'une capacité listée de manière intégrée dans la agent-card.json
fiche d'agent d'un agent. Une compétence A2A décrit 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). Pour une comparaison avec les compétences autonomes, consultez Différences entre les compétences autonomes et A2A.
Agent
Acteur autonome de votre écosystème d'IA qui planifie, raisonne, appelle des outils et collabore avec d'autres agents. Un agent est défini par son identifiant d'agent et par chaque compétence A2A ou compétence autonome qu'il possède. Dans Agent Registry, un agent enregistré est représenté sous la forme d'une ressource de découverte Agent en lecture seule.
principal d'agent
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 prend la forme d'un compte de service vérifiable Google Cloud 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 de la référence d'exécution et sont compatibles avec trois champs d'application : l'instance du moteur, les ensembles de comptes principaux à l'échelle du projet et les ensembles de comptes principaux à l'échelle de l'organisation.
Pour obtenir des instructions complètes sur la syntaxe et le contrôle des accès, consultez Principaux d'agent.
Composant agentique
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 agentiques en quatre types principaux : agent, serveur MCP, point de terminaison et compétence.
Pour en savoir plus, consultez Cycle de vie et découverte des composants.
Workflow agentique
Séquence d'étapes au cours desquelles 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 Agent Identity pour stocker, acquérir et gérer des identifiants, tels que des clés API ou des jetons OAuth, afin de connecter votre agent à des outils externes et à des services en aval.
Pour en savoir plus sur la liaison d'agents à des fournisseurs d'authentification, consultez Relations entre les composants.
Liaison
Connexion dirigée entre un agent source et une ressource cible, telle qu'un autre agent, un serveur MCP ou un point de terminaison. Les liaisons établissent des chemins de délégation explicites entre les composants et associent un agent à un fournisseur d'authentification pour les autorisations déléguées.
Pour en savoir plus, consultez Liaisons.
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 ancrer ses réponses ou éclairer ses actions.
Discovery
Processus d'interrogation d'Agent Registry pour trouver un agent, un outil MCP, un point de terminaison ou une compétence enregistrés à l'aide de la recherche en langage naturel, de tags ou d'identifiants de registre.
La découverte dans Agent Registry se concentre sur la découverte de la consommation, qui identifie les fonctionnalités et les composants que vos agents d'orchestration peuvent appeler au moment de l'exécution. Pour en savoir plus, consultez Types de découverte.
Point de terminaison
URL cible, généralement une API REST, à laquelle un agent accède. Dans le registre d'agents, un point de terminaison enregistré est représenté sous la forme d'une ressource de découverte Endpoint en lecture seule, ce qui vous permet de gérer de manière centralisée les services externes auxquels un agent peut accéder.
Projet de gouvernance
Le projet Google Cloud dans lequel vous activez l'API Agent Registry pour cataloguer, découvrir et gérer de manière centralisée vos composants agentifs. Pour en savoir plus sur les configurations à projet unique et multiprojet, consultez Définir le projet de gouvernance pour un registre central.
Champ d'application de la gouvernance
Limite géographique et architecturale où les ressources du registre d'agents sont enregistrées et régies.
Agent Registry utilise un projet de gouvernance Google Cloudcentralisé, dans lequel vous activez l'API Agent Registry pour cataloguer et gérer vos composants agentifs. L'enregistrement automatique détecte les charges de travail compatibles déployées dans ce projet de gouvernance. Pour gérer les composants distants (agents, serveurs MCP ou points de terminaison) hébergés en dehors du projet de gouvernance dans des projets Google Cloud , des environnements sur site ou des clouds externes distincts, vous devez les enregistrer manuellement dans le registre du projet de gouvernance.
Lorsque Agent Registry enregistre automatiquement un serveur MCP distant Google ou Google Cloud, il crée la ressource McpServer uniquement dans l'emplacement global, et non dans des régions individuelles. Vous pouvez enregistrer manuellement des agents, des serveurs MCP et des points de terminaison, et créer des liaisons, dans un emplacement régional pris 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 champ d'application régional et des exigences des règles, consultez Emplacements du registre d'agents.
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 sur mesure.
Serveur MCP
Programme qui implémente le protocole MCP (Model Context Protocol) pour exposer des fonctionnalités d'outil et de ressource de données standardisées à un agent IA. Dans Agent Registry, un serveur MCP enregistré est représenté sous la forme d'une ressource de découverte McpServer en lecture seule.
Éditeur
Entité qui crée et enregistre une compétence, représentée par une ressource Publisher dans Agent Registry. Un éditeur établit la propriété et la syntaxe de l'identifiant de compétence pour une compétence.
Les compétences gérées par Google utilisent des domaines de service. Les compétences créées manuellement sont automatiquement limitées à l'éditeur private avec un préfixe private-.
Pour en savoir plus, consultez Éditeurs.
Inscription
Processus d'ajout d'un composant agentique, tel qu'un agent, un serveur MCP, un point de terminaison ou une compétence, à Agent Registry.
Agent Registry accepte deux modèles d'enregistrement :
- Enregistrement automatique : ingestion automatique des agents, des serveurs MCP et des compétences gérées par Google à partir des environnements d'exécution Google Cloud compatibles, tels que l'environnement d'exécution de l'agent sur Gemini Enterprise Agent Platform, déployés dans le projet de gouvernance où Agent Registry est activé.
- Enregistrement manuel : enregistrement explicite d'agents distants ou personnalisés, de serveurs MCP, de points de terminaison et de compétences autonomes privées, y compris de composants hébergés dans des projets Google Cloud distincts, des environnements sur site, des clouds externes ou des environnements d'exécution non compatibles, en créant des ressources dans le registre du projet de gouvernance.
Pour une comparaison architecturale détaillée, consultez Modèles d'enregistrement.
Identifiant du registre
Nom de ressource uniforme (URN) unique et immuable que le registre d'agents attribue à un composant d'agent enregistré. Cet identifiant fournit une référence stable permettant aux consommateurs et aux agents d'orchestration de découvrir, de filtrer et de rechercher des composants dans Agent Registry. Il reste constant, quelles que soient les modifications apportées à l'infrastructure sous-jacente ou les mises à jour du code.
Pour connaître les formats de syntaxe URN détaillés, consultez Identifiants de registre.
Référence de l'environnement 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 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 Google Kubernetes Engine (GKE) ou un service Cloud Run.
Le chemin d'accès de référence de l'environnement d'exécution est intégré au principal d'agent pour l'évaluation de la stratégie IAM. Pour en savoir plus, consultez Références d'exécution.
Ressource de service
Ressource accessible en écriture dans Agent Registry, identifiée par son propre nom de ressource, que vous utilisez pour les opérations de gestion lorsque vous enregistrez manuellement un agent, un serveur MCP ou un point de terminaison. La ressource Service stocke les métadonnées du composant, y compris le type de composant agentif et les détails de configuration tels que l'URL de son interface, sa description, sa liaison de protocole et sa spécification de capacité. Un composant enregistré automatiquement ou une compétence autonome n'utilise pas de ressource Service.
Vous créez, mettez à jour ou supprimez une ressource Service pour enregistrer, mettre à jour les métadonnées ou annuler l'enregistrement d'un composant enregistré manuellement dans Agent Registry sans modifier ni supprimer le déploiement sous-jacent. Lorsque vous créez ou mettez à jour une ressource Service, Agent Registry lit les métadonnées et crée ou met à jour automatiquement la ressource de découverte Agent, McpServer ou Endpoint correspondante. Dans Agent Registry, les consommateurs, tels que les agents orchestrateurs, les applications clientes et les développeurs, utilisent ces ressources de découverte en lecture seule pour lister, rechercher et afficher les composants agentifs. Pour en savoir plus, consultez Représentation des composants agentiques dans le registre d'agents.
Compétence
Comparez avec la compétence A2A.
Package autonome enregistré en tant que ressource Skill de premier niveau dans le registre d'agents, qui étend les capacités d'un agent en fournissant des instructions spécifiques et des scripts facultatifs pour effectuer une tâche. Une compétence contient un fichier d'instructions SKILL.md, des scripts facultatifs et des éléments de métadonnées.
Une compétence est identifiée par un identifiant de compétence limité par un éditeur et un nom de ressource standard. Chaque compétence gère un pointeur de révision par défaut et possède un ou plusieurs instantanés avec gestion des versions, chacun représenté sous la forme d'une révision de compétence.
Pour en savoir plus sur l'architecture, l'empaquetage et le cycle de vie, consultez Architecture des compétences.
Révision de la compétence
Un instantané immuable et versionné d'un package de compétence, représenté par une ressource SkillRevision dans Agent Registry. Une révision de compétence vous permet de mettre à jour les instructions de compétence ou les scripts facultatifs sans modifier l'identifiant de compétence parent ni rompre les dépendances d'agent existantes.
Pour en savoir plus sur la gestion des versions et l'immuabilité des révisions, consultez Révisions de compétences.
Outil
Fonction déterministe fournie par un serveur MCP qu'un agent peut appeler.