Mengelola revisi keahlian

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Di Agent Registry, revisi skill memungkinkan Anda mengontrol versi skill mandiri sebagai snapshot yang tidak dapat diubah tanpa mengganggu agen yang aktif. Setiap skill memiliki revisi default dan dapat berisi beberapa revisi skill berversi. Saat memperbarui petunjuk atau skrip opsional suatu skill, Anda dapat membuat, mencantumkan, memeriksa, mendownload, dan menghapus revisi skill di Agent Registry. Untuk mengetahui informasi tentang cara memperbarui revisi default keahlian, lihat Memperbarui metadata keahlian atau revisi default.

Sebelum memulai

1. Menyiapkan Agent Registry.

2. Dapatkan project ID untuk project tata kelola tempat Agent Registry diaktifkan.

3. Daftarkan keahlian mandiri.

4. Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, siapkan lingkungan gcloud CLI Anda.

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 tata kelola tempat Agent Registry diaktifkan:

• Mencantumkan, melihat, dan mendownload revisi keterampilan: Agent Registry API Viewer (roles/agentregistry.viewer)
• Membuat, memperbarui, dan menghapus revisi skill: Agent Registry User (roles/agentregistry.user)
• Mengelola revisi keterampilan dan resource Agent Registry lainnya: Agent Registry API Editor (roles/agentregistry.editor)

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 mungkin juga 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 container skill yang ada. Jika validasi berhasil, revisi akan memasuki status Active. Untuk menyajikan revisi baru sebagai revisi default untuk skill, update revisi default skill agar mengarah ke revisi aktif baru. Hanya revisi dalam status Aktif yang dapat didownload.

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

Ukuran file ZIP maksimum untuk revisi keterampilan adalah 500 KB.

Konsol

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

   Buka Agent Registry

2. Pilih tab Skills, lalu klik nama keahlian Anda.
3. Di halaman Skill Details, temukan tabel histori versi.
4. Klik Add version.

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

   • File: upload paket atau file ZIP yang berisi file petunjuk SKILL.md dan skrip opsional. Anda dapat mengklik Browse 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.

     Penting: Sebelum Agent Registry dapat mengakses file keahlian Anda, Anda harus memberikan akses agen layanannya ke file ZIP di bucket Cloud Storage Anda. Agen layanan Agent Registry menggunakan format berikut: [e-mail]. Jika agen layanan ini tidak ada di project Anda, buat agen layanan untuk Agent Registry API. Untuk mengetahui petunjuknya, lihat Membuat dan memberikan peran ke agen layanan. Agen layanan memerlukan izin storage.objects.get pada bucket Cloud Storage yang berisi file ZIP Anda. Untuk mengetahui petunjuk tentang cara memberikan izin Identity and Access Management (IAM) pada resource bucket, lihat IAM untuk Cloud Storage.

6. Klik Create.

Halaman Skill Details menampilkan revisi skill di tabel Version history.

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 keterampilan yang Anda gunakan untuk revisi. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
• PROJECT_ID: project ID.

• LOCATION: lokasi registry.

• Mengupload file ZIP lokal: untuk membuat revisi skill menggunakan payload ZIP lokal, jalankan perintah gcloud alpha agent-registry skills revisions create:

  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 skill yang dipaketkan di komputer lokal Anda.

• Mengimpor dari bucket Cloud Storage: untuk membuat revisi skill menggunakan file ZIP yang dihosting di bucket Cloud Storage, jalankan perintah gcloud alpha agent-registry skills revisions create:

  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"
  

  Penting: Sebelum Agent Registry dapat mengakses file skill Anda, Anda harus memberikan akses agen layanannya ke arsip ZIP di bucket Cloud Storage Anda. Agen layanan Agent Registry menggunakan format berikut: [e-mail]. Jika agen layanan ini tidak ada dalam project Anda, buat agen layanan untuk Agent Registry API. Untuk mengetahui petunjuknya, lihat Membuat dan memberikan peran ke agen layanan. Agen layanan memerlukan izin storage.objects.get pada bucket Cloud Storage yang berisi file ZIP Anda. Untuk mengetahui petunjuk tentang cara memberikan izin IAM pada resource bucket, lihat IAM untuk Cloud Storage.

  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 keahlian, kirim permintaan POST ke koleksi revisi. Anda dapat mengupload payload ZIP secara langsung atau mengarahkannya 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 dalam 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"
  

Penting: Sebelum Agent Registry dapat mengakses file skill Anda, Anda harus memberikan akses agen layanannya ke arsip ZIP di bucket Cloud Storage Anda. Agen layanan Agent Registry menggunakan format berikut: [e-mail]. Jika agen layanan ini tidak ada dalam project Anda, buat agen layanan untuk Agent Registry API. Untuk mengetahui petunjuknya, lihat Membuat dan memberikan peran ke agen layanan. Agen layanan memerlukan izin storage.objects.get pada bucket Cloud Storage yang berisi file ZIP Anda. Untuk mengetahui petunjuk tentang cara memberikan izin IAM pada resource bucket, lihat IAM untuk Cloud Storage.

Ganti kode berikut:

• PROJECT_ID: project ID.
• LOCATION: lokasi registry.
• SKILL_ID: ID penampung keterampilan. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-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 suatu skill dan memeriksa metadatanya. Jika Anda ingin memperbarui revisi default keahlian, lihat Memperbarui metadata keahlian atau revisi default.

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 Skills, lalu klik nama keahlian Anda.
3. Di halaman Skill Details, temukan tabel histori versi.
4. Tinjau ID versi, waktu pembuatan, status revisi, dan tindakan yang tersedia.

gcloud

Untuk menampilkan semua revisi skill, jalankan perintah gcloud alpha agent-registry skills revisions list:

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

Untuk mendeskripsikan metadata revisi tertentu, jalankan perintah gcloud alpha agent-registry skills revisions describe:

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

Ganti kode berikut:

• SKILL_ID: ID penampung keterampilan. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
• PROJECT_ID: project ID.
• LOCATION: lokasi registry.
• REVISION_ID: ID revisi keahlian.

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"

Ganti kode berikut:

• PROJECT_ID: project ID.
• LOCATION: lokasi registry.
• SKILL_ID: ID penampung keterampilan. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
• REVISION_ID: ID revisi keahlian.

Download payload revisi

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

Untuk mendownload payload, kedua kondisi berikut harus terpenuhi:

• Skill: skill harus dalam status Active atau Deprecated. Untuk mengubah status target skill, lihat Mengelola status siklus proses skill.
• Revisi keahlian: revisi harus dalam status Aktif. Revisi dalam status Gagal atau Membuat tidak dapat didownload. Untuk meninjau status revisi keahlian, cantumkan dan deskripsikan revisi.

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 Skills, lalu klik nama keahlian Anda.
3. Di halaman Skill Details, 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 gcloud alpha agent-registry skills revisions download dan tentukan jalur tujuan:

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

Ganti kode berikut:

• REVISION_ID: ID revisi skill yang akan didownload.
• SKILL_ID: ID penampung keterampilan. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
• PROJECT_ID: project ID.
• LOCATION: lokasi registry.

REST

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

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"

Ganti kode berikut:

• PROJECT_ID: project ID.
• LOCATION: lokasi registry.
• SKILL_ID: ID penampung keterampilan. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
• REVISION_ID: ID revisi skill yang akan didownload.

Menghapus revisi tertentu

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

Penghapusan revisi individual biasanya dibatasi untuk administrator. Jika Anda menghapus revisi yang ditetapkan sebagai revisi default keahlian, Agent Registry akan menghapus pointer defaultRevision dan mentransisikan keahlian Active ke status Disabled. Agar skill tetap aktif, perbarui revisi default skill untuk mengarah ke revisi aktif lainnya sebelum menghapus revisi default sebelumnya.

Untuk menghapus revisi tertentu, ikuti langkah-langkah berikut:

Konsol

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

   Buka Agent Registry

2. Pilih tab Skills, lalu klik nama keahlian Anda.
3. Di halaman Skill Details, temukan tabel histori versi.
4. Temukan revisi yang ingin Anda hapus.
5. Di kolom Actions, klik Delete dan konfirmasi tindakan.

gcloud

Untuk menghapus revisi, jalankan perintah gcloud alpha agent-registry skills revisions delete:

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

Ganti kode berikut:

• REVISION_ID: ID revisi keahlian yang akan dihapus.
• SKILL_ID: ID penampung keterampilan. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
• PROJECT_ID: project ID.
• LOCATION: lokasi registry.

REST

Untuk menghapus revisi, kirim permintaan DELETE:

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"

Ganti kode berikut:

• PROJECT_ID: project ID.
• LOCATION: lokasi registry.
• SKILL_ID: ID penampung keterampilan. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
• REVISION_ID: ID revisi keahlian yang akan dihapus.

Langkah berikutnya

• Pelajari cara menjelajahi penerbit terverifikasi.
• Pahami kuota dan batas untuk revisi skill.