Datenmodell der Agent Registry

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

  • KI-Agenten: Autonome KI-Akteure, die bestimmte Aufgaben ausführen, Tools aufrufen und mit anderen Agenten zusammenarbeiten.
  • 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. Durch die Abstraktion dieser Ziele in verwaltbare Ressourcen können Sie mit der Agent Registry zentral steuern, auf welche externen APIs Ihre Agents zugreifen können.
  • Skills: Modulare Funktionen, die die Möglichkeiten eines Agenten erweitern. In der Agent Registry wird zwischen eigenständigen Skills, die Pakete mit Anweisungen und optionalen Scripts sind, die direkt in der Registry verwaltet werden, und A2A-Skills unterschieden. A2A-Skills sind Funktionsbeschreibungen, die in der Agentenkarte eines Agenten aufgeführt sind und anderen Agenten mitteilen, wann und wie sie mit ihm kommunizieren können.

Weitere Informationen zu diesen und anderen Konzepten, die in der Agent Registry verwendet werden, finden Sie unter Wichtige Konzepte.

API-Ressourcen

Bei der Agent Registry API werden Lese- und Schreibvorgänge für KI-Agenten, Endpunkte und MCP-Server getrennt:

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

Die Spezifikationsflags, die Sie beim Erstellen einer Service verwenden, bestimmen die resultierende Ressourcensammlung mit Lesezugriff:

Flags Ressourcensammlung Anwendungsfall Zulässige Werte
--agent-spec-type
--agent-spec-content		 Agent (agents) Remote-Agents (A2A-kompatible oder Standard-REST-Agents) 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.

Bei eigenständigen Skills wird das Service-Prognosemodell nicht verwendet. Stattdessen können Sie Skills direkt über die API-Ressourcen Skill, SkillRevision und Publisher verwalten, versionieren und auflisten.

Informationen zum Einrichten der Agent Registry Weitere Informationen zur Agent Registry API finden Sie in der API-Referenzdokumentation.

Unterstützte Produkte und Komponenten

In der Agent Registry werden unterstützte Produkte und Komponenten danach kategorisiert, wie sie registriert werden: automatisch oder manuell.

Automatische Registrierung

In der Agent Registry werden unterstützteGoogle Cloud -Arbeitslasten, die in Ihrem Projekt bereitgestellt werden, automatisch erkannt und aufgenommen. Bei Agenten, die das offene Agent2Agent-Protokoll (A2A) implementieren, werden die A2A-Fähigkeiten und ‑Funktionen automatisch aus der Agentenkarte extrahiert. Von Google erstellte eigenständige Skills sind auch weltweit auffindbar, wenn Sie die Agent Registry einrichten.

In der folgenden Tabelle sind die Produkte und Komponenten aufgeführt, die automatisch in der Agent Registry registriert werden:

Komponententyp Unterstützte Produkte
Agents
MCP-Server
Skills Öffentliche Google-Skills sind weltweit in allen Projekten auffindbar.

Manuelle Registrierung

Bei benutzerdefinierten Arbeitslasten, externen Cloud-Laufzeiten, On-Premise-Infrastruktur oder Agents, die das A2A-Protokoll nicht implementieren, registrieren Sie Komponenten manuell über die beschreibbare Ressource Service. Für benutzerdefinierte eigenständige Skills verwenden Sie die Skill-Ressource.

In der folgenden Tabelle sind die Produkte und Komponenten aufgeführt, die Sie manuell registrieren:

Komponententyp Unterstützte Ressourcen
Agents Remote-Agents, die in Compute Engine, Google Kubernetes Engine, Cloud Run, lokalen Systemen oder externen Clouds bereitgestellt werden
MCP-Server Benutzerdefinierte agentische Komponenten in nicht unterstützten Runtimes oder auf externen MCP-Servern
Endpoints Externe Ziel-REST APIs oder Dienst-URLs, die als Endpunkte verwaltet werden
Skills Eigene Standalone-Skills, die von Ihrer Organisation erstellt wurden

Nächste Schritte