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.
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.
Hinweis
- Agent Registry einrichten
Rufen Sie die Projekt-ID für das Governance-Projekt ab, in dem die Agent Registry aktiviert ist.
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 Agent Registry aktiviert ist, um die Berechtigungen zu erhalten, die Sie zum Prüfen der Details des Skill-Publishers in 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 zum Skill-Publisher 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.comunddiscoveryengine.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
- Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:
- Wählen Sie den Tab Skills aus. Auf der Seite wird eine Liste aller Ihrer registrierten Skills angezeigt.
- 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 alpha agent-registry publishers list aus, um alle verifizierten Publisher an einem Standort aufzulisten:
gcloud alpha 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/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers"
Ersetzen Sie Folgendes:
PROJECT_ID: Projekt-ID.LOCATION: der Standort der Registry.
Details zum Verlag oder Webpublisher ansehen
So rufen Sie Details zu einem bestimmten Publisher auf:
Console
- Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:
- Wählen Sie den Tab Skills aus.
- Klicken Sie auf den Namen einer Fähigkeit, um die Detailseite zu öffnen.
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 alpha agent-registry publishers describe aus, um Details zu einem bestimmten Publisher aufzurufen:
gcloud alpha 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/v1alpha/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.