Mit Agent Registry können Sie eigenständige Skills verpacken und manuell registrieren. Eigenständige Skills bündeln Agentenanweisungen mit zugehörigen Metadaten-Assets und optionalen Skripts, um die Schlussfolgerungen und den Workflow eines Agenten zu erweitern. Wenn Sie Ihre eigenen eigenständigen Skills in der Agent Registry registrieren, können Sie wiederverwendbare Funktionen zentral verwalten, versionieren und freigeben, zusammen mit den von Google verwalteten Skills, die bei der Einrichtung der Agent Registry verfügbar sind.
Hinweis
- Agent Registry einrichten
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.
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 folgenden IAM-Rollen für das Governance-Projekt zuzuweisen, in dem Agent Registry aktiviert ist, um die Berechtigungen zu erhalten, die Sie zum Registrieren von Skills in Agent Registry benötigen:
-
Eigenständige Skills registrieren und verwalten:
Agent Registry User (
roles/agentregistry.user) -
Eigenständige Skills und andere Agent Registry-Ressourcen registrieren und verwalten:
Agent Registry API Editor (
roles/agentregistry.editor)
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 können auch die Berechtigungen enthalten, die zum Registrieren und Verwalten von Skills und Skill-Versionen erforderlich sind. Weitere Informationen finden Sie unter Agent Registry-Rollen und -Berechtigungen.
Einschränkungen für die Nutzlast bei der Aufnahme
Wenn Sie einen Skill registrieren möchten, müssen Sie die Quelldateien des Skills in ein ZIP-Archiv packen. Das Archiv muss im Stammverzeichnis eine SKILL.md-Anweisungsdatei enthalten.
Während der Aufnahmephase des Skill-Registrierungsprozesses prüft die Agent Registry, ob die Nutzlast die folgenden Einschränkungen erfüllt:
- Größe des ZIP-Archivs: maximal 1 MB (komprimiert)
- Gesamtgröße der unkomprimierten Nutzlast: maximale unkomprimierte Größe von 10 MB, wenn das Scannen aktiviert ist.
- Größe einzelner Dateien: maximale unkomprimierte Größe von 1 MB pro Datei, wenn das Scannen aktiviert ist.
- Tiefe Verschachtelung: maximale Verschachtelungstiefe von 8 Ebenen.
- Spezifikationskonformität: Die Datei
SKILL.mdmuss einen gültigen YAML-Frontmatter-Abschnitt enthalten, in dem Name, Beschreibung und Metadaten gemäß der Spezifikation für Agent Skills definiert sind.
Wenn automatisches Scannen mit der Scanrichtlinie ENABLED_BLOCKING oder ENABLED_NONBLOCKING aktiviert ist, führt das Überschreiten der maximalen unkomprimierten Größe dazu, dass die Erstellung der Überarbeitung mit einem INVALID_ARGUMENT-Fehler fehlschlägt oder der Scanstatus der Überarbeitung in UNSUPPORTED_FORMAT wechselt. Wenn das Scannen deaktiviert ist, umgeht Agent Registry diese Scanspezifischen Limits. Informationen zum Konfigurieren von Scanrichtlinien und zu Einschränkungen bei der Nutzlastgröße finden Sie unter Skills auf Sicherheitsprobleme scannen.
Skill registrieren
Sie können Ihre eigenen Skills manuell in der Agent Registry registrieren. Informationen zu Preisen und Funktionskosten für Skills finden Sie unter Agent Registry-Preise.
So registrieren Sie Ihre Skills:
Console
Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:
Wählen Sie in der Projektauswahl Ihr Google Cloud Projekt aus.
Wählen Sie den Tab Skills aus.
Auf dem Tab Skills bietet die Schaltfläche Skill hinzufügen zwei Optionen zum Erstellen eines Skill-Containers und zum Importieren Ihres ersten Skill-Pakets. Wählen Sie eine der folgenden Optionen aus:
- Skill hinzufügen: Erstellen Sie einen neuen Skill-Container in der Registry. Sie können optional ein Skill-Paket hochladen, um die erste Version zu erstellen.
- Skill importieren: Registrieren Sie ein neues benutzerdefiniertes Skill-Paket, indem Sie ein ZIP-Bundle mit Ihrer
SKILL.md-Anweisungsdatei und optionalen Scripts oder eine eigenständigeSKILL.md-Datei hochladen.
Geben Sie im Bereich Skill erstellen oder Skill importieren die folgenden Details an:
- Anzeigename: Geben Sie einen nutzerfreundlichen Namen für den Skill ein.
- Beschreibung: Geben Sie eine kurze Zusammenfassung der Funktionen des Skills ein.
- Standort: Wählen Sie die geografische Region aus, z. B.
global,usodereu.
Wählen Sie im Abschnitt Nutzlastquelle eine der folgenden Optionen aus:
- Datei: Laden Sie Ihr gepacktes Skill-ZIP-Archiv oder eine eigenständige
SKILL.md-Datei im Feld Paket oder Datei hochladen hoch. Die maximale Uploadgröße beträgt 1 MB. Sie können die Datei in Ihrem lokalen Verzeichnis suchen. GCS-Bucket: Geben Sie im Feld Cloud Storage-URI den Pfad zu Ihrem ZIP-Archiv ein, das in einem Cloud Storage-Bucket gespeichert ist. Die maximale Uploadgröße beträgt 1 MB. Der Pfad muss das Format
gs://BUCKET_NAME/SKILL_PACKAGE.ziphaben.
- Datei: Laden Sie Ihr gepacktes Skill-ZIP-Archiv oder eine eigenständige
Klicken Sie auf Erstellen.
Ihr Skill wird im Status Deaktiviert (
DISABLED) erstellt. Verweisen Sie bei allen nachfolgenden Skill-Vorgängen auf Ihren Skill alsprivate-SKILL_ID, wie in derGoogle Cloud -Konsole angezeigt.Wenn Sie den Skill für die Agent-Erkennung verfügbar machen möchten, legen Sie die Standardversion fest und aktualisieren Sie den Zielstatus auf Aktiv. Eine Anleitung finden Sie unter Fähigkeiten verwalten.
gcloud
Erstellen Sie den Skill-Container und laden Sie die Nutzlast der ersten Version mit dem Befehl
gcloud agent-registry skills createhoch. Sie können entweder eine lokale ZIP-Datei hochladen oder ein in Cloud Storage gespeichertes Paket importieren:Lokale ZIP-Datei hochladen: So registrieren Sie einen Skill mit einer lokalen ZIP-Nutzlast:
gcloud agent-registry skills create SKILL_ID \ --project=PROJECT_ID \ --location=LOCATION \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION" \ --target-state=disabled \ --payload="LOCAL_ZIP_PATH"Ersetzen Sie
LOCAL_ZIP_PATHdurch den Pfad zu Ihrem gepackten Skill-Archiv auf Ihrem lokalen Computer, z. B../workspace-docs-skill.zip.Aus einem Cloud Storage-Bucket importieren: So registrieren Sie einen Skill mit einem ZIP-Archiv, das in einem Cloud Storage-Bucket gehostet wird:
gcloud agent-registry skills create SKILL_ID \ --project=PROJECT_ID \ --location=LOCATION \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION" \ --target-state=disabled \ --gcs-source-uri="gs://BUCKET_NAME/SKILL_PACKAGE.zip"Ersetzen Sie Folgendes:
BUCKET_NAME: der Name des Cloud Storage-Bucket, der das ZIP-Bundle enthält.SKILL_PACKAGE: der Name des Skill-Pakets, das die Skill-Nutzlast enthält.
Ersetzen Sie in beiden Befehlen Folgendes:
SKILL_ID: die Ressourcen-ID der Fähigkeit, z. B.workspace-docs-skill. Nach der Erstellung stellt die Registry automatisch das Präfixprivate-voran. Sie müssen die ID mit Präfix in allen nachfolgenden Skill-Befehlen verwenden, z. B.private-workspace-docs-skill.PROJECT_ID: Projekt-ID.LOCATION: die geografische Region, z. B.global,usodereu.DISPLAY_NAME: Ein nutzerfreundlicher Name für die Fähigkeit.DESCRIPTION: eine kurze Zusammenfassung, in der die Fähigkeiten des Skills erläutert werden.
Wenn Sie einen Skill ohne eine erste Version erstellen, können Sie den Zielstatus (
--target-state) nur aufdraftoderdisabledfestlegen.Wenn Sie einen Skill mit einer ersten Version erstellen, z. B. mit
--gcs-source-urioder--payload, legt die Agent Registry die erste Version als Standardversion des Skills fest. Sie können den Zielstatus je nach Scanrichtlinie auf einen der folgenden Werte festlegen:- Wenn
--target-state=activeund die Scanrichtliniedisabledoderenabled-nonblockingist, wechselt die Fähigkeit nach Abschluss des Erstellungsvorgangs in den Status Aktiv (STATE_ACTIVE). - Wenn
--target-state=activeund die Scanrichtlinieenabled-blocking(Standard) ist, wechselt der Skill nach Abschluss des Erstellungsvorgangs in den Status Entwurf (STATE_DRAFT). Im Hintergrund wechselt der übergeordnete Skill nach Abschluss des Sicherheitsscans nur dann zu Aktiv (STATE_ACTIVE), wenn der Scan keine Ergebnisse liefert und sich der übergeordnete Skill im Status Entwurf befindet, wobei die Standardversion weiterhin auf die ursprüngliche Version verweist. - Wenn
--target-state=disabledoder--target-state=draft, können Sie ihn später für die Agentenerkennung verfügbar machen, indem Sie eine gültige Standardversion festlegen und den Zielstatus auf Aktiv aktualisieren. Eine Anleitung finden Sie unter Skills verwalten.
- Wenn
REST
Erstellen Sie den Skill-Container mit einer ersten Inline-Version:
HTTP-Methode und URL
POST https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/skills?skillId=SKILL_IDErsetzen Sie Folgendes:
PROJECT_ID: Projekt-ID.LOCATION: der Standort der Registry.SKILL_ID: eine eindeutige Kennung für den Skill-Container.
JSON-Text der Anfrage (Upload einer lokalen Datei)
Wenn Sie einen Skill erstellen möchten, indem Sie lokale ZIP-Archiv-Bytes direkt hochladen, verwenden Sie die Nutzlast
archiveUploadSourcein der ersten Version (initialRevision). Wenn Sie eine erste Version angeben, legt die Agent Registry diese Version als Standardversion des Skills fest. Sie können den Zielstatus aufTARGET_STATE_DRAFT,TARGET_STATE_DISABLEDoderTARGET_STATE_ACTIVEfestlegen. Ohne eine erste Überarbeitung werden nurTARGET_STATE_DRAFTundTARGET_STATE_DISABLEDals Zielstatus unterstützt:{ "displayName": "DISPLAY_NAME", "description": "DESCRIPTION", "type": "SIMPLE", "targetState": "TARGET_STATE_DISABLED", "initialRevision": { "archiveUploadSource": { "archiveContent": "BASE64_ZIP_BYTES" } } }Ersetzen Sie Folgendes:
DISPLAY_NAME: Ein nutzerfreundlicher Name für die Fähigkeit.DESCRIPTION: eine kurze Zusammenfassung, in der die Fähigkeiten des Skills erläutert werden.BASE64_ZIP_BYTES: die base64-codierte Stringdarstellung Ihres lokalen ZIP-Archivs.
JSON-Text der Anfrage (Import aus Cloud Storage)
Alternativ können Sie mit
gcsSourceeinen Skill aus einem Archiv erstellen, das in einem Cloud Storage-Bucket gespeichert ist:{ "displayName": "DISPLAY_NAME", "description": "DESCRIPTION", "type": "SIMPLE", "targetState": "TARGET_STATE_DISABLED", "initialRevision": { "gcsSource": { "uri": "gs://BUCKET_NAME/SKILL_PACKAGE.zip" } } }Ersetzen Sie Folgendes:
DISPLAY_NAME: Ein nutzerfreundlicher Name für die Fähigkeit.DESCRIPTION: eine kurze Zusammenfassung, in der die Fähigkeiten des Skills erläutert werden.BUCKET_NAME: der Name des Cloud Storage-Bucket, der das ZIP-Bundle enthält.SKILL_PACKAGE: der Name des Skill-Pakets, das die Skill-Nutzlast enthält.
curl-Befehl (lokaler Dateiupload)curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -d '{ "displayName": "DISPLAY_NAME", "description": "DESCRIPTION", "type": "SIMPLE", "targetState": "TARGET_STATE_DISABLED", "initialRevision": { "archiveUploadSource": { "archiveContent": "'"$(base64 -w0 local_skill.zip)"'" } } }' \ "https://agentregistry.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/skills?skillId=SKILL_ID"Ersetzen Sie Folgendes:
DISPLAY_NAME: Ein nutzerfreundlicher Name für die Fähigkeit.DESCRIPTION: eine kurze Zusammenfassung, in der die Fähigkeiten des Skills erläutert werden.PROJECT_ID: Projekt-ID.LOCATION: der Standort der Registry.SKILL_ID: eine eindeutige Kennung für den Skill-Container.
Ersetzen Sie für einen Dateiupload in einen Cloud Storage-Bucket den JSON-Anfragetext durch die entsprechenden Felder und Werte.
Wenn Sie einen Skill mit einer ersten Version erstellen, legt die Agent Registry die erste Version als Standardversion des übergeordneten Skills fest und ändert den Status des Skills basierend auf dem Zielstatus und der Scanrichtlinie:
- Wenn der Zielstatus
TARGET_STATE_ACTIVEund die ScanrichtlinieDISABLEDoderENABLED_NONBLOCKINGist, wechselt der Skill in den StatusSTATE_ACTIVE, wenn der Vorgang mit langer Ausführungszeit (LRO) abgeschlossen ist. - Wenn der Zielstatus
TARGET_STATE_ACTIVEund die ScanrichtlinieENABLED_BLOCKING(Standard) ist, wechselt der Skill in den StatusSTATE_DRAFT, wenn der LRO abgeschlossen ist. Wenn der Sicherheitsscan im Hintergrund abgeschlossen ist, wechselt der übergeordnete Skill nur dann zuSTATE_ACTIVE, wenn der Scan keine Ergebnisse liefert und der übergeordnete Skill noch inSTATE_DRAFTist, wobei die Standardversion noch auf die ursprüngliche Version verweist. - Wenn der Zielstatus
TARGET_STATE_DISABLEDoderTARGET_STATE_DRAFTist, beginnt der Skill inSTATE_DISABLEDoderSTATE_DRAFT. Damit der Skill später für die Agentenerkennung verfügbar ist, müssen Sie die Standardversion festlegen und den Zielstatus aufTARGET_STATE_ACTIVEaktualisieren. Eine Anleitung finden Sie unter Skills verwalten.
- Wenn der Zielstatus
Die Skills, die Sie oder andere Nutzer erstellen, werden automatisch dem Standard-Publisher private zugewiesen, um Namenskonflikte mit von Google verwalteten Skills zu vermeiden.
Aus diesem Grund wird die veröffentlichte ID einer bestimmten Fähigkeit zu private-SKILL_ID. Sie können beim Erstellen eines Skills keinen benutzerdefinierten Publisher angeben.
Wenn Sie beispielsweise einen Skill mit der ID workspace-tools erstellen, wird der Ressourcenname als projects/PROJECT_NUMBER/locations/LOCATION/skills/private-workspace-tools erstellt.
Die Skill-ID wird als urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-workspace-tools zugewiesen.
Sie müssen die private-workspace-tools Publisher-ID für alle nachfolgenden Skill-Vorgänge verwenden.
Wenn Sie einen Skill erstellen, konfiguriert Agent Registry automatisch eine IAM-Zulassungsrichtlinie auf Ressourcenebene für die neue Skill-Ressource:
- Ihrem Hauptkonto wird die Rolle „Agent Registry API Admin“ (
roles/agentregistry.admin) für den Skill zugewiesen. - Wenn das Projekt zu einer Organisation gehört, wird der Hauptkontogruppe, die Ihre Agent-Arbeitslasten im Projekt darstellt, die Rolle „Agent Registry API Viewer“ (
roles/agentregistry.viewer) für den Skill zugewiesen.
Informationen zum Freigeben eines Skills für andere Nutzer, Gruppen, Dienstkonten oder Agent-Arbeitslasten finden Sie unter Zugriff auf einen Skill verwalten.
Nächste Schritte
- Informationen zum Verwalten Ihrer registrierten Skills
- Informationen zum Hinzufügen und Verwalten von Skill-Versionen
- Informationen zum Scannen von Skills auf Sicherheitsprobleme
- Details zu verifizierten Publishern