Agent Registry organisiert Ihr KI-Ökosystem in standardisierte Ressourcen, sodass Sie KI-Agenten, MCP-Server, Endpunkte und Skills in einem einzelnen Projekt oder einer Verwaltungsgrenze registrieren, erkennen und verwalten können. Wenn Sie verstehen, wie die Agent Registry beschreibbare Service-Ressourcen von Ressourcen mit Lesezugriff trennt, Ressourcen projektübergreifend verwaltet und die automatische und manuelle Registrierung unterstützt, 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 dieService-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 eineAgent-,McpServer- oderEndpoint-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.
Projektübergreifendes Datenmodell
Wenn Sie eine Verwaltungsgrenze konfigurieren, zentralisiert Agent Registry die Erkennung und Governance für alle Mitgliedsprojekte aus Ihrem Verwaltungsprojekt.
Wenn Sie Ressourcen aus dem Verwaltungsprojekt abfragen, auflisten oder suchen, wendet die Agent Registry die folgenden Bereichsregeln an, um einen konsolidierten Katalog bereitzustellen, ohne Ressourcen zu duplizieren oder Endpunktkonflikte zu verursachen:
| Ressourcenkategorie | Bereich in einer Verwaltungsgrenze | Beschreibung |
|---|---|---|
| Automatisch erkannte Ressourcen | Aus Mitgliedsprojekten zusammengefasst | KI-Agenten und MCP-Server, die automatisch in Mitgliedsprojekten erkannt werden, werden in der Ansicht des Verwaltungsprojekts zusammengefasst, wenn Sie sie auflisten oder an einem Standort im Verwaltungsprojekt nach ihnen suchen. Wenn Sie einen KI-Agenten oder MCP-Server aufrufen, auflisten oder suchen, können Sie in der Anfrage entweder die ID des Verwaltungsprojekts oder die ID des Mitgliedsprojekts angeben. Der Ressourcenname behält die ID bei, die Agent Registry der Komponente zuweist, und verwendet das in der Anfrage angegebene Projekt. |
| Manuell registrierte Ressourcen | Auf das Projekt beschränkt, in dem sie erstellt werden | Benutzerdefinierte KI-Agenten, externe MCP-Server und Endpunkte, die manuell als Service-Ressourcen registriert wurden, sind auf das Projekt beschränkt, in dem sie erstellt wurden. Erstellen Sie sie im Verwaltungsprojekt, damit sie über die Verwaltungsgrenze hinweg sichtbar sind, oder in einem Mitgliedsprojekt, damit sie nur innerhalb dieses einzelnen Projekts sichtbar sind. |
| Bindungen | Auf das Projekt beschränkt, in dem sie erstellt werden | Binding-Ressourcen sind auf das Projekt beschränkt, in dem sie erstellt werden. Erstellen Sie sie im Verwaltungsprojekt für die Sichtbarkeit im gesamten Bereich oder in einem Mitgliedsprojekt für die Sichtbarkeit in einem einzelnen Projekt. |
| Eigenständige Skills und Publisher | Auf das Projekt beschränkt, in dem sie erstellt werden | Benutzerdefinierte eigenständige Skill-, SkillRevision- und Publisher-Ressourcen sind auf das Projekt beschränkt, in dem sie erstellt werden, und werden nicht von Mitgliedsprojekten im Verwaltungsprojekt zusammengefasst. Von Google verwaltete eigenständige Skills sind automatisch in allen Projekten auffindbar, wenn Sie die Agent Registry einrichten. |
| KI-Anwendungen | Auf das Projekt beschränkt, in dem sie erstellt werden | Ressourcen AiApplication mit Lesezugriff und die damit verknüpften Komponentenansichten sind auf das Projekt und den Standort beschränkt, an dem die Anwendung erstellt wurde. |
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 oder in Mitgliedsprojekten innerhalb Ihrer Verwaltungsgrenze bereitgestellt werden. Bei Agenten, die das offene Agent2Agent-Protokoll (A2A) implementieren, extrahiert die Registry automatisch ihre A2A-Fähigkeiten und ‑Funktionen aus ihrer Agentenkarte. Von Google verwaltete eigenständige Skills sind auch in allen Projekten sichtbar, wenn Sie 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 sind Agenten, MCP-Server oder Endpunkte, die außerhalb Ihres Governance-Projekts oder Ihrer Verwaltungsgrenze gehostet werden, z. B. in separaten Google Cloud -Projekten ohne Grenze, in einer lokalen Infrastruktur oder in externen Clouds. Sie registrieren diese Remote-Komponenten manuell im Governance-Projekt mit einer Service-Ressource. Sie verwenden auch eine Service-Ressource, um Komponenten in nicht unterstützten Laufzeiten oder für Agenten, 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 |