Agent Registry einrichten

Wenn Sie Ihre KI-Agenten, MCP-Server (Model Context Protocol), eigenständigen Skills und Endpunkte in der Agent Registry registrieren und erkennen möchten, müssen Sie die Agent Registry API in Ihrem Google Cloud -Projekt aktivieren. Die Agent Registry funktioniert auf Projektebene. So können Sie KI-Agenten, Server, Skills und Endpunkte, die in dem Projekt bereitgestellt werden, in dem die API aktiviert ist, erkennen und verwalten.

In diesem Dokument wird beschrieben, wie Sie die Agent Registry einrichten und die erforderliche API aktivieren.

Hinweis

Wenn Sie die Agent Registry einrichten möchten, verwenden Sie ein vorhandenes Projekt oder erstellen Sie ein neues.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Google Cloud Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Einrichten der Agent Registry benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

gcloud CLI-Umgebung einrichten

Wenn Sie die Google Cloud CLI für die Agent Registry verwenden möchten, gehen Sie so vor:

  1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

  2. Prüfen Sie, ob die aktuelle Version der gcloud CLI installiert ist:

    gcloud components update

Agent Registry API aktivieren

Console

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen

API aktivieren

gcloud

Aktivieren Sie die Agent Registry API in Ihrem Projekt:

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.

Nachdem Sie die Agent Registry API aktiviert haben, können Sie mit der Registrierung und dem Auffinden von KI-Agenten in diesem Projekt beginnen.

Berechtigungen erteilen

Wenn Sie Ressourcen in der Agent Registry aufrufen und verwalten möchten, müssen Sie Nutzern die entsprechenden IAM-Berechtigungen (Identity and Access Management) gewähren.

Weisen Sie Ihren Nutzern eine oder mehrere der folgenden Agent Registry-Rollen zu:

  • Agent Registry API Viewer (roles/agentregistry.viewer): Hier können Sie sich KI-Agents, MCP-Server, Tools, eigenständige Skills, Skill-Revisionen, Publisher, Endpunkte und Bindungen ansehen und danach suchen.
  • Agent Registry API Editor (roles/agentregistry.editor): Agent Registry-Ressourcen ansehen und bearbeiten, einschließlich der Registrierung, Aktualisierung und Löschung von KI-Agenten, MCP-Servern, Tools, Endpunkten, eigenständigen Skills und Skill-Revisionen.
  • Agent Registry API Admin (roles/agentregistry.admin): Alle Aktionen für Agent Registry-Ressourcen ausführen, einschließlich der Registrierung und Verwaltung von Agenten, MCP-Servern, Tools, Endpunkten, eigenständigen Skills, Skill-Revisionen, Bindungen und Skill-IAM-Richtlinien.
  • Agent Registry User (roles/agentregistry.user): Alle Agent Registry-Ressourcen ansehen sowie eigenständige Skills und Skill-Revisionen erstellen, aktualisieren und löschen, ohne Bearbeitungszugriff auf KI-Agenten, MCP-Server oder Endpunkte zu haben.

Informationen zum Zuweisen von IAM-Rollen für ein Projekt finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Agent Registry-Projekt ändern

Wenn Sie das Projekt ändern möchten, in dem Sie die Agent Registry verwenden, und Abhängigkeiten aus dem alten Projekt entfernen möchten, deaktivieren Sie die Agent Registry API in diesem Projekt. Anschließend können Sie die Agent Registry API in einem anderen Projekt aktivieren. Ihre Daten werden nicht migriert und Sie müssen Ihre Ressourcen in diesem neuen Projekt neu erstellen.

Agent Registry API deaktivieren

Wenn Sie Agent Registry nicht mehr benötigen, deaktivieren Sie die Agent Registry API für das Projekt:

Console

  1. Rufen Sie in der Google Cloud Console die Seite zur Verwaltung der Agent Registry API auf:

    Zur Agent Registry API

  2. Wählen Sie in der Projektauswahl das Google Cloud -Projekt aus, in dem Sie die Agent Registry eingerichtet haben.

  3. Klicken Sie auf API deaktivieren.

  4. Klicken Sie im Bestätigungsdialogfeld auf Deaktivieren.

gcloud 

gcloud services disable agentregistry.googleapis.com \
    --project=PROJECT_ID

Ersetzen Sie PROJECT_ID durch die ID des Projekts.

Nächste Schritte