Skill-Überarbeitungen verwalten

In der Agent Registry stellt eine Skill-Version einen unveränderlichen, versionierten Snapshot eines Skill-Pakets dar. Wenn Sie den Code oder die Anweisungen eines Skills aktualisieren, erstellen Sie eine neue Version. Diese entkoppelte Architektur ermöglicht die Versionsverwaltung Ihrer Skills.

In diesem Dokument wird beschrieben, wie Sie Skill-Versionen erstellen und verwalten. Informationen zum Aktualisieren der Standardversion eines bestimmten Skills finden Sie unter Skill-Metadaten oder Standardversion aktualisieren.

Hinweis

Bevor Sie beginnen, richten Sie die Agent Registry ein und registrieren Sie einen eigenständigen Skill. Sie benötigen die Projekt-ID, um diese Aufgaben auszuführen.

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 Verwalten von Skill-Versionen 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.

Skill-Version erstellen

Beim Erstellen einer neuen Version wird eine neue ZIP-Nutzlast in den vorhandenen Skill-Container hochgeladen. Wenn Sie eine Skill-Version erstellen, wird sie automatisch zur aktiven Version des Skills. Sie können die Standardversion eines Skills jedoch jederzeit aktualisieren. Nur aktive Versionen können heruntergeladen werden.

Die maximale ZIP-Dateigröße einer Skill-Version beträgt 500 KB.

Console

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

    Zu Agent Registry

  2. Wählen Sie den Tab Skills aus und klicken Sie auf den Namen Ihres Skills.
  3. Suchen Sie auf der Seite Skill-Details die Tabelle Versionsverlauf.
  4. Klicken Sie auf Version hinzufügen.

  5. Wählen Sie im Bereich Version hinzufügen eine der folgenden Optionen aus:

    • Datei:Laden Sie das Paket oder die ZIP-Datei mit Ihrem Code oder der Datei mit Prompt-Anweisungen (SKILL.md) hoch. Sie können auf Durchsuchen klicken, um die Datei in Ihrer lokalen Umgebung zu suchen.

    • Bucket:Geben Sie einen Cloud Storage-URI (gs://...) mit einem gültigen ZIP-Bundle an. Sie können auf Durchsuchen klicken, um die Datei in Ihren Cloud Storage-Buckets zu suchen.

  6. Klicken Sie auf Erstellen.

Auf der Seite Skill-Details wird die Skill-Version in der Tabelle Versionsverlauf angezeigt.

gcloud

Sie können eine Skill-Version erstellen, indem Sie entweder eine lokale ZIP-Datei hochladen oder ein in Cloud Storage gespeichertes Paket importieren.

Ersetzen Sie Folgendes:

  • REVISION_ID: Die ID, die Sie der Skill-Version zuweisen möchten.
  • SKILL_ID: Die ID des Skills, den Sie für die Version verwenden.
  • PROJECT_ID: Die Projekt-ID.

  • LOCATION: Der Registrierungsstandort.

  • Lokale ZIP-Datei hochladen: So erstellen Sie eine Skill-Version mit einer lokalen ZIP Nutzlast:

    gcloud alpha agent-registry skills revisions create REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --payload="LOCAL_ZIP_PATH"

    Ersetzen Sie LOCAL_ZIP_PATH durch den Pfad zu Ihrem gepackten Skill-Archiv auf Ihrem lokalen Computer.

  • Aus einem Cloud Storage-Bucket importieren: So erstellen Sie eine Skill-Version mit einem ZIP-Archiv, das in einem Cloud Storage-Bucket gehostet wird:

    gcloud alpha agent-registry skills revisions create REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --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-Version enthält.

REST

Senden Sie eine POST-Anfrage an die Sammlung „Revisions“, um eine Skill-Version zu erstellen. Sie können die ZIP-Nutzlast direkt hochladen oder auf einen Cloud Storage-Pfad verweisen.

  • Lokale ZIP-Datei hochladen: Geben Sie archiveUploadSource mit den Base64-codierten ZIP-Bytes im Anfragetext an. Sie können den Inline-Befehl base64 in curl verwenden:

    curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -d '{
        "archiveUploadSource": {
          "archiveContent": "$(base64 -w0 local_skill.zip)"
        }
      }' \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions?skillRevisionId=REVISION_ID"

  • Aus einem Cloud Storage-Bucket importieren: Geben Sie im Anfragetext gcsSource an, der auf Ihren Bucket-Pfad verweist:

    curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -d '{
        "gcsSource": {
          "uri": "gs://BUCKET_NAME/SKILL_PACKAGE.zip"
        }
      }' \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions?skillRevisionId=REVISION_ID"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die Projekt-ID.
  • LOCATION: Der Registrierungsstandort.
  • SKILL_ID: Die ID des Skill-Containers.
  • REVISION_ID: Die ID, die Sie dieser Version zuweisen möchten.
  • BUCKET_NAME: Der Name des Cloud Storage-Bucket, der die ZIP-Datei enthält.
  • SKILL_PACKAGE: Der Name des ZIP-Pakets.

