Datenmodell der Agent Registry

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

• Agents: 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 Agents 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 Agents 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 deklarative Metadatenblockmanifeste sind, die inline in der Agentenkarte eines Agents 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 Agents, Endpunkte und MCP-Server:

• Schreibbare API-R1essource: Sie verwalten diese Agentenkomponenten, indem Sie manuell eine Service-Ressource in der Registry 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.

Eigenständige Skills verwenden nicht das Service Projektionsmodell. 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 Agents und MCP-Servern über zwei Registrierungsmechanismen: automatisch und manuell.

Agent Registry registriert automatisch Agents und Server, die auf unterstützten Google Cloud Runtimes bereitgestellt werden. Aktivieren Sie die Agent Registry API, um Ihre Agents, 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 Agents, 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 auf unterstützten Google Cloud Runtimes bereitgestellt werden, automatisch erkannt und aufgenommen werden. Bei Agents, die das offene Agent2Agent-Protokoll (A2A) implementieren, werden außerdem automatisch die A2A-Skills und -Funktionen aus der Agentenkarte extrahiert.	Agents	Agent Runtime auf der Gemini Enterprise Agent Platform Google Workspace Gemini Enterprise Google Kubernetes Engine-Deployments (GKE) mit einem bestimmten Label 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 mit einem bestimmten Label für den Funktionstyp Cloud Run Dienste, die mit einem bestimmten Flag für den Funktionstyp konfiguriert wurden
		Skills	Öffentliche Skills von Google sind in allen Projekten weltweit auffindbar.
Manuelle Registrierung	Für externe Ressourcen, benutzerdefinierte Agentenkomponenten auf nicht unterstützten Runtimes oder Standard-REST-Agents, die das A2A Protokoll nicht implementieren, müssen Sie sie manuell registrieren, indem Sie eine Service Ressource in der Registry erstellen. Für eigenständige Skills verwenden Sie die Ressource Skill.	Agents	Remote-Agents
		MCP-Server	Benutzerdefinierte Agentenkomponenten auf nicht unterstützten Runtimes oder externen MCP-Servern
		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 von Agents