Datenmodell der Agent Registry

In Agent Registry werden Agentenkomponenten Ihres Ökosystems in vier Hauptressourcentypen unterteilt, die Sie verwalten und finden können:

• Agenten: Autonome KI-Akteure, die bestimmte KI-Workflows ausführen. Ein Agent kennt seine Workflow-Funktionen, weil er bestimmte Skills besitzt. In Agent Registry werden Agenten-Skills als deklarative Metadaten (A2A-Skills) oder als modulares, ausführbares Paket (Skills) dargestellt.
• MCP-Server: Anbieter von standardisierten Datenressourcen und Tools. Tools sind deterministische Funktionen, die von einem MCP-Server bereitgestellt werden und die Agenten aufrufen können, um bestimmte Aktionen auszuführen.
• Endpunkte: Ziel-URLs, in der Regel REST APIs, auf die ein Agent zugreift. Indem diese Ziele in verwaltbare Ressourcen abstrahiert werden, können Sie mit Agent Registry zentral steuern, auf welche externen APIs Ihre Agenten zugreifen können.
• Skills: Eigenständige, ausführbare Pakete mit Anleitungen, Code und Metadaten, die direkt in Agent Registry verwaltet werden. Eigenständige Skills unterscheiden sich von A2A-Skills, die Manifeste für deklarative Metadatenblöcke sind, die inline in der Agentenkarte eines Agenten deklariert werden.

Weitere Informationen zu diesen und anderen Konzepten, die in Agent Registry verwendet werden, finden Sie unter Schlüsselkonzepte.

API-Ressourcen

Die Agent Registry API trennt Lese- und Schreibvorgänge für Agenten, Endpunkte und MCP-Server:

• Schreibbare API-Ressource: Sie verwalten diese Agentenkomponenten, indem Sie in der Registry manuell eine Service-Ressource erstellen, aktualisieren oder löschen.
• Schreibgeschützte API-Ressource:Wenn Sie diese Agentenkomponenten abfragen, auflisten oder suchen möchten, fordern Sie die schreibgeschützte Ressource Agent, McpServer oder Endpoint von der Agent Registry API an.

Die Spezifikationsflags, die Sie beim Erstellen eines Service verwenden, bestimmen die resultierende schreibgeschützte Ressourcensammlung:

Flags	Ressourcensammlung	Anwendungsfall	Zulässige Werte
--agent-spec-type --agent-spec-content	Agent (agents)	Remote-Agenten (A2A-konforme oder Standard-REST-Agenten)	a2a-agent-card, no-spec
--endpoint-spec-type --endpoint-spec-content	Endpoint (endpoints)	Externe Ziel-REST-APIs oder Dienst-URLs	no-spec
--mcp-server-spec-type --mcp-server-spec-content	McpServer (mcp-servers)	Externe MCP-Server (Model Context Protocol)	tool-spec

Diese Flag-Paare schließen sich gegenseitig aus. Wenn Sie ungültige Flags angeben, wird Ihre Ressource in der falschen Sammlung erstellt und funktioniert möglicherweise nicht mit typspezifischen Richtlinien.

Für eigenständige Skills wird das Service Projektionsmodell nicht verwendet. Stattdessen verwalten, versionieren und listen Sie Skills direkt mit den API-Ressourcen Skill, SkillRevision und Publisher auf.

Informationen zu den ersten Schritten finden Sie unter Agent Registry einrichten. Weitere Informationen zu der Agent Registry API finden Sie in der API-Referenzdokumentation.

Agentenkomponenten in Ihrer Registry registrieren

Agent Registry verwaltet Ihren Katalog von Agenten und MCP-Servern über zwei Registrierungsmechanismen: automatisch und manuell.

Agent Registry registriert automatisch Agenten und Server, die in unterstützten Google Cloud Laufzeitumgebungen bereitgestellt werden. Aktivieren Sie die Agent Registry API, um Ihre Agenten, MCP-Server und Endpunkte zu registrieren und zu verwalten. Von Google erstellte Skills sind auch sofort sichtbar, wenn Sie Agent Registry einrichten.

Außerdem können Sie die Ressource Service verwenden, um Einträge manuell zu erstellen, zu aktualisieren und zu löschen. Anschließend fragen Sie die schreibgeschützten Ressourcen Agent, McpServer oder Endpoint ab, um Ihre registrierten Agenten, Server bzw. Endpunkte abzurufen, aufzulisten und zu suchen. Verwenden Sie die Ressource Skill für die manuelle Registrierung und Suche von Skills.

Registrierungsmechanismus	Beschreibung	Registrierte Komponente	Unterstützte Google Cloud Produkte
Automatische Registrierung	Sie können Agent Registry so konfigurieren und verwenden, dass bestimmte Ressourcen, die in unterstützten Google Cloud Laufzeitumgebungen bereitgestellt werden, automatisch erkannt und aufgenommen werden. Bei Agenten, die das offene Agent2Agent-Protokoll (A2A) implementieren, werden die A2A-Skills und -Funktionen auch automatisch aus der Agentenkarte extrahiert.	Agenten	Agent Runtime auf der Gemini Enterprise Agent Platform Google Workspace Gemini Enterprise Google Kubernetes Engine-Deployments (GKE) einschließlich eines bestimmten Labels für den Funktionstyp Cloud Run Arbeitslasten, die mit einem bestimmten Flag für den Funktionstyp konfiguriert wurden
		MCP-Server	Offizielle Google- und Google Cloud Remote-MCP-Server Google Kubernetes Engine Deployments, einschließlich eines bestimmten Labels für den Funktionstyp Cloud Run Dienste, die mit einem bestimmten Flag für den Funktionstyp konfiguriert wurden
		Skills	Die öffentlichen Skills von Google sind in allen Projekten weltweit auffindbar.
Manuelle Registrierung	Für externe Ressourcen, benutzerdefinierte Agentenkomponenten in nicht unterstützten Laufzeitumgebungen oder Standard-REST-Agenten, die das A2A Protokoll nicht implementieren, müssen Sie sie manuell registrieren, indem Sie in der Registry eine Service Ressource erstellen. Für eigenständige Skills verwenden Sie die Ressource Skill.	Agenten	Remote-Agenten
		MCP-Server	Benutzerdefinierte Agentenkomponenten in nicht unterstützten Laufzeitumgebungen oder externe MCP-Server
		Skills	Ihre eigenen eigenständigen Skills

Nächste Schritte

• Lesen Sie die Schlüsselkonzepte, um sich mit den wichtigsten Begriffen in Agent Registry vertraut zu machen.
• Agent Registry einrichten.
• Informationen zum Unterschied zwischen der automatischen und der manuellen Registrierung für Agenten.