Versionen auflisten und beschreiben

Sie können die Liste aller Versionen für einen Skill aufrufen und die zugehörigen Metadaten prüfen. Wenn Sie die Standardversion eines Skills aktualisieren möchten, lesen Sie den Hilfeartikel Skill-Metadaten oder Standardversion aktualisieren.

So listen Sie Versionen auf und rufen Details dazu auf:

Console

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

    Zu Agent Registry

  2. Wählen Sie den Tab Skills aus und klicken Sie auf den Namen Ihres Skills.
  3. Suchen Sie auf der Seite Skill-Details die Tabelle Versionsverlauf.
  4. Prüfen Sie die Versions-IDs, die Erstellungszeit, den Status der Version und die verfügbaren Aktionen.

gcloud

So listen Sie alle Versionen für einen Skill auf:

gcloud alpha agent-registry skills revisions list \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION

So rufen Sie die Metadaten einer bestimmten Version auf:

gcloud alpha agent-registry skills revisions describe REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION

REST

So listen Sie Versionen auf:

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

So rufen Sie Metadaten für eine einzelne Version auf:

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

Nutzlast der Version herunterladen

Sie können die kompilierte ZIP-Datei-Nutzlast einer bestimmten Version zur lokalen Überprüfung oder Fehlerbehebung herunterladen.

Damit Sie die Nutzlast herunterladen können, müssen beide folgenden Bedingungen erfüllt sein:

So laden Sie die Nutzlast einer aktiven Version herunter:

Console

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

    Zu Agent Registry

  2. Wählen Sie den Tab Skills aus und klicken Sie auf den Namen Ihres Skills.
  3. Suchen Sie auf der Seite Skill-Details die Tabelle Versionsverlauf.
  4. Suchen Sie die Version, die Sie herunterladen möchten.
  5. Klicken Sie in der Spalte „Aktionen“ auf Herunterladen. Die ZIP-Nutzlast wird auf Ihren lokalen Computer heruntergeladen.

gcloud

Führen Sie den Befehl describe mit dem Flag --alt=media aus und leiten Sie die Ausgabe in eine Datei um, um die Archivnutzlast einer Version herunterzuladen:

gcloud alpha agent-registry skills revisions describe REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --flags="alt=media" > skill_payload.zip

REST

Senden Sie eine GET-Anfrage an die Ressourcen-URL der Version und fügen Sie den Abfrageparameter alt=media hinzu. Sie müssen das Flag -L mit curl verwenden, um HTTP-Weiterleitungsstreams zu folgen:

curl -L -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -o skill_payload.zip \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID?alt=media"

Bestimmte Version löschen

Wenn Sie eine bestimmte Version löschen, werden die ZIP-Nutzlast und der Metadatenverlauf aus der Agent Registry entfernt.

Das Löschen einzelner Versionen ist in der Regel Administratoren vorbehalten. Sie können keine Version löschen, die als Standardversion des Skills festgelegt ist. Informationen zum Aktualisieren der Standardversion eines Skills finden Sie unter Skill-Metadaten oder Standardversion aktualisieren.

So löschen Sie eine bestimmte Version:

Console

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

    Zu Agent Registry

  2. Wählen Sie den Tab Skills aus und klicken Sie auf den Namen Ihres Skills.
  3. Suchen Sie auf der Seite Skill-Details die Tabelle Versionsverlauf.
  4. Suchen Sie die Version, die Sie löschen möchten.
  5. Klicken Sie in der Spalte „Aktionen“ auf Löschen und bestätigen Sie die Aktion.

gcloud 

gcloud alpha agent-registry skills revisions delete REVISION_ID \
  --skill=SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION

REST 

curl -X DELETE \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"

Nächste Schritte