Agent Registry einrichten

Wenn Sie Ihre KI-Agents und MCP-Server (Model Context Protocol) in der Agent Registry registrieren und ermitteln 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 ermitteln und verwalten, die in dem spezifischen Projekt bereitgestellt wurden, in dem die API aktiviert ist.

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

Hinweis

Verwenden Sie ein vorhandenes Projekt oder erstellen Sie ein neues, um die Agent Registry einzurichten.

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. Installieren Sie die alpha-Komponente:

    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. Rollen zuweisen.

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 Agents in diesem Projekt registrieren und ermitteln.

Berechtigungen erteilen

Wenn Sie Dienste in der Agent Registry ansehen und verwalten möchten, müssen Sie Nutzern die entsprechenden Berechtigungen für die Identitäts- und Zugriffsverwaltung 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-Administrator (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 vom 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