Datenmodell der Agent Registry

In der Agent Registry werden agentische Komponenten Ihres Ökosystems in drei Haupttypen kategorisiert, die Sie in Ihrer Umgebung ermitteln können:

  • Agents: Autonome Akteure mit bestimmten Skills. Skills stellen die allgemeinen Fähigkeiten eines Agents dar und sind ein primärer Mechanismus für die Ermittlung.
  • 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 der Agent Registry zentral steuern, auf welche externen APIs Ihre Agents zugreifen können.

Weitere Informationen zu diesen und anderen Konzepten, die in der Agent Registry verwendet werden, finden Sie unter Schlüsselkonzepte.

Die Agent Registry API trennt Lese- und Schreibvorgänge. In der Agent Registry ist ein Service eine beschreibbare API-Ressource, die einen Agent, einen MCP-Server oder einen Endpunkt darstellt, den Sie manuell zu Ihrer Registry hinzufügen. In der Agent Registry werden auch automatisch Agents und Server registriert, 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. Mit der beschreibbaren Service-Ressource können Sie Einträge in Ihrer Registry manuell erstellen, aktualisieren und löschen. Fragen Sie dann die schreibgeschützten Ressourcen Agent, McpServer oder Endpoint ab, um Ihre registrierten Agents, Server und Endpunkte abzurufen, aufzulisten und zu suchen.

Weitere Informationen finden Sie unter Agent Registry einrichten.

Agentische Komponenten in Ihrer Registry registrieren

In der Agent Registry wird Ihr Katalog von Agents und MCP-Servern über zwei Registrierungsmechanismen verwaltet: automatisch und manuell. Verwenden Sie die Ressource Service, um Einträge manuell zu erstellen, zu aktualisieren und zu löschen.

Registrierungsmechanismus Beschreibung Registrierte Komponente Unterstützte Google Cloud Produkte
Automatische Registrierung Sie können die Agent Registry so konfigurieren und verwenden, dass bestimmte Ressourcen, die auf unterstützten Google Cloud Runtimes bereitgestellt werden, automatisch ermittelt und aufgenommen werden. Bei Agents, die das offene Agent2Agent-Protokoll (A2A) implementieren, werden die Skills und Funktionen auch automatisch aus der Agentenkarte extrahiert. Agents
MCP-Server Offizielle Google- und Remote-MCP-Server Google Cloud
Manuelle Registrierung Für externe Ressourcen, benutzerdefinierte agentische Komponenten 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. Agents Remote-Agents
MCP-Server Benutzerdefinierte agentische Komponenten auf nicht unterstützten Runtimes oder externen MCP-Servern

Nächste Schritte