Agent Registry einrichten

Wenn Sie Ihre KI-Agents und MCP-Server (Model Context Protocol) 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 Agents, die in dem Projekt bereitgestellt werden, in dem die API aktiviert ist, ermitteln 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-Registrierung 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. Installieren Sie die Komponente alpha:

    gcloud components install alpha

  3. Prüfen Sie, ob die neueste Version der Google Cloud 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 IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere 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 die ID Ihres Projekts.

Nachdem Sie die Agent Registry API aktiviert haben, können Sie mit der Registrierung und Suche von Agents in diesem Projekt beginnen.

Berechtigungen erteilen

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

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

  • Agent Registry API Viewer (roles/agentregistry.viewer): Agents, Tools und ihre Attribute ansehen.
  • Agent Registry API Editor (roles/agentregistry.editor): Bearbeitungszugriff auf Agent Registry-Ressourcen.
  • Agent Registry API Admin (roles/agentregistry.admin): Alle Aktionen ausführen, einschließlich der manuellen Registrierung von Agents und der Aktualisierung von Metadaten.

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 die 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 Verwaltungsseite 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