In der Agent Registry stellt ein Publisher eine bestätigte
Autorität dar, die Agent-Skills veröffentlicht. Publisher legen die Präfixe fest, die von Skills verwendet werden können, um Namensmissbrauch zu verhindern und die Identitätsbestätigung zu erzwingen. Das Präfix google- ist beispielsweise für bestätigte Google-Skills reserviert.
In diesem Dokument wird erläutert, wie Sie Details zu bestätigten Publishern für Ihre registrierten Skills überprüfen können.
Das Erstellen, Aktualisieren oder Löschen von Publishern und das Verwalten von bestätigten Präfixzuweisungen ist auf Google-interne Administratoren beschränkt. Die von
Ihnen oder anderen Nutzern erstellten Skills werden automatisch dem Standardprivate
publisher zugewiesen. Die veröffentlichte ID eines bestimmten Skills hat daher das Präfix
private-. Sie können keine benutzerdefinierten Publisher-Ressourcen registrieren.
Hinweis
Bevor Sie beginnen, richten Sie die Agent Registry ein und registrieren Sie einen eigenständigen Skill. Für diese Aufgaben benötigen Sie die Projekt-ID.
Wenn Sie die Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, müssen Sie Ihre gcloud CLI-Umgebung eingerichtet haben.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die
Agent Registry User (roles/agentregistry.user) IAM-Rolle für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die
Sie zum Überprüfen der Details von Skill-Publishern 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.
Publisher-Ebenen
Publisher werden in Ebenen eingeteilt, die ihren Bestätigungsgrad widerspiegeln:
- Erstanbieter (
FIRST_PARTY) : Bestätigte globale Publisher, die von Google kuratiert wurden. Beispiele:publishers/cloud.google.comundpublishers/discoveryengine.googleapis.com. - Privat (
PRIVATE) : Der Standardpublisherprivate, der automatisch den Skills zugewiesen wird, die Sie oder andere Nutzer im Projekt erstellen.
Publisher auflisten
Sie können alle in Ihrem Standort konfigurierten Publisher auflisten:
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 können Sie alle verfügbaren bestätigten Publisher durchsuchen, die Sie mit den einzelnen Skills verknüpft haben.
gcloud
gcloud alpha agent-registry publishers list \
--project=PROJECT_ID \
--location=LOCATION
Ersetzen Sie Folgendes:
PROJECT_ID: Die 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: Die Projekt-ID.LOCATION: Der Standort der Registry.
Publisher-Details ansehen
Sie können Details zu einem bestimmten Publisher aufrufen:
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 eines Skills, um die Detailseite zu öffnen.
Suchen Sie im Bereich Skill-Details den Uniform Resource Name (URN) des Skills.
Verwenden Sie dieses Feld für den Skill-URN, um die Assets eines bestimmten Publishers zu finden. Das Format für von Google erstellte Skills ist beispielsweise
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID.
gcloud
gcloud alpha agent-registry publishers describe PUBLISHER_ID \
--project=PROJECT_ID \
--location=LOCATION
Ersetzen Sie Folgendes:
PUBLISHER_ID: Die ID des Publishers, den Sie überprüfen möchten.PROJECT_ID: Die 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: Die Projekt-ID.LOCATION: Der Standort der Registry.PUBLISHER_ID: Die ID des Publishers, den Sie überprüfen möchten.
Nächste Schritte
- Eigenständige Skills registrieren