Mengajarkan Skill ke Agent
Buka di CMSSkill adalah prosedur tertulis yang diikuti agent untuk satu jenis situasi, misalnya menerima reservasi meja atau menangani refund. Agent membukanya hanya ketika percakapan membutuhkannya, sehingga instruksi sehari-hari tetap ringkas dan agent tetap tahu persis apa yang harus dilakukan saat situasi itu muncul. Langkah ini menjelaskan apa itu skill, kapan skill layak ditambahkan, dan bagaimana agent memilihnya.
Sebelum memulai
- Agent Anda sudah menjawab dengan baik secara mandiri. Lihat Memberi Identitas pada Agent dan Mengajari Agent Anda.
- Anda tahu cara menguji dan publish perubahan. Lihat Preview dan Publish Perubahan.
- Anda punya akses Owner atau Contributor ke agent tersebut.
Skills, Behavior, Knowledge, dan tool
Skills punya grup sendiri di sidebar agent, di antara Knowledge dan Tools. Masing-masing menjawab pertanyaan yang berbeda:
| Apa itu | Kapan agent memakainya | |
|---|---|---|
| Behavior (Persona) | Instruksi umum: gaya bahasa, peran, aturan yang berlaku di setiap percakapan. | Di setiap pesan. |
| Knowledge | Dokumen, website, dan video yang dicari agent untuk menemukan fakta. | Saat agent butuh fakta untuk menjawab. |
| Skills | Prosedur langkah demi langkah untuk situasi tertentu, beserta file yang boleh dibacanya. | Hanya saat percakapan cocok dengan baris Use when milik skill tersebut. |
| Tools (API, MCP, plugin, agent lain) | Aksi yang bisa dipanggil agent, misalnya mencari data pesanan. | Saat agent perlu mengambil data atau bertindak di sistem lain. |
Singkatnya: Knowledge adalah apa yang diketahui agent, Skills adalah cara agent mengerjakan suatu tugas, dan Tools adalah apa yang bisa dipanggilnya. Sebuah skill bisa meminta agent memakai tool atau file pada langkah tertentu, tetapi skill itu sendiri hanya berupa teks.

Kapan memakai skill
Tambahkan skill ketika:
- Sebuah tugas punya langkah dengan urutan tetap. Misalnya reservasi membutuhkan tanggal, jam, jumlah tamu, dan nama, lalu agent harus meminta konfirmasi sebelum selesai.
- Prosedurnya panjang, dan hanya sebagian percakapan yang membutuhkannya. Kalau ditaruh di Behavior, setiap pesan menjadi lebih panjang dan lebih mahal. Skill hanya dimuat saat dibutuhkan.
- Prosedurnya bergantung pada file referensi. Aturan tempat duduk, daftar harga, atau template balasan bisa disimpan di artifact yang hanya boleh dibaca skill ini.
Tetap taruh di Behavior kalau aturannya pendek dan berlaku di setiap percakapan (misalnya "selalu jawab dalam bahasa yang dipakai user"). Taruh di Knowledge kalau isinya fakta yang ditanyakan orang, bukan prosedur.
Contoh: agent milik Brew & Chat Cafe, Brew, menjawab pertanyaan menu dan alergen sepanjang hari. Reservasi lebih jarang, tetapi butuh prosedur yang cermat: cek jam buka, pilih meja sesuai jumlah tamu, jelaskan deposit untuk rombongan besar, lalu minta konfirmasi. Prosedur itu dijadikan skill Table reservation, sedangkan aturan tempat duduk dan deposit disimpan di file yang boleh dibaca skill tersebut.
Bagaimana agent memutuskan memakai skill
- Agent selalu melihat daftar singkat skill-nya. Untuk setiap skill, agent hanya melihat Name dan baris Use when, tidak pernah instruksi lengkapnya. Karena itu baris Use when harus menyebut situasinya dengan jelas.
- Saat sebuah pesan cocok, agent membuka skill tersebut. Instruksi lengkapnya ditambahkan ke percakapan, dan teks di Shown while it opens tampil sesaat kepada orang yang sedang chat.
- Skill tetap terbuka selama beberapa pesan. Secara default skill terbuka selama 5 pesan, dan paling banyak 3 skill terbuka bersamaan. Kalau topiknya muncul lagi nanti, agent membuka skill itu kembali dalam satu langkah.
- Selama skill terbuka, agent bisa membaca file-nya. Agent bisa membaca file di folder yang Anda berikan ke skill itu, dan hanya file tersebut.
Anda bisa mengubah cara skill dipakai lewat When it applies: The agent decides (default, seperti dijelaskan di atas), When a keyword appears (terbuka saat pesan orang mengandung salah satu keyword Anda), atau Always in force (selalu diterapkan, dan dibayar di setiap pesan). Lihat Membuat Skill untuk kapan memilih masing-masing.
Beberapa hal yang perlu diketahui:
- Skills mati secara default. Tidak ada yang berubah pada agent Anda sampai Anda menyalakan Give this agent skills.
- Setiap agent bisa punya hingga 8 skill secara default (batas organisasi Anda bisa sampai 16). Baris Use when setiap skill dikirim di setiap pesan, jadi jaga agar daftarnya tetap pendek.
- Skills tidak ditawarkan saat agent lain memanggil agent Anda lewat Agent-to-Agent.
- Clone agent tidak menyalin skill maupun artifact-nya.
Halaman dalam langkah ini
| Halaman | Yang akan Anda lakukan |
|---|---|
| Membuat Skill | Menyalakan skills, menulis skill beserta baris Use when dan instruksinya, mengujinya di Preview, lalu publish. |
| Memberi File ke Skill (Artifacts) | Membuat folder berisi file referensi atau gambar, mengunggah file, dan mengizinkan skill membacanya. |
Mulai dari mana: kalau prosedur Anda membutuhkan file referensi, buat folder dan unggah file-nya lebih dulu di Memberi File ke Skill (Artifacts), karena skill hanya bisa diberi folder yang sudah ada. Kalau tidak, langsung ke Membuat Skill.
Langkah berikutnya
- Berikutnya dalam langkah ini: Membuat Skill.
- Berikutnya dalam alur: Berbicara dengan Suara, agar orang bisa berbicara dengan agent Anda. Skills juga bekerja di voice call.
- Referensi per field: Skills dan Artifacts.