Ringkasan Skill Registry

Skill Registry berfungsi sebagai repositori yang aman, pribadi, dan berlatensi rendah untuk mengelola keterampilan agen. Setiap keahlian adalah paket mandiri, termasuk 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 maksud pengguna, sehingga mengoptimalkan performa dan memastikan lingkungan eksekusi yang aman.

Konsep utama

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

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

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

Validasi payload keahlian

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 gagal dengan error validasi jika sistem mendeteksi salah satu hal berikut:

  • File bukan file zip yang tepat atau tidak memiliki informasi penting.
  • File ZIP kosong.
  • File zip berisi lebih dari 10.000 item.
  • Nama file atau folder dalam zip berisi .. atau diawali dengan / atau \\.
  • File ZIP berisi link simbolis.
  • Ada nama file atau folder duplikat dalam file ZIP.
  • Total ukuran semua file di dalam zip lebih dari 500 MB saat diekstrak.
  • File dikompresi terlalu banyak, dengan rasio kompresi lebih dari 100.
  • Folder di dalam zip memiliki lebih dari 8 tingkat.
  • 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, diawali 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 1.024 karakter.
    • Petunjuk dalam file SKILL.md melebihi 500.000 karakter.
  • Ukuran arsip ZIP lebih dari 10 MB.

Keahlian bawaan

Skill Registry menyertakan skill 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 fungsionalitas siap pakai.

Langkah berikutnya

Panduan

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