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.

Sie können die Agent Registry in einem einzelnen Governance-Projekt oder in mehreren Projekten einrichten, indem Sie eine Verwaltungsgrenze konfigurieren, bei der ein zentrales Verwaltungsprojekt als Governance-Projekt dient.

Hinweis

Konfigurieren Sie die Agent Registry entweder in einem einzelnen Projekt oder in mehreren Projekten:

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

  • Für ein einzelnes Projekt: Aktivieren Sie die Agent Registry API in Ihrem Governance-Projekt. Nachdem Sie die API aktiviert und Berechtigungen gewährt haben, können Sie mit der Registrierung und Erkennung von Agents in diesem Projekt beginnen. Sie müssen keine Verwaltungsgrenze konfigurieren.
  • Für mehrere Projekte (Verwaltungsgrenze): Aktivieren Sie die Resource Manager API für das Projekt, das Sie zum Ausführen von Konfigurationsbefehlen verwenden. Wenn Sie eine Verwaltungsgrenze für mehrere Projekte konfigurieren und die Funktionskonfiguration erstellen, aktiviert Resource Manager automatisch die Agent Registry API in Ihrem Verwaltungsprojekt.

Verwenden Sie Ihre Projekt-ID, um APIs zu aktivieren:

Console

Aktivieren Sie die Agent Registry API für ein einzelnes Projekt:

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

Aktivieren Sie für mehrere Projekte (Verwaltungsgrenze) die Resource Manager API für das Projekt, das Sie für die Konfiguration verwenden:

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

  • Wenn Sie die Agent Registry API für ein einzelnes Projekt aktivieren möchten, verwenden Sie den Befehl gcloud services enable:

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

  • Aktivieren Sie für mehrere Projekte (Verwaltungsgrenze) die Resource Manager API für das Projekt, das Sie für die Konfiguration verwenden:

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

Ersetzen Sie PROJECT_ID durch die Projekt-ID Ihres eigenständigen Governance-Projekts oder des Projekts, das Sie als Verwaltungsprojekt für Ihre Verwaltungsgrenze verwenden möchten.

Verwaltungsgrenze für mehrere Projekte konfigurieren

Wenn Sie Agent Registry in mehreren Google Cloud -Projekten verwenden möchten, konfigurieren Sie eine Verwaltungsgrenze. Eine Verwaltungsgrenze gruppiert ein oder mehrere Google Cloud Mitgliedsprojekte in einem zentralen Verwaltungsprojekt, das als Governance-Projekt dient, damit Sie KI-Agenten, MCP-Server und Tools projektübergreifend erkennen und verwalten können.

Sie definieren eine Verwaltungsgrenze in Resource Manager. Eine detaillierte Anleitung finden Sie in der Resource Manager-Dokumentation unter Verwaltungsgrenzen konfigurieren.

Eine Architekturübersicht über das Zusammenspiel von BoundaryConfig-, Boundary- und CapabilityConfig-Ressourcen finden Sie unter Projektübergreifende Grenzen.

Wenn Sie eine CapabilityConfig-Ressource mit agent-management erstellen, aktiviert Resource Manager automatisch agentregistry.googleapis.com für das Verwaltungsprojekt. Nachdem Sie Ihre Verwaltungsgrenze festgelegt haben:

  1. Wenn für lokale Vorgänge in einzelnen Mitgliedsprojekten erforderlich, aktivieren Sie die Agent Registry API für diese Mitgliedsprojekte.
  2. Weisen Sie Nutzern und Dienstkonten im Verwaltungsprojekt die erforderlichen Rollen und Berechtigungen zu.

Wenn Sie KI-Agenten oder MCP-Server an einem Standort im Verwaltungsprojekt auflisten oder suchen, aggregiert die Agent Registry automatisch erkannte Ressourcen an diesem Standort aus allen Mitgliedsprojekten im Bereich und gibt sie zurück. Außerdem werden alle registrierten Service-Ressourcen zurückgegeben, die direkt an diesem Standort im Verwaltungsprojekt erstellt wurden. In jedem zurückgegebenen Ressourcennamen wird die ID der Komponente beibehalten und das in der Anfrage angegebene Projekt verwendet.

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