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 Anweisungen, 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:

  • Beschreibbare API-Ressource: 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 Laufzeiten 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 und 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 Laufzeiten 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
MCP-Server Offizielle Google- und Google Cloud Remote-MCP-Server
Skills Die öffentlichen Skills von Google sind in allen Projekten global auffindbar.
Manuelle Registrierung Bei externen Ressourcen, benutzerdefinierten Agentenkomponenten auf nicht unterstützten Laufzeiten 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. Bei eigenständigen Skills verwenden Sie die Ressource Skill. Agents Remote-Agents
MCP-Server Benutzerdefinierte Agentenkomponenten auf nicht unterstützten Laufzeiten oder externen MCP-Servern
Skills Ihre eigenen eigenständigen Skills

Nächste Schritte