Datenmodell der Agent Registry

Agent Registry organisiert Ihr KI-Ökosystem in standardisierte Ressourcen, damit Sie KI-Agenten, MCP-Server, Endpunkte und Skills registrieren, finden und verwalten können. Wenn Sie verstehen, wie Agent Registry beschreibbare Service-Ressourcen von schreibgeschützten Erkennungsressourcen trennt und welche Produkte die automatische und manuelle Registrierung unterstützen, können Sie Ihre Registry besser entwerfen und verwalten.

Agentische Komponenten

Mit Agent Registry können Sie die folgenden Arten von agentischen Komponenten registrieren, erkennen und verwalten:

  • Agenten: Autonome KI-Akteure, die bestimmte Aufgaben ausführen, Tools aufrufen und mit anderen Agenten zusammenarbeiten.
  • MCP-Server: Programme, die das Model Context Protocol (MCP) implementieren, um standardisierte Datenressourcen und Tools bereitzustellen. 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 KI-Agent zugreift. Durch die Abstraktion dieser Ziele in verwaltbare Ressourcen können Sie mit der Agent Registry zentral steuern, auf welche externen APIs Ihre Agenten zugreifen können.
  • Skills: Modulare Funktionen, die die Möglichkeiten eines KI-Agenten erweitern. Eigenständige Skills sind Pakete mit Anweisungen und optionalen Scripts, die direkt in der Registry verwaltet werden. A2A-Fähigkeiten sind Funktionsbeschreibungen auf der Agentenkarte eines KI-Agenten, die anderen KI-Agenten mitteilen, wann und wie sie mit ihm kommunizieren sollen. Weitere Informationen finden Sie unter Skills-Architektur.

Dienstressourcen und Erkennungsressourcen

Wie die Agent Registry eine Komponente darstellt, hängt von ihrem Komponententyp und ihrem Registrierungsmodell ab. Weitere Informationen zum Lebenszyklus und zur Erkennung von Komponenten finden Sie unter Lebenszyklus und Erkennung von Komponenten.

KI-Agenten, MCP-Server und Endpunkte

Unabhängig davon, ob ein KI-Agent, ein MCP-Server oder ein Endpunkt automatisch oder manuell registriert wird, wird er in der Agent Registry als schreibgeschützte Agent-, McpServer- oder Endpoint-Erkennungsressource dargestellt. Nutzer wie Orchestrator-Agents, Clientanwendungen und Entwickler verwenden diese Erkennungsressourcen, um registrierte Komponenten aufzulisten, zu suchen und anzusehen.

Bei automatisch registrierten Komponenten erfasst die Agent Registry Metadaten direkt aus unterstützten Laufzeiten und erstellt die Discovery-Ressource ohne eine Service-Ressource.

Wenn Sie einen KI-Agenten, einen MCP-Server oder einen Endpunkt manuell registrieren, trennt die Agent Registry Verwaltungsvorgänge von der Komponentenerkennung, indem sie die folgenden Elemente erstellt:

  • Eine beschreibbare Service-Ressource: Speichert die Metadaten der Komponente, einschließlich des Typs der agentischen Komponente, ihrer Schnittstellen-URL, Beschreibung, Protokollbindung und Funktionsspezifikation. Sie erstellen, aktualisieren oder löschen die Service-Ressource für Verwaltungsvorgänge wie das Aktualisieren von Metadaten oder das Aufheben der Registrierung der Komponente, ohne die zugrunde liegende Bereitstellung zu ändern oder zu löschen.
  • Eine Discovery-Ressource: Wenn Sie eine Service-Ressource erstellen oder aktualisieren, liest die Agent Registry die Metadaten und erstellt oder aktualisiert automatisch eine Agent-, McpServer- oder Endpoint-Discovery-Ressource, die die Komponente in Ihrer Registry darstellt.

Die Spezifikations-Flags, die Sie beim Erstellen einer Service-Ressource verwenden, bestimmen die resultierende Ressourcensammlung mit Lesezugriff:

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

Diese Flag-Paare schließen sich gegenseitig aus. Wenn Sie Flags aus mehr als einem Paar angeben, wird ein Fehler zurückgegeben. Wenn Sie das Flag-Paar für den falschen Komponententyp angeben, erstellt die Agent-Registry die Erkennungsressource in der Sammlung, die dem von Ihnen angegebenen Flag entspricht. Wenn Sie beispielsweise beim Registrieren eines Endpunkts --agent-spec-type=no-spec übergeben, wird eine Agent-Ressource anstelle einer Endpoint-Ressource erstellt. Typspezifische Abfragen und Governance-Richtlinien werden daher nicht wie erwartet angewendet.

Eigenständige Skills

Eigenständige Skills verwenden keine separaten Service-Ressourcen. Stattdessen registrieren, versionieren und fragen Sie Skills direkt über Skill-Ressourcen auf oberster Ebene, untergeordnete SkillRevision-Ressourcen und Publisher-Ressourcen ab.

Informationen zum Einstieg finden Sie unter Agent Registry einrichten. 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 nach ihrer Registrierung kategorisiert: automatisch oder manuell.

Automatische Registrierung

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

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

Komponententyp Unterstützte Produkte
Agents
MCP-Server
Skills Von Google verwaltete Skills sind in allen Projekten sichtbar.

Manuelle Registrierung

Remote-Komponenten, also Agenten, MCP-Server oder Endpunkte, die außerhalb Ihres Governance-Projekts in separaten Google Cloud -Projekten, einer lokalen Infrastruktur oder externen Clouds gehostet werden, registrieren Sie manuell im Governance-Projekt mit einer Service-Ressource. Sie verwenden auch eine Service-Ressource, um Komponenten in nicht unterstützten Laufzeiten oder Agents, die das A2A-Protokoll nicht implementieren, manuell zu registrieren. Für benutzerdefinierte eigenständige Skills verwenden Sie eine 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 auf Compute Engine, GKE, Cloud Run, lokalen Systemen oder externen Clouds bereitgestellt werden
MCP-Server Benutzerdefinierte agentische Komponenten auf nicht unterstützten Laufzeiten oder externen MCP-Servern
Endpoints Externe Ziel-REST-APIs oder Dienst-URLs, die als Endpunkte verwaltet werden
Skills Eigene eigenständige Skills, die von Ihrer Organisation erstellt wurden

Nächste Schritte