Details zum Skill-Publisher ansehen

In der Agent Registry können Publisher die Berechtigung hinter registrierten eigenständigen Skills bestätigen, um die unbefugte Verwendung von Publisher-Namen zu verhindern. Jeder Publisher legt die verifizierte Domain oder das ID-Präfix für Skill-IDs fest, z. B. cloud.google.com für von Google verwaltete Skills oder private- für manuell registrierte Skills.

Von Google verwaltete und private Publisher

Google steuert das Erstellen, Aktualisieren und Löschen von Publishern. Von Ihnen erstellte Skills werden automatisch dem Standard-Publisher private zugewiesen, der das Präfix private- verwendet. Sie können Publisher-Details in der Agent Registry auflisten und prüfen, um die Inhaberschaft registrierter Skills zu bestätigen.

Von Google verwaltete und private Publisher sind mit Publisher-Ressourcen in der Agent Registry verknüpft. Publisher-Ressourcen gelten nur für eigenständige Skills. Agenten und MCP-Server (Model Context Protocol) unterscheiden zwischen integrierten Google-Agenten, Google- und Google Cloud -Remote-MCP-Servern und projektbezogenen Komponenten anhand von Präfixen in ihren Registry-IDs. Informationen zum Suchen oder Filtern nach diesen Präfixen finden Sie unter Komponenten nach Quellpräfix suchen und Registrierte Agents filtern.

Hinweis

  1. Agent Registry einrichten
  2. Rufen Sie für eine Einrichtung mit einem einzelnen Projekt die Projekt-ID des Governance-Projekts ab, in dem die Agent Registry aktiviert ist. Wenn Sie eine Verwaltungsgrenze für mehrere Projekte konfiguriert haben, verwenden Sie die Projekt-ID Ihres Verwaltungsprojekts für die grenzübergreifende Erkennung und Registrierung oder geben Sie eine Mitgliedsprojekt-ID für Vorgänge in einem einzelnen Projekt an.

  3. Eigenständigen Skill registrieren

  4. Wenn Sie die Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, richten Sie Ihre gcloud CLI-Umgebung ein.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Registry API Viewer (roles/agentregistry.viewer) für das Governance-Projekt zuzuweisen, in dem die Agent Registry aktiviert ist, um die Berechtigungen zu erhalten, die Sie zum Prüfen der Details des Skill-Publishers in 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.

Andere Agent Registry-Rollen enthalten möglicherweise auch die Berechtigungen, die zum Aufrufen von Details zu Skill-Publishern erforderlich sind. Weitere Informationen finden Sie unter Agent Registry-Rollen und -Berechtigungen.

Publisher-Stufen

Publisher werden in Stufen eingeteilt, die ihren Überprüfungsstatus widerspiegeln:

  • Von Google verwaltet (FIRST_PARTY): Verifizierte Publisher, die von Google verwaltet werden, z. B. cloud.google.com und discoveryengine.googleapis.com.
  • Privat (PRIVATE): Der Standard-private-Publisher, der automatisch den Skills zugewiesen wird, die Sie oder andere Nutzer im Projekt erstellen.

Publisher auflisten

Sie können alle Publisher auflisten, die an Ihrem Standort konfiguriert sind:

Console

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

    Zur Agent Registry

  2. Wählen Sie den Tab Skills aus. Auf der Seite wird eine Liste aller Ihrer registrierten Skills angezeigt.
  3. In der Spalte Publisher aller registrierten Skills kannst du alle verfügbaren verifizierten Publisher durchsuchen, die du mit deinen Skills verknüpft hast.

gcloud

Führen Sie den Befehl gcloud agent-registry publishers list aus, um alle verifizierten Publisher an einem Standort aufzulisten:

gcloud agent-registry publishers list \
    --project=PROJECT_ID \
    --location=LOCATION

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.

REST

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.

Details zum Publisher ansehen

So rufen Sie Details zu einem bestimmten Publisher auf:

Console

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

    Zur Agent Registry

  2. Wählen Sie den Tab Skills aus.
  3. Klicken Sie auf den Namen einer Fähigkeit, um die Detailseite zu öffnen.
  4. Suchen Sie im Abschnitt Skill-Details die Skill-ID des Skills.

    Verwenden Sie dieses Feld für die Skill-ID, um die Assets eines bestimmten Publishers zu finden. Das Format für von Google verwaltete Skills ist beispielsweise urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID.

gcloud

Führen Sie den Befehl gcloud agent-registry publishers describe aus, um Details zu einem bestimmten Publisher aufzurufen:

gcloud agent-registry publishers describe PUBLISHER_ID \
    --project=PROJECT_ID \
    --location=LOCATION

Ersetzen Sie Folgendes:

  • PUBLISHER_ID: die ID des Publishers, den Sie prüfen möchten.
  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.

REST

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/PUBLISHER_ID"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Standort der Registry.
  • PUBLISHER_ID: die ID des Publishers, den Sie prüfen möchten.

Nächste Schritte