Ringkasan Skill Registry

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

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

Konsep utama

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

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

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

Validasi payload kemampuan

Untuk memastikan agen dapat menggunakan konten kemampuan yang valid, sistem akan otomatis memverifikasi semua payload kemampuan 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 utama.
  • 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 1024 karakter.
    • Kolom lisensi di front matter YAML melebihi 1024 karakter.
    • Petunjuk dalam file SKILL.md melebihi 500.000 karakter.
  • Ukuran arsip yang di-zip lebih dari 10 MB.

Kemampuan bawaan

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

Langkah berikutnya

Panduan

Pelajari cara membuat, memperbarui, menelusuri, dan menghapus kemampuan di Skill Registry.