Membuat Skill

Dalam tutorial ini Anda memberi agent skill pertamanya: prosedur tertulis yang dibuka agent ketika percakapan membutuhkannya. Anda akan menyalakan skills, mengisi setiap field skill, mengujinya di Preview, lalu publish. Contohnya adalah skill capex_request untuk Atlas, asisten operasional Kirana Group. Skill ini memandu karyawan menyiapkan pengajuan capex di form KG-F12: mengumpulkan detail proyek, mencari rantai approval di SOP-FIN-007, menemukan cost centre dan lampiran yang diperlukan di file checklist, lalu menyusun ringkasan dalam layout Kirana.

Sebelum memulai

• Baca Mengajarkan Skill ke Agent untuk memahami bagaimana agent memutuskan membuka sebuah skill.
• Kalau skill perlu membaca file referensi, unggah file-nya lebih dulu. Lihat Memberi File ke Skill (Artifacts). Dalam contoh ini, folder private capex-request-kit berisi file kg-f12-checklist.md dengan field KG-F12, cost centre untuk setiap site, lampiran yang diperlukan menurut nilai, dan template ringkasan pengajuan. Anda bisa mengunduh file contohnya: kg-f12-checklist.md.
• Skill ini mencari approver di SOP-FIN-007, jadi Atlas harus sudah punya dokumen tersebut. Lihat Documents.
• Anda tahu cara menguji dan publish perubahan. Lihat Preview dan Publish Perubahan.

Langkah 1: Nyalakan skills

1. Di sidebar agent, buka Skills → Skills.
2. Nyalakan Give this agent skills. Pengaturan dan daftar skill muncul di bawah switch.

3. Periksa kedua pengaturannya. Nilai default-nya cocok untuk sebagian besar agent:
   • Keep a skill open for (messages): berapa pesan sebuah skill tetap terbuka setelah agent membukanya. Default 5, dari 1 sampai 50. Kalau topiknya muncul lagi nanti, agent cukup membuka skill itu kembali, jadi nilai yang pendek biasanya sudah tepat.
   • Skills open at once: berapa skill yang boleh terbuka dalam satu percakapan. Default 3, dari 1 sampai 6. Saat satu skill lagi terbuka, skill yang paling lama dilepas.

Kedua pengaturan ini berkaitan dengan biaya: skill yang terbuka ikut dikirim di setiap pesan sampai dilepas. Kedua pengaturan beserta nilai default-nya terlihat di Mengajarkan Skill ke Agent.

Langkah 2: Tambahkan skill

Klik Add skill. Dialog New skill terbuka. Isi field-nya:

Tips: Pastikan checkbox di depan capex-request-kit benar-benar tercentang. Mudah sekali mengklik nama folder tetapi tidak mengenai checkbox-nya. Kalau nanti skill mengatakan tidak bisa menemukan checklist, lihat skill itu di daftar: seharusnya ada chip 1 folder.

Klik Add untuk memasukkan skill ke daftar. Belum ada yang tersimpan.

Screenshot di bawah menunjukkan skill yang sudah jadi dan dibuka lagi lewat ikon pensil, sehingga judul dialognya Edit skill dan tombolnya Apply. Field-nya sama dengan New skill.

Menulis baris Use when yang baik

Baris Use when adalah satu-satunya yang dibaca agent saat memutuskan apakah akan membuka skill. Agent tidak melihat instruksinya sampai skill dibuka.

• Sebut situasinya, bukan prosedurnya. Baik: "the user wants to prepare, check or submit a capex or project request". Kurang baik: "KG-F12 procedure with cost centres and attachment rules".
• Pakai kata-kata yang dipakai user Anda. Staf Kirana bilang "pengajuan capex", "capex request", atau "KG-F12", bukan "alur kerja belanja modal". Menyebut kode form membantu agent mencocokkan pesan yang hanya menyebut form-nya.
• Satu skill untuk satu jenis situasi. Kalau dua skill punya baris Use when yang mirip, agent bisa membuka skill yang salah.

Menulis instruksi yang baik

• Tulis langkah bernomor sesuai urutan yang harus diikuti agent. Sebutkan apa yang ditanyakan, apa yang diperiksa, dan kapan berhenti.
• Sebut file dengan path-nya. Tulis nama folder dan nama file persis seperti di halaman Artifacts, misalnya capex-request-kit/kg-f12-checklist.md, dan sebutkan di langkah mana file itu dipakai.
• Jangan masukkan materi referensi ke instruksi. Tabel panjang, daftar cost centre, dan template sebaiknya disimpan di artifact. Instruksi cukup berisi prosedurnya.
• Sebutkan dari mana fakta diambil, dan apa yang tidak boleh dilakukan. Atlas mengambil approver dari SOP-FIN-007 di knowledge-nya, dan instruksinya menyebut "Never guess an approver" serta "You cannot submit it for them".

Instruksi yang dipakai untuk Atlas (dalam bahasa Inggris, sama seperti di screenshot):

1. Ask for the project code and name, the site, and the total project value in USD (including tax, contingency and all phases) if the user has not given them.
2. Look up the approval chain for that value in SOP-FIN-007 (your knowledge base). Never guess an approver.
3. Open capex-request-kit/kg-f12-checklist.md. Find the cost centre for the site and the attachments required for the value.
4. Ask for anything still missing, one question at a time.
5. Draft the summary using the "Request summary template" from the same file, exactly in that layout.
6. Remind the user to submit form KG-F12 in the Procurement Portal. You cannot submit it for them.

Langkah 3: Pilih kapan skill berlaku

Langkah 4: Simpan

1. Klik Save di bagian bawah halaman lalu konfirmasi.
2. Skill muncul di daftar dengan title-nya, chip berisi nama, chip berisi When it applies, jumlah folder yang boleh dibacanya, dan baris Use when.

Switch, kedua pengaturan, dan seluruh daftar skill disimpan bersamaan. Kalau ada yang salah (misalnya nama ganda), pesan yang muncul mencantumkan semua masalah sekaligus.

Periksa hasilnya

Skill yang disimpan masuk ke draft agent Anda, jadi Anda bisa mengujinya di Preview sebelum orang lain melihatnya.

1. Buka Preview dan mulai chat baru.

2. Kirim pesan yang cocok dengan baris Use when:

   Help me prepare a KG-F12 capex request for KG-2063, the Bekasi rooftop solar project. Total value USD 1.35 million, including tax, contingency and all phases.
   

3. Atlas membuka skill dan mengikuti prosedurnya. Atlas mengambil rantai approval untuk USD 1,35 juta dari SOP-FIN-007 (Group Risk Office review, lalu Regional Director, lalu CFO), menemukan cost centre CC-120 untuk Bekasi dan lampiran untuk nilai di atas USD 1.000.000 di file checklist, lalu menanyakan detail yang masih kurang, misalnya requester, Department Head, tanggal, dan justifikasi.

4. Berikan detail yang kurang, misalnya: "Requester Sari Wulandari, Department Head Andi Pratama, start 1 November 2026, finish 31 March 2027. Justification: cut site electricity costs by 30%. Please draft the summary."

5. Atlas menyusun ringkasan persis dalam layout dari file: KG-F12 SUMMARY, proyeknya, Bekasi / CC-120, USD 1,350,000, rantai approval Group Risk Office review → Regional Director (West region) → CFO, dan lampirannya (minimal tiga penawaran vendor, business case dengan payback period, dan risk register). Atlas juga mencantumkan detail KG-F12 lainnya dan mengingatkan Anda untuk mengirim form lewat Procurement Portal.

6. Coba pesan yang tidak cocok, misalnya "Who signs the permit for work above two metres?". Atlas seharusnya menjawab seperti biasa, tanpa langkah-langkah KG-F12.

Kalau agent tidak membuka skill, buat baris Use when lebih mirip dengan cara orang benar-benar bertanya, lalu simpan dan coba lagi di chat baru. Kalau skill terbuka tetapi Atlas mengatakan tidak bisa menemukan checklist, periksa apakah skill menampilkan chip 1 folder; kalau tidak, edit skill dan centang checkbox di depan capex-request-kit.

Langkah 5: Publish

Skill dan instruksinya tersimpan di draft. Klik Publish di bar atas saat Anda puas dengan hasilnya, agar agent live mulai memakai skill tersebut. Lihat Preview dan Publish Perubahan.

Mengubah, menghapus, atau mematikan skill

• Mengubah skill: klik ikon pensil di sampingnya. Dialog Edit skill terbuka dengan instruksinya sudah dimuat. Ubah field-nya, klik Apply, lalu Save.
• Menghapus skill: klik ikon tempat sampah dan konfirmasi, lalu Save. Instruksi skill ikut terhapus. Percakapan yang sedang membuka skill itu berhenti memakainya di pesan berikutnya.
• Mematikan semua skill: matikan Give this agent skills lalu Save. Skill Anda tetap ada di daftar, siap dipakai lagi saat switch dinyalakan kembali.
• Mencapai batas: Add skill tidak bisa diklik saat agent sudah punya skill sebanyak yang diizinkan organisasi Anda (8 secara default, maksimal 16).

Jangan lupa Publish setelah setiap perubahan agar agent live mengikutinya.

Langkah berikutnya

• Berikutnya dalam langkah ini: Memberi File ke Skill (Artifacts), untuk memberi skill Anda file referensi atau gambar.
• Berikutnya dalam alur: Berbicara dengan Suara.
• Referensi per field: Skills.