Mengelola revisi keahlian

Di Agent Registry, revisi keahlian merepresentasikan snapshot paket keahlian yang tidak dapat diubah dan diberi versi. Saat memperbarui kode atau petunjuk skill, Anda akan membuat revisi baru. Arsitektur yang tidak terikat ini memungkinkan kontrol versi untuk skill Anda.

Dokumen ini menjelaskan cara membuat dan mengelola revisi keterampilan. Untuk mengetahui informasi tentang cara memperbarui revisi default skill tertentu, lihat Memperbarui metadata skill atau revisi default.

Sebelum memulai

Sebelum memulai, siapkan Agent Registry dan daftarkan skill mandiri. Anda memerlukan project ID untuk melakukan tugas ini.

Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan gcloud CLI.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola revisi skill di Agent Registry, minta administrator untuk memberi Anda peran IAM berikut pada project:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Peran Agent Registry lainnya juga dapat mencakup izin yang diperlukan untuk melihat, mendownload, membuat, memperbarui, dan menghapus revisi skill. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin Agent Registry.

Membuat revisi keahlian

Membuat revisi baru akan mengupload payload ZIP baru ke penampung skill yang ada. Saat Anda membuat revisi keahlian, revisi tersebut akan otomatis menjadi versi keahlian yang aktif. Namun, Anda dapat memperbarui revisi default skill kapan saja. Hanya revisi yang aktif yang dapat didownload.

Untuk mengetahui informasi tentang harga dan biaya fitur untuk keterampilan, lihat harga Agent Registry.

Ukuran file ZIP maksimum untuk revisi skill adalah 500 KB.

Konsol

  1. Di konsol Google Cloud , buka halaman Agent Registry:

    Buka Agent Registry

  2. Pilih tab Keahlian, lalu klik nama keahlian Anda.
  3. Di halaman Detail Skill, temukan tabel Histori versi.
  4. Klik Tambahkan versi.

  5. Di panel Tambahkan versi, pilih salah satu opsi berikut:

    • File: Upload paket atau file ZIP yang berisi kode atau file petunjuk perintah (SKILL.md). Anda dapat mengklik Telusuri untuk menemukan file di lingkungan lokal Anda.

    • Bucket: Berikan Cloud Storage URI (gs://...) yang berisi paket ZIP yang valid. Anda dapat mengklik Browse untuk menemukan file di bucket Cloud Storage Anda.

  6. Klik Create.

Halaman Detail Skill menampilkan revisi skill di tabel Histori versi.

gcloud

Anda dapat membuat revisi skill dengan mengupload file ZIP lokal atau mengimpor paket yang disimpan di Cloud Storage.

Ganti kode berikut:

  • REVISION_ID: ID yang ingin Anda tetapkan ke revisi skill.
  • SKILL_ID: ID skill yang Anda gunakan untuk revisi.
  • PROJECT_ID: Project ID.

  • LOCATION: Lokasi registri.

  • Mengupload file ZIP lokal: Untuk membuat revisi skill menggunakan payload ZIP lokal:

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

    Ganti LOCAL_ZIP_PATH dengan jalur ke arsip keterampilan yang dikemas di mesin lokal Anda.

  • Mengimpor dari bucket Cloud Storage: Untuk membuat revisi skill menggunakan arsip ZIP yang dihosting di bucket Cloud Storage:

    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"

    Ganti kode berikut:

    • BUCKET_NAME: Nama bucket Cloud Storage yang berisi paket ZIP.
    • SKILL_PACKAGE: Nama paket skill yang berisi revisi skill.

REST

Untuk membuat revisi skill, kirim permintaan POST ke koleksi revisi. Anda dapat mengupload payload ZIP secara langsung atau mengarahkan ke jalur Cloud Storage.

  • Mengupload file ZIP lokal: Tentukan archiveUploadSource yang berisi byte ZIP berenkode base64 dalam isi permintaan. Anda dapat menggunakan perintah base64 inline di curl:

    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"

  • Mengimpor dari bucket Cloud Storage: Tentukan gcsSource di isi permintaan yang mengarah ke jalur bucket Anda:

    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"

Ganti kode berikut:

  • PROJECT_ID: Project ID.
  • LOCATION: Lokasi registri.
  • SKILL_ID: ID penampung skill.
  • REVISION_ID: ID yang ingin Anda tetapkan ke revisi ini.
  • BUCKET_NAME: Nama bucket Cloud Storage yang berisi ZIP.
  • SKILL_PACKAGE: Nama paket ZIP.

Mencantumkan dan menjelaskan revisi

Anda dapat melihat daftar semua revisi untuk skill dan memeriksa metadatanya. Jika Anda ingin memperbarui revisi default skill, lihat Memperbarui metadata atau revisi default skill.

Untuk mencantumkan dan melihat detail revisi, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Agent Registry:

    Buka Agent Registry

  2. Pilih tab Keahlian, lalu klik nama keahlian Anda.
  3. Di halaman Detail Skill, temukan tabel Histori versi.
  4. Tinjau ID versi, waktu pembuatan, status revisi, dan tindakan yang tersedia.

gcloud

Untuk mencantumkan semua revisi untuk suatu keahlian:

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

Untuk mendeskripsikan metadata revisi tertentu:

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

REST

Untuk mencantumkan revisi:

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"

Untuk mendapatkan metadata untuk satu revisi:

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"

Mendownload payload revisi

Anda dapat mendownload payload file ZIP yang dikompilasi dari revisi tertentu untuk verifikasi atau proses debug lokal.

Untuk mendownload payload, kedua kondisi berikut harus dipenuhi:

Untuk mendownload payload revisi dari revisi aktif, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Agent Registry:

    Buka Agent Registry

  2. Pilih tab Keahlian, lalu klik nama keahlian Anda.
  3. Di halaman Detail Skill, temukan tabel Histori versi.
  4. Temukan revisi yang ingin Anda download.
  5. Di kolom tindakan, klik Download. Payload ZIP akan didownload ke komputer lokal Anda.

gcloud

Untuk mendownload payload arsip revisi, jalankan perintah describe dengan flag --alt=media dan alihkan output ke file:

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

REST

Kirim permintaan GET ke URL resource revisi dengan menambahkan parameter kueri alt=media. Anda harus menggunakan tanda -L dengan curl untuk mengikuti pengalihan HTTP stream:

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"

Menghapus revisi tertentu

Menghapus revisi tertentu akan menghapus payload ZIP dan histori metadata dari Agent Registry.

Penghapusan revisi individual biasanya dibatasi untuk administrator. Anda tidak dapat menghapus revisi yang ditetapkan sebagai revisi default skill. Untuk memperbarui revisi default skill, lihat Memperbarui metadata skill atau revisi default.

Untuk menghapus revisi tertentu, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Agent Registry:

    Buka Agent Registry

  2. Pilih tab Keahlian, lalu klik nama keahlian Anda.
  3. Di halaman Detail Skill, temukan tabel Histori versi.
  4. Temukan revisi yang ingin Anda hapus.
  5. Di kolom tindakan, klik Hapus dan konfirmasi tindakan.

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"

Langkah berikutnya