Agent Registry einrichten

Wenn Sie Ihre KI-Agenten, MCP-Server (Model Context Protocol), eigenständigen Skills und Endpunkte in der Agent Registry registrieren und finden möchten, müssen Sie die Agent Registry API in Ihrem Google Cloud -Projekt aktivieren. Das Projekt, in dem Sie Agent Registry aktivieren, dient als Governance-Projekt. Mit dem Agent Registry-Governance-Projekt können Sie unterstützte Arbeitslasten, die in diesem Projekt bereitgestellt werden, automatisch erkennen und Remote-Komponenten, die in separaten Google Cloud -Projekten, lokalen Umgebungen oder externen Clouds gehostet werden, manuell registrieren.

Hinweis

Verwenden Sie zum Einrichten von Agent Registry ein vorhandenes Projekt oder erstellen Sie ein neues Projekt.

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.

Google Cloud CLI-Umgebung einrichten

Wenn Sie die gcloud 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. Aktualisieren Sie die gcloud CLI mit dem Befehl gcloud components update auf die neueste Version:

    gcloud components update

  3. Wenn Sie Vorschau-Funktionen verwenden möchten, installieren Sie die Komponente alpha mit dem Befehl gcloud components install:

    gcloud components install alpha

Agent Registry API aktivieren

Console

Erforderliche Rollen zum Aktivieren von APIs

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 Inhaberrolle (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 mit dem Befehl gcloud services enable:

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 KI-Agenten in diesem Projekt registrieren und finden.

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): KI-Agenten, MCP-Server, Tools, eigenständige Skills, Skill-Versionen, Publisher, Endpunkte und Bindungen ansehen und suchen.
  • Agent Registry API Editor (roles/agentregistry.editor): Agent Registry-Ressourcen ansehen und bearbeiten, einschließlich Registrieren, Aktualisieren und Löschen von KI-Agenten, MCP-Servern, Tools, Endpunkten, eigenständigen Skills und Skill-Versionen.
  • Agent Registry API Admin (roles/agentregistry.admin): Alle Aktionen für Agent Registry-Ressourcen ausführen, einschließlich Registrierung und Verwaltung von Agenten, MCP-Servern, Tools, Endpunkten, eigenständigen Skills, Skill-Versionen, Bindungen und IAM-Richtlinien für Skills.
  • Agent Registry User (roles/agentregistry.user): Alle Agent Registry-Ressourcen ansehen und eigenständige Skills und Skill-Versionen 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 Agent Registry verwenden, und Abhängigkeiten vom alten Projekt entfernen möchten, deaktivieren Sie die Agent Registry API im alten Projekt. Nachdem Sie die Agent Registry API im alten Projekt deaktiviert haben, können Sie sie 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 verwenden möchten, deaktivieren Sie die Agent Registry API im Projekt:

Console

  1. Rufen Sie in der Google Cloud Console die Seite zur API-Verwaltung für die Agent Registry 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

Deaktivieren Sie die Agent Registry API in Ihrem Projekt mit dem Befehl gcloud services disable:

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

Ersetzen Sie PROJECT_ID durch die ID des Projekts.

Nächste Schritte