Bagikan melalui

Menambahkan Keterampilan

Halaman sebelumnya memperlihatkan bagaimana alat memungkinkan agen bertindak — memanggil fungsi, mengkueri API, mencari di web. Tetapi saat Anda membangun lebih banyak agen, pola muncul: kluster alat, instruksi, dan materi referensi yang sama terus muncul bersama-sama. Kemampuan "ajukan laporan pengeluaran" bukan hanya satu alat — ini adalah skrip validasi, serangkaian dokumen kebijakan, instruksi langkah demi langkah tentang cara mengisi formulir, dan pengetahuan tentang batas pengeluaran. Anda akhirnya menyalin dan menempel bundel ini dari satu agen ke agen lain, dan menjadi tidak sinkron.

Keterampilan memecahkan masalah ini. Keterampilan adalah paket portabel yang menggabungkan instruksi, materi referensi, dan skrip opsional ke dalam satu unit yang dapat ditemukan dan dimuat oleh agen apa pun sesuai permintaan. Keterampilan mengikuti spesifikasi terbuka sehingga dapat digunakan kembali di seluruh agen, tim, dan bahkan produk.

Kapan menggunakan ini

Tambahkan keterampilan ke agen Anda saat:

  • Anda memiliki kluster pengetahuan terkait — instruksi, dokumen referensi, dan skrip — yang secara logis termasuk dalam satu (misalnya, "pelaporan pengeluaran" atau "panduan peninjauan kode").
  • Beberapa agen memerlukan keahlian domain yang sama dan Anda menginginkan satu sumber kebenaran daripada instruksi duplikat.
  • Anda ingin berbagi dan mendistribusikan kemampuan agen di seluruh tim, proyek, atau organisasi sebagai paket mandiri.
  • Anda perlu mengelola konteks secara efisien — keterampilan menggunakan pengungkapan progresif sehingga agen hanya memuat detail yang mereka butuhkan, ketika mereka membutuhkannya.

Pertimbangan

Pertimbangan Rincian
Dapat Digunakan Kembali Keterampilan adalah paket mandiri. Setelah dibuat, agen mana pun dapat mengambilnya — tanpa menyalin dan menempel, tidak ada perbedaan di antara salinan.
Efisiensi konteks Keterampilan menggunakan pengungkapan progresif: agen melihat deskripsi singkat (~100 token) di muka dan memuat instruksi lengkap hanya jika relevan. Ini membuat jendela konteks tetap ramping ketika keterampilan tidak diperlukan.
Biaya abstraksi Keterampilan menambahkan lapisan abstraksi di atas peralatan. Untuk satu alat fungsi mandiri, menambahkan pembungkus keterampilan adalah overhead yang tidak perlu.
Upaya desain Anda perlu memikirkan batas keterampilan di muka: apa yang termasuk dalam keterampilan dan apa yang tetap berada di luar. Batasan yang buruk menyebabkan keterampilan yang terlalu luas (membuang konteks) atau terlalu sempit (kehilangan keuntungan penggabungan).

Perbedaan antara keterampilan dan alat

Alat dan keterampilan saling melengkapi, bukan bersaing. Memahami perbedaan membantu Anda memutuskan kapan harus menjangkau masing-masing.

Alat adalah satu tindakan yang dapat dipanggil — satu fungsi dengan nama, deskripsi, dan skema parameter. Ketika model memutuskan alat diperlukan, ia menghasilkan panggilan terstruktur, Agent Framework menjalankannya, dan hasilnya kembali ke model. Alat adalah atom perilaku agen.

Keterampilan adalah paket keahlian domain. Ini dapat mencakup:

  • Instruksi — panduan langkah demi langkah, aturan keputusan, dan contoh yang memberi tahu agen cara mendekati domain.
  • Materi referensi — dokumen kebijakan, FAQ, templat, dan pengetahuan lain yang dapat dikonsultasikan agen sesuai permintaan.
  • Skrip — kode yang dapat dieksekusi yang dapat dijalankan agen untuk melakukan operasi tertentu (misalnya, skrip validasi yang memeriksa data pengeluaran terhadap aturan kebijakan).

Perbedaan utama adalah salah satu cakupan: alat memberi agen kemampuan untuk melakukan satu tindakan; keterampilan memberi agen pengetahuan dan sumber daya untuk menangani seluruh domain.

Alat Keterampilan
Apa yang disediakannya Satu tindakan yang dapat dipanggil Instruksi + materi referensi + skrip opsional
Bagaimana agen menggunakannya Memanggil fungsi/metode tersebut ketika perlu melakukan tindakan Memuatnya saat menemukan tugas yang relevan, membaca instruksi, dan dapat memanggil skrip atau berkonsultasi dengan sumber daya
Biaya konteks Skema alat selalu ada dalam prompt Hanya nama dan deskripsi keterampilan (~100 token) yang ada di perintah; konten lengkap dimuat sesuai permintaan
Portabilitas Terikat dengan agen yang mendaftarkannya Paket mandiri yang dapat ditemukan oleh agen yang kompatibel
Pilihan terbaik untuk Tindakan individual (mengkueri database, mengirim email) Keahlian domain (kebijakan pengeluaran, panduan peninjauan kode, prosedur onboarding)

Petunjuk / Saran

Anggaplah alat sebagai kata kerja (mencari, memesan, memvalidasi) dan keterampilan sebagai keahlian (pengetahuan pemesanan perjalanan, pengetahuan kebijakan pengeluaran). Agen menggunakan alat untuk bertindak dan keterampilan untuk mengetahui cara bertindak.

Cara kerja keterampilan: pengungkapan progresif

Keterampilan dirancang agar hemat konteks. Alih-alih menyuntikkan semuanya ke dalam prompt sejak awal, fitur menggunakan pola tiga tahap:

┌──────────────────────────────────────────────────────────────────┐
│  Stage 1: Advertise                                              │
│  Agent sees skill names and descriptions (~100 tokens each)      │
│  in its system prompt at the start of every run.                 │
└──────────────┬───────────────────────────────────────────────────┘
               ▼ (task matches a skill's domain)
┌──────────────────────────────────────────────────────────────────┐
│  Stage 2: Load                                                   │
│  Agent calls load_skill to get the full instructions             │
│  (< 5000 tokens recommended).                                   │
└──────────────┬───────────────────────────────────────────────────┘
               ▼ (agent needs more detail)
┌──────────────────────────────────────────────────────────────────┐
│  Stage 3: Read resources                                         │
│  Agent calls read_skill_resource to fetch supplementary files    │
│  (FAQs, templates, reference docs) only when needed.            │
└──────────────────────────────────────────────────────────────────┘

Pola ini berarti agen dengan 10 keterampilan terdaftar membayar sekitar 1.000 token overhead konteks — bukan 50.000. Agen hanya memperdalam pengetahuannya ketika tugas saat ini menuntutnya.

Selain itu, keterampilan dibangun di atas infrastruktur peralatan. Agent Framework mengiklankan keterampilan yang tersedia dalam prompt sistem agen, lalu mengekspos load_skill dan read_skill_resource sebagai panggilan alat yang dipanggil agen untuk memuat konten secara progresif.

Petunjuk / Saran

Untuk detail lengkap tentang struktur keterampilan, penyiapan, dan contoh kode, lihat referensi Keterampilan Agen .

Kapan menggunakan kemampuan teknis vs. pola lain

Ketika agen Anda tumbuh lebih mampu, Anda memiliki beberapa cara untuk mengatur perilakunya. Berikut adalah perbandingan keterampilan dan alat:

Pola Paling cocok untuk Example
Alat mandiri Aksi satu kali yang tidak memerlukan konteks bersama Alat fungsi get_weather
Keterampilan Keahlian dalam domain dengan panduan, referensi, dan skrip opsional Keterampilan "laporan pengeluaran" dengan dokumen kebijakan, skrip validasi, dan instruksi pengajuan langkah demi langkah

Kesalahan Umum

Perangkap Bimbingan
Keterampilan yang terlalu luas Keterampilan yang disebut "everything-about-finance" yang mencoba mencakup akuntansi, pajak, laporan pengeluaran, dan penggajian akan memiliki instruksi yang terlalu panjang dan tidak fokus. Pertahankan keterampilan yang berfokus pada satu domain.
Melompati tinjauan keamanan Petunjuk keterampilan disuntikkan ke dalam konteks agen dan skrip mengeksekusi kode. Perlakukan keterampilan seperti dependensi pihak ketiga — tinjau sebelum menyebarkannya. Lihat praktik terbaik keamanan dalam referensi keterampilan.
Mengabaikan pengungkapan progresif Jika SKILL.md Anda memiliki panjang 2.000 baris, agen akan membayar biaya konteks yang berat saat memuat keterampilan. Jaga instruksi tetap ringkas dan pindahkan materi referensi terperinci ke file sumber daya terpisah untuk memanfaatkan pengungkapan progresif sepenuhnya.

Langkah berikutnya

Setelah agen Anda memiliki alat dan keterampilan, langkah selanjutnya adalah menambahkan middleware — perilaku lintas fungsi seperti pagar pembatas, pencatatan, dan pemfilteran konten yang berlaku pada setiap interaksi tanpa memodifikasi logika inti agen Anda.

Menambahkan Middleware

Masuk lebih dalam:

  • Last updated on