Skill-Überarbeitungen verwalten

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 die Tabelle Versionsverlauf.
4. Klicken Sie auf add 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 Ihrer SKILL.md-Anweisungsdatei und optionalen Skripts hoch. Klicken Sie auf Durchsuchen, um die Datei in Ihrer lokalen Umgebung zu finden.

   • Bucket: Geben Sie einen gs://...-Cloud Storage-URI an, der ein gültiges ZIP-Bundle enthält. Klicken Sie auf Durchsuchen, um die Datei in Ihren Cloud Storage-Buckets zu finden.

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 Überarbeitung verwenden. Geben Sie für manuell registrierte Skills das Präfix private- an, z. B. private-my-skill.
• PROJECT_ID: Projekt-ID.

• LOCATION: der Standort der Registry.

• Lokale ZIP-Datei hochladen: Wenn Sie eine Skill-Überarbeitung mit einer lokalen ZIP-Nutzlast erstellen möchten, führen Sie den Befehl gcloud alpha agent-registry skills revisions create aus:

  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 zum gepackten Skill-Archiv auf Ihrem lokalen Computer.

• Aus einem Cloud Storage-Bucket importieren: Wenn Sie eine Skill-Version mit einem ZIP-Archiv erstellen möchten, das in einem Cloud Storage-Bucket gehostet wird, führen Sie den Befehl gcloud alpha agent-registry skills revisions create aus:

  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

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 im Anfragetext archiveUploadSource mit den Base64-codierten ZIP-Bytes 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, das auf den 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: Projekt-ID.
• LOCATION: der Standort der Registry.
• SKILL_ID: die ID des Skill-Containers. Geben Sie bei manuell registrierten Skills das Präfix private- an, z. B. private-my-skill.
• 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.

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 die Tabelle Versionsverlauf.
4. Prüfen Sie die Versions-IDs, die Erstellungszeit, den Versionsstatus und die verfügbaren Aktionen.

gcloud

Führen Sie den Befehl gcloud alpha agent-registry skills revisions list aus, um alle Versionen für einen Skill aufzulisten:

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

Führen Sie den Befehl gcloud alpha agent-registry skills revisions describe aus, um die Metadaten einer bestimmten Version zu beschreiben:

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

Ersetzen Sie Folgendes:

• SKILL_ID: die ID des Skill-Containers. Geben Sie bei manuell registrierten Skills das Präfix private- an, z. B. private-my-skill.
• PROJECT_ID: Projekt-ID.
• LOCATION: der Standort der Registry.
• REVISION_ID: die ID der Skill-Version.

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 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"

Ersetzen Sie Folgendes:

• PROJECT_ID: Projekt-ID.
• LOCATION: der Standort der Registry.
• SKILL_ID: die ID des Skill-Containers. Geben Sie bei manuell registrierten Skills das Präfix private- an, z. B. private-my-skill.
• REVISION_ID: die ID der Skill-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 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 gcloud alpha agent-registry skills revisions download aus und geben Sie den Zielpfad an, um die Archivnutzlast einer Version herunterzuladen:

gcloud alpha agent-registry skills revisions download REVISION_ID \
    --skill=SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --destination="./skill_payload.zip"

Ersetzen Sie Folgendes:

• REVISION_ID: die ID der herunterzuladenden Skill-Version.
• SKILL_ID: die ID des Skill-Containers. Geben Sie bei manuell registrierten Skills das Präfix private- an, z. B. private-my-skill.
• PROJECT_ID: Projekt-ID.
• LOCATION: der Standort der Registry.

REST

Senden Sie eine GET-Anfrage an die Ressourcen-URL der Version und fügen Sie den Suchparameter 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"

Ersetzen Sie Folgendes:

• PROJECT_ID: Projekt-ID.
• LOCATION: der Standort der Registry.
• SKILL_ID: die ID des Skill-Containers. Geben Sie bei manuell registrierten Skills das Präfix private- an, z. B. private-my-skill.
• REVISION_ID: die ID der herunterzuladenden Skill-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 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

Führen Sie den Befehl gcloud alpha agent-registry skills revisions delete aus, um eine Version zu löschen:

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

Ersetzen Sie Folgendes:

• REVISION_ID: die ID der zu löschenden Skill-Version.
• SKILL_ID: die ID des Skill-Containers. Geben Sie bei manuell registrierten Skills das Präfix private- an, z. B. private-my-skill.
• PROJECT_ID: Projekt-ID.
• LOCATION: der Standort der Registry.

REST

Senden Sie eine DELETE-Anfrage, um eine Version zu löschen:

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"

Ersetzen Sie Folgendes:

• PROJECT_ID: Projekt-ID.
• LOCATION: der Standort der Registry.
• SKILL_ID: die ID des Skill-Containers. Geben Sie bei manuell registrierten Skills das Präfix private- an, z. B. private-my-skill.
• REVISION_ID: die ID der zu löschenden Skill-Version.