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 Revision. Diese entkoppelte Architektur ermöglicht die Versionsverwaltung Ihrer Skills.

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

Hinweis

Bevor Sie beginnen, müssen Sie die Agent Registry einrichten und einen eigenständigen Skill registrieren. 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 einrichten.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Verwalten von Skill-Revisionen in der Agent Registry haben:

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 Anzeigen, Herunterladen, Erstellen, Aktualisieren und Löschen von Skill-Revisionen erforderlich sind. Weitere Informationen finden Sie unter Rollen und Berechtigungen für die Agent-Registrierung.

Skill-Version erstellen

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

Informationen zu Preisen und Funktionskosten für Skills finden Sie unter Preise für die Agent Registry.

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

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 und klicken Sie auf den Namen Ihres Skills.
  3. Suchen Sie auf der Seite Skill Details (Skill-Details) die Tabelle Version history (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 finden.

  6. Klicken Sie auf Erstellen.

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

gcloud

Sie können eine Skill-Überarbeitung 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-Revision zuweisen möchten.
  • SKILL_ID: Die ID des Skills, den Sie für die Überarbeitung verwenden.
  • PROJECT_ID: die Projekt-ID

  • LOCATION: Der Speicherort der Registrierung.

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

    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-Revision 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-Revision enthält.

REST

Wenn Sie eine Skill-Version erstellen möchten, senden Sie eine POST-Anfrage an die Sammlung „revisions“. 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, um auf den Bucket-Pfad zu verweisen:

    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 Speicherort der Registrierung.
  • SKILL_ID: Die ID des Skill-Containers.
  • REVISION_ID: Die ID, die Sie dieser Überarbeitung 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 Überarbeitungen für einen Skill aufrufen und die zugehörigen Metadaten ansehen. Wenn Sie die Standardversion eines Skills aktualisieren möchten, lesen Sie den Abschnitt Skill-Metadaten oder Standardversion aktualisieren.

So rufen Sie eine Liste mit Überarbeitungen und Details zu einer Überarbeitung 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 und klicken Sie auf den Namen Ihres Skills.
  3. Suchen Sie auf der Seite Skill Details (Skill-Details) die Tabelle Version history (Versionsverlauf).
  4. Sehen Sie sich die Versions-IDs, die Erstellungszeit, den Überarbeitungsstatus und die verfügbaren Aktionen an.

gcloud

So listen Sie alle Überarbeitungen für einen Skill auf:

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

So beschreiben Sie die Metadaten einer bestimmten Version:

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 Überarbeitung ab:

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 für Revision herunterladen

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

Damit die Nutzlast heruntergeladen werden kann, müssen beide der folgenden Bedingungen erfüllt sein:

So laden Sie die Überarbeitungs-Payload einer aktiven Überarbeitung herunter:

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 und klicken Sie auf den Namen Ihres Skills.
  3. Suchen Sie auf der Seite Skill Details (Skill-Details) die Tabelle Version history (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 an eine Datei weiter, um die Archivnutzlast einer Revision 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 Überarbeitung 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 Revision löschen, werden die ZIP-Nutzlast und der Metadatenverlauf aus der Agent Registry entfernt.

Das Löschen einzelner Überarbeitungen ist in der Regel auf Administratoren beschränkt. 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:

    Zur 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 (Skill-Details) die Tabelle Version history (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