Agent Registry verwendet eine standardisierte Terminologie, um die Komponenten, Ressourcen und Governance-Mechanismen in Ihrem KI-Ökosystem zu beschreiben. Wenn Sie diese grundlegenden Konzepte verstehen, können Sie KI-Agenten, MCP-Server, Endpunkte und Skills in Agent Registry registrieren, finden, verbinden und verwalten.
A2A-Skill
Vergleiche mit Skill.
Eine Funktionsbeschreibung, die inline in der agent-card.json
Agentenkarte eines KI-Agenten aufgeführt ist. Ein A2A-Skill beschreibt die Aufgaben, die ein KI-Agent ausführen kann, und seine Kommunikationsschnittstellen, damit andere KI-Agenten wissen, wann und wie sie ihm Aufgaben übertragen können.
Die Agent Registry unterstützt die Versionen 0.3 und 1.0 der Agent2Agent-Spezifikation (A2A). Einen Vergleich mit eigenständigen Skills finden Sie unter Unterschiede zwischen eigenständigen und A2A-Skills.
Agent
Ein autonomer Akteur in Ihrem KI-Ökosystem, der plant, Schlussfolgerungen zieht, Tools aufruft und mit anderen Agenten zusammenarbeitet. Ein Agent wird durch seine Agentenkennung und jeden A2A-Skill oder eigenständigen Skill definiert, den er besitzt. In Agent Registry wird ein registrierter KI-Agent als schreibgeschützte Agent-Erkennungsressource dargestellt.
Agenten-Prinzipal
Die eindeutige IAM-Identität (Identity and Access Management), die einem Agenten zugewiesen wird, damit er Berechtigungen haben, auf nachgelagerte Ressourcen zugreifen und Audit-Logs generieren kann. Sie hat die Form eines überprüfbaren Google Cloud -Dienstkontos oder einer verwalteten Arbeitslastidentität, z. B. einer SPIFFE-ID, die direkt an die Compute-Laufzeit des Agents gebunden ist.
Hauptkontostrings enthalten den Laufzeitreferenzpfad und unterstützen drei Bereiche: die Engine-Instanz, projektweite Hauptkontosätze und organisationsweite Hauptkontosätze.
Eine vollständige Anleitung zur Syntax und Zugriffssteuerung finden Sie unter Agenten-Prinzipale.
Agentische Komponente
Eine modulare, funktionale Entität innerhalb eines KI-Ökosystems, die Sie mit Agent Registry registrieren, erkennen und verwalten können. Die Registry kategorisiert agentische Komponenten in vier Haupttypen: Agent, MCP-Server, Endpunkt und Skill.
Weitere Informationen finden Sie unter Lebenszyklus und Erkennung von Komponenten.
Agentischer Workflow
Eine Abfolge von Schritten, bei denen ein KI-Agent selbstständig die Toolnutzung, die Argumentation und die Ausführungspfade bestimmt, um eine Aufgabe zu erledigen.
Authentifizierungsanbieter
Eine Konfiguration im Agent Identity-Authentifizierungsmanager zum Speichern, Abrufen und Verwalten von Anmeldedaten wie API-Schlüsseln oder OAuth-Tokens, um Ihren KI-Agenten mit externen Tools und nachgelagerten Diensten zu verbinden.
Weitere Informationen zum Binden von Agents an Authentifizierungsanbieter finden Sie unter Komponentenbeziehungen.
Bindung
Eine gerichtete Verbindung zwischen einem Quell-Agenten und einer Zielressource, z. B. einem anderen Agenten, einem MCP-Server oder einem Endpunkt. Bindungen legen explizite Delegierungspfade zwischen Komponenten fest und verknüpfen einen KI-Agenten mit einem Authentifizierungsanbieter für delegierte Berechtigungen.
Weitere Informationen finden Sie unter Bindungen.
Datenressource
Ein bestimmter Datenkontext oder Datensatz, der von einem MCP-Server bereitgestellt wird und auf den ein Agent zugreifen kann, um seine Antworten zu fundieren oder seine Aktionen zu steuern.
Discovery
Der Prozess, bei dem die Agent Registry abgefragt wird, um einen registrierten Agenten, ein MCP-Tool, einen Endpunkt oder einen Skill mithilfe der Suche in natürlicher Sprache, Tags oder Registry-IDs zu finden.
Die Erkennung in Agent Registry konzentriert sich auf die Nutzungserkennung, bei der die Funktionen und Komponenten identifiziert werden, die Ihre Orchestrierungs-Agenten zur Laufzeit aufrufen können. Weitere Informationen finden Sie unter Erkennungstypen.
Endpunkt
Eine Ziel-URL, in der Regel eine REST API, auf die ein Agent zugreift. In der Agent Registry wird ein registrierter Endpunkt als Endpoint-Erkennungsressource mit Lesezugriff dargestellt. So können Sie zentral steuern, auf welche externen Dienste ein Agent zugreifen kann.
Governance-Projekt
Das Google Cloud -Projekt, in dem Sie die Agent Registry API aktivieren, um Ihre agentischen Komponenten zentral zu katalogisieren, zu finden und zu verwalten. Weitere Informationen zu Konfigurationen für einzelne Projekte und projektübergreifende Konfigurationen finden Sie unter Governance-Projekt für eine zentrale Registry definieren.
Governance-Bereich
Die geografische und architektonische Grenze, innerhalb derer Agent Registry-Ressourcen registriert und verwaltet werden.
Agent Registry verwendet ein zentrales Google Cloud Governance-Projekt, in dem Sie die Agent Registry API aktivieren, um Ihre agentischen Komponenten zu katalogisieren und zu verwalten. Bei der automatischen Registrierung werden unterstützte Arbeitslasten erkannt, die in diesem Governance-Projekt bereitgestellt wurden. Wenn Sie Remote-Komponenten verwalten möchten, also KI-Agenten, MCP-Server oder Endpunkte, die außerhalb des Governance-Projekts in separaten Google Cloud -Projekten, lokalen Umgebungen oder externen Clouds gehostet werden, müssen Sie sie manuell in der Registry des Governance-Projekts registrieren.
Wenn die Agent Registry automatisch einen Google- oder Remote-MCP-Server von Google Cloudregistriert, wird die Ressource McpServer nur am Standort global erstellt, nicht in einzelnen Regionen. Sie können KI-Agenten, MCP-Server und Endpunkte manuell registrieren und Bindungen in einer unterstützten regionalen Region oder am Standort global erstellen. Regionale Gateways können Traffic sowohl an regionale Ressourcen als auch an global-MCP-Server weiterleiten und verwalten.
Die vollständigen Regeln für den regionalen Bereich und die Richtlinienanforderungen finden Sie unter Agent Registry-Standorte.
Model Context Protocol (MCP)
Der offene Standard, der verwendet wird, um KI-Modelle mit Datenquellen und Tools zu verbinden und maßgeschneiderte Plug-ins zu ersetzen.
MCP-Server
Ein Programm, das das Model Context Protocol (MCP) implementiert, um einem KI-Agenten standardisierte Tool- und Datenressourcenfunktionen bereitzustellen. In Agent Registry wird ein registrierter MCP-Server als schreibgeschützte McpServer-Erkennungsressource dargestellt.
Publisher
Eine Entität, die einen Skill erstellt und registriert, dargestellt als Publisher-Ressource in der Agent Registry. Ein Publisher legt die Inhaberschaft und die Syntax der Skill-Kennung für einen Skill fest.
Von Google verwaltete Skills verwenden Dienstdomains. Manuell erstellte Skills werden automatisch dem Publisher private mit dem Präfix private- zugewiesen.
Weitere Informationen finden Sie unter Publisher.
Anmeldung
Der Vorgang, bei dem eine agentische Komponente wie ein KI-Agent, ein MCP-Server, ein Endpunkt oder ein Skill zur Agent Registry hinzugefügt wird.
Die Agent Registry unterstützt zwei Registrierungsmodelle:
- Automatische Registrierung: Automatische Aufnahme von KI-Agenten, MCP-Servern und von Google verwalteten Skills aus unterstützten Google Cloud -Laufzeiten, z. B. Agent Runtime auf der Gemini Enterprise Agent Platform, die im Governance-Projekt bereitgestellt werden, in dem die Agent Registry aktiviert ist.
- Manuelle Registrierung: Explizite Registrierung von Remote- oder benutzerdefinierten KI-Agenten, MCP-Servern, Endpunkten und privaten eigenständigen Skills, einschließlich Komponenten, die in separaten Google Cloud -Projekten, lokalen Umgebungen, externen Clouds oder nicht unterstützten Laufzeiten gehostet werden, durch Erstellen von Ressourcen in der Registry des Governance-Projekts.
Einen detaillierten Architekturvergleich finden Sie unter Registrierungsmodelle.
Registry-ID
Ein global eindeutiger, unveränderlicher Uniform Resource Name (URN), den die Agent Registry einer registrierten agentischen Komponente zuweist. Diese Kennung bietet Nutzern und Orchestrierungs-Agents eine stabile Referenz, um Komponenten in der Agent Registry zu finden, zu filtern und zu suchen. Sie bleibt unabhängig von Änderungen an der zugrunde liegenden Infrastruktur oder Codeaktualisierungen konstant.
Ausführliche Informationen zu URN-Syntaxformaten finden Sie unter Registry-IDs.
Laufzeitreferenz
Der physische Laufzeitstandort oder die Compute-Infrastruktur, auf der ein Agent, ein MCP-Server oder ein Endpunkt gehostet wird. In der Agent Registry wird dies durch das Attribut agentregistry.googleapis.com/system/RuntimeReference dargestellt. Eine Laufzeitreferenz kann beispielsweise auf eine Reasoning Engine der Agent Runtime, eine GKE-Bereitstellung (Google Kubernetes Engine) oder einen Cloud Run-Dienst verweisen.
Der Laufzeitreferenzpfad ist für die IAM-Richtlinienbewertung in den Agenten-Prinzipal eingebettet. Weitere Informationen finden Sie unter Laufzeitreferenzen.
Dienstressource
Die beschreibbare Ressource in der Agent Registry, die durch ihren eigenen Ressourcennamen identifiziert wird und die Sie für Verwaltungsvorgänge verwenden, wenn Sie einen Agenten, einen MCP-Server oder einen Endpunkt manuell registrieren. In der Ressource Service werden die Metadaten der Komponente gespeichert, einschließlich des Typs der agentischen Komponente und Konfigurationsdetails wie Schnittstellen-URL, Beschreibung, Protokollbindung und Funktionsspezifikation. Eine automatisch registrierte Komponente oder ein eigenständiger Skill verwendet keine Service-Ressource.
Sie erstellen, aktualisieren oder löschen eine Service-Ressource, um eine manuell registrierte Komponente in Agent Registry zu registrieren, ihre Metadaten zu aktualisieren oder ihre Registrierung aufzuheben, ohne das zugrunde liegende Deployment zu ändern oder zu löschen. Wenn Sie eine Service-Ressource erstellen oder aktualisieren, liest die Agent Registry die Metadaten und erstellt oder aktualisiert automatisch die entsprechende Agent-, McpServer- oder Endpoint-Erkennungsressource. In Agent Registry verwenden Nutzer wie Orchestrator-Agenten, Clientanwendungen und Entwickler diese Erkennungsressourcen mit Lesezugriff, um agentische Komponenten aufzulisten, zu suchen und anzusehen. Weitere Informationen finden Sie unter Darstellung agentischer Komponenten in der Agent Registry.
Skill
Vergleiche mit A2A-Skill.
Ein eigenständiges Paket, das als Skill-Ressource auf oberster Ebene in der Agent Registry registriert ist. Es erweitert die Funktionen eines KI-Agenten, indem es spezifische Anweisungen und optionale Skripts zum Erledigen einer Aufgabe bereitstellt. Ein Skill enthält eine SKILL.md-Anweisungsdatei, optionale Skripts und Metadaten-Assets.
Ein Skill wird durch eine Skill-ID identifiziert, die einem Publisher und einem Standard-Ressourcennamen zugeordnet ist. Jeder Skill hat einen Standard-Versionszeiger und einen oder mehrere versionierte Snapshots, die jeweils als Skill-Version dargestellt werden.
Weitere Informationen zu Architektur, Paketierung und Lebenszyklus finden Sie unter Skills-Architektur.
Skill-Version
Ein unveränderlicher, versionierter Snapshot eines Skill-Pakets, der als SkillRevision-Ressource in der Agent Registry dargestellt wird. Mit einer Skill-Version können Sie Skill-Anweisungen oder optionale Skripts aktualisieren, ohne die übergeordnete Skill-ID zu ändern oder bestehende Agentenabhängigkeiten zu beeinträchtigen.
Weitere Informationen zur Versionsverwaltung und Unveränderlichkeit von Versionen finden Sie unter Skill-Versionen.
Tool
Eine deterministische Funktion, die von einem MCP-Server bereitgestellt wird und von einem Agenten aufgerufen werden kann.