Ringkasan Skill Registry

Registry Keterampilan berfungsi sebagai repositori yang aman, pribadi, dan berlatensi rendah untuk mengelola keterampilan agen. Setiap keterampilan adalah paket mandiri, yang mencakup petunjuk struktural, kode yang dapat dieksekusi, dan dokumentasi, yang dirancang untuk memperluas kemampuan agen.

Dengan memusatkan keterampilan ini, Registry Keterampilan memungkinkan agen menemukan dan memuat kemampuan yang paling relevan secara dinamis berdasarkan maksud pengguna, sehingga mengoptimalkan performa dan memastikan lingkungan eksekusi yang aman.

Konsep utama

Registry Keterampilan memperkenalkan dua entity API standar tingkat atas untuk mengelola siklus proses dan pembuatan versi:

Konsep Deskripsi
Keterampilan Entitas tingkat atas yang dapat diubah dan berisi metadata (seperti nama tampilan, stempel waktu pembuatan dan pembaruan, serta label), revisi default, dan konten keterampilan.

Untuk contoh struktur keterampilan yang diharapkan, lihat file SKILL.md di repositori Keterampilan Google Cloud.
Revisi keterampilan Snapshot yang tidak dapat diubah dari versi keterampilan tertentu. Revisi ini mencakup nama, deskripsi, dan referensi yang tidak dapat diubah ke resource keterampilan induk.

Validasi payload keterampilan

Untuk memastikan agen dapat menggunakan konten keterampilan yang valid, sistem akan otomatis memverifikasi semua payload keterampilan selama pembuatan atau pembaruan. Validasi ini dilakukan secara asinkron.

Operasi asinkron akan gagal dengan error validasi jika sistem mendeteksi salah satu hal berikut:

  • File tersebut bukan file zip yang tepat atau tidak memiliki informasi penting.
  • File zip kosong.
  • File zip memiliki lebih dari 10.000 item di dalamnya.
  • Nama file atau folder dalam zip berisi .. atau dimulai dengan / atau \\.
  • File zip berisi link simbolis.
  • Ada nama file atau folder duplikat dalam file zip.
  • Ukuran total semua file di dalam zip lebih dari 500 MB saat diekstrak.
  • File terlalu banyak dikompresi, dengan rasio kompresi lebih dari 100.
  • Folder di dalam zip memiliki kedalaman lebih dari 8 level.
  • File zip tidak berisi file SKILL.md.
  • File SKILL.md memiliki masalah berikut:
    • File SKILL.md tidak memiliki front matter YAML yang diperlukan atau konten Markdown yang diharapkan.
    • Kolom nama di front matter YAML tidak ada, melebihi 64 karakter, dimulai atau diakhiri dengan tanda hubung, atau berisi karakter selain huruf kecil, angka, dan tanda hubung.
    • Kolom deskripsi di front matter YAML tidak ada atau melebihi 1.024 karakter.
    • Kolom lisensi di front matter YAML melebihi 1.024 karakter.
    • Petunjuk dalam file SKILL.md melebihi 500.000 karakter.
  • Ukuran arsip yang di-zip lebih dari 10 MB.

Keterampilan bawaan

Registry Keterampilan menyertakan keterampilan gcp-skill-registry bawaan. Keterampilan ini memungkinkan agen berinteraksi dengan Registry Keterampilan untuk membuat, menelusuri, dan mengelola keterampilan yang tersedia, sehingga mereka dapat mendaftarkan fungsi baru atau menemukan kemampuan yang ada. Google mengelola siklus proses, rilis, dan pembuatan versi keterampilan bawaan ini, sehingga memastikan fungsi siap pakai.

Langkah berikutnya

Panduan

Pelajari cara membuat, memperbarui, menelusuri, dan menghapus keterampilan di Registry Keterampilan.