AI Skill

TM AI Skill adalah paket kemampuan yang dapat digunakan kembali yang menggabungkan konteks dan tool terkait untuk memberikan AI Agent pengetahuan dan fungsi khusus untuk tugas atau domain tertentu.

Memahami DocType TM AI Skill

Tujuan: TM AI Skill memungkinkan administrator platform dan developer untuk membuat paket kemampuan AI yang modular dan dapat digunakan kembali. Dengan menggabungkan konteks terkait (pengetahuan/instruksi) dan tool (aksi) bersama-sama, Skill memungkinkan AI Agent untuk mengakses keahlian domain-spesifik secara efisien tanpa membebani context window. Arsitektur progressive disclosure ini memastikan agent hanya memuat apa yang mereka butuhkan, ketika mereka membutuhkannya.

Fungsi: TM AI Skill berfungsi sebagai container yang: - Mengemas AI Context dan AI Tool terkait ke dalam satu kemampuan yang koheren - Menyediakan deskripsi ringkasan untuk AI Agent menentukan relevansi skill - Memungkinkan pemuatan dinamis konteks dan tool hanya saat dibutuhkan - Mendukung penggunaan kembali skill di berbagai AI Agent - Memfasilitasi kolaborasi tim dengan membuat library kemampuan yang dapat dibagikan - Mengimplementasikan progressive disclosure untuk mengelola keterbatasan context window AI

Role yang Diperlukan

Role berikut diperlukan untuk mengelola TM AI Skill:

• TM AI Developer: Akses penuh untuk membuat, mengedit, dan menghapus AI Skill
• System Manager: Akses administratif ke semua AI Skill

Field TM AI Skill

Field	Deskripsi
Skill Name	Identifier unik untuk skill (dibuat otomatis dari Skill Description)
Skill Description	Ringkasan singkat (≤240 karakter) yang membantu AI Agent menentukan apakah skill ini relevan dengan tugas mereka
Skill Contexts	Table MultiSelect yang menghubungkan ke record TM AI Context yang tersedia untuk menyediakan pengetahuan, instruksi, atau metadata
Skill Tools	Table MultiSelect yang menghubungkan ke record TM AI Tool yang tersedia untuk menyediakan aksi yang dapat dieksekusi

Prosedur

1. Navigasi ke TM AI Skill

Navigasi ke TechMaju AI > TM AI Skill

2. Menambahkan TM AI Skill Baru

• Klik '+ Add TM AI Skill' untuk membuka form pembuatan
• Masukkan Skill Description: Tulis ringkasan yang jelas dan ringkas (maksimal 240 karakter) yang menggambarkan apa yang dilakukan skill ini
  • Contoh: "Skill Customer Service untuk menangani tiket support, pertanyaan pelanggan, dan komunikasi email"
• Skill Name akan dibuat secara otomatis dari deskripsi Anda

3. Mengkonfigurasi Skill Contexts

Skill Contexts menyediakan pengetahuan, instruksi, atau metadata ke AI Agent:

• Di field Skill Contexts, klik untuk membuka selector
• Pilih satu atau lebih record TM AI Context:
  • Text Context: Instruksi, pedoman, kebijakan, atau dokumentasi
  • DocType Metadata: Informasi schema untuk Frappe DocType
  • Document Data: Record dokumen atau dataset spesifik
• Context yang dipilih akan dimuat ketika AI Agent mengaktifkan skill ini
• Context ditampilkan di kolom kanan form

Best Practice untuk Contexts: - Sertakan hanya context yang berhubungan langsung dengan tujuan skill - Mulai dengan context esensial (instruksi, schema) - Tambahkan document data context hanya ketika record spesifik diperlukan - Jaga agar total ukuran context tetap terkelola untuk menghindari token overflow

4. Mengkonfigurasi Skill Tools

Skill Tools menyediakan aksi yang dapat dieksekusi oleh AI Agent:

• Di field Skill Tools, klik untuk membuka selector
• Pilih satu atau lebih record TM AI Tool yang mengimplementasikan aksi untuk skill ini
  • Contoh: Untuk skill "Customer Service", pilih tool seperti create_support_ticket, send_customer_email, log_interaction
• Tool yang dipilih akan tersedia ketika AI Agent mengaktifkan skill ini
• Tool ditampilkan di kolom kanan form

Best Practice untuk Tools: - Sertakan hanya tool yang bekerja bersama untuk domain skill - Pastikan tool memiliki nama yang jelas dan deskriptif - Verifikasi bahwa input schema tool terdokumentasi dengan baik - Test tool secara independen sebelum menambahkan ke skill

5. Menyimpan TM AI Skill

• Review konfigurasi skill Anda:
  • Deskripsi yang jelas dan ringkas
  • Context yang relevan dipilih
  • Tool yang sesuai dipilih
• Klik Save untuk membuat skill
• Skill sekarang tersedia untuk digunakan dalam konfigurasi TM AI Agent

6. Menggunakan Skill di AI Agent

Menghubungkan Skill ke Agent:

1. Buka record TM AI Agent
2. Di tabel Skills, tambahkan baris dan pilih TM AI Skill Anda
3. Simpan agent

Cara Skill Bekerja saat Runtime:

1. Ketika AI Agent berjalan, ia melihat daftar skill yang tersedia dengan deskripsinya
2. Observer Phase AI Agent memutuskan apakah skill relevan dengan tugas saat ini
3. Jika relevan, context dan tool skill dimuat ke dalam context agent
4. Agent kemudian dapat menggunakan pengetahuan dan tool skill untuk menyelesaikan tugas
5. Skill di-cache selama durasi loop eksekusi agent

Best Practice

Desain Skill

• Single Responsibility: Setiap skill harus fokus pada satu domain atau area kemampuan
• Penamaan yang Jelas: Gunakan deskripsi skill yang deskriptif yang jelas menunjukkan apa yang dilakukan skill
• Desain Modular: Buat skill yang dapat dikombinasikan dengan skill lain
• Reusabilitas: Desain skill agar dapat digunakan di berbagai agent dan skenario

Manajemen Context

• Progressive Disclosure: Sertakan hanya context esensial; biarkan agent meminta lebih jika diperlukan
• Hindari Duplikasi: Jika beberapa skill membutuhkan context yang sama, pertimbangkan membuat skill "core" terpisah
• Tetap Update: Perbarui context secara berkala untuk mencerminkan kebijakan, prosedur, dan data saat ini

Pemilihan Tool

• Fungsionalitas Terkait: Kelompokkan tool yang bekerja bersama dalam domain yang sama
• Hindari Overlap: Jangan sertakan tool yang sama di beberapa skill kecuali disengaja
• Test Menyeluruh: Validasi bahwa semua tool dalam skill bekerja dengan benar bersama
• Dokumentasi Dependencies: Jika tool bergantung satu sama lain, dokumentasikan ini dalam deskripsi skill

Optimisasi Performa

• Monitor Penggunaan Token: Lacak berapa banyak context yang ditambahkan setiap skill ke prompt agent
• Strategi Cache: Skill secara otomatis di-cache selama loop agent untuk meningkatkan performa
• Minimalkan Redundansi: Hindari menyertakan context atau tool yang jarang digunakan
• Audit Berkala: Review skill secara berkala untuk menghapus elemen yang sudah usang atau tidak digunakan

Kolaborasi Tim

• Konvensi Penamaan: Tetapkan standar tim untuk penamaan dan deskripsi skill
• Dokumentasi: Dokumentasikan tujuan dan use case skill di wiki internal atau komentar
• Version Control: Lacak perubahan besar pada skill, terutama saat menghapus context atau tool
• Testing Environment: Test skill baru di development sebelum deploy ke production

Pertimbangan Keamanan

• Access Control: Skill mewarisi kontrol akses dari context dan tool mereka
• Data Sensitif: Berhati-hati saat menyertakan context dengan informasi sensitif
• Tool Permissions: Pastikan tool memiliki pemeriksaan izin yang sesuai
• Audit Trail: Monitor agent mana yang menggunakan skill mana untuk tujuan kepatuhan

Contoh

Contoh 1: Skill Customer Service

Skill Description: "Skill Customer Service untuk menangani tiket support, pertanyaan pelanggan, dan komunikasi email"

Skill Contexts: - Pedoman Customer Service (Text Context) - Metadata DocType Customer - Metadata DocType Support Ticket - Template Email (Text Context)

Skill Tools: - createsupportticket - updateticketstatus - sendcustomeremail - logcustomerinteraction - searchcustomerhistory

Contoh 2: Skill Pemrosesan Sales Order

Skill Description: "Skill pemrosesan sales order untuk membuat, memperbarui, dan mengelola sales order dan quotation"

Skill Contexts: - Pedoman Proses Penjualan (Text Context) - Metadata DocType Sales Order - Metadata DocType Customer - Metadata DocType Item - Kebijakan Harga (Text Context)

Skill Tools: - createsalesorder - updateorderstatus - calculateordertotal - checkinventoryavailability - generate_quotation

Contoh 3: Skill Pelaporan Keuangan

Skill Description: "Skill pelaporan keuangan untuk menghasilkan laporan keuangan, neraca, dan laporan laba rugi"

Skill Contexts: - Standar Akuntansi (Text Context) - Metadata DocType Account - Metadata DocType Journal Entry - Metadata DocType GL Entry

Skill Tools: - generatebalancesheet - generateincomestatement - calculatefinancialratios - exportfinancialreport

Pemecahan Masalah

Skill Tidak Dimuat

Masalah: AI Agent tidak memuat skill meskipun tampaknya relevan

Solusi: - Periksa kejelasan deskripsi skill - buat lebih spesifik - Verifikasi context dan tool aktif dan dapat diakses - Review konfigurasi agent untuk memastikan skill terhubung - Periksa log Observer Phase untuk melihat mengapa skill ditolak

Error Token Overflow

Masalah: Agent kehabisan ruang context window

Solusi: - Kurangi jumlah context dalam skill - Pecah context besar menjadi lebih kecil dan terfokus - Hapus tool yang jarang digunakan dari skill - Pertimbangkan membuat beberapa skill kecil daripada satu skill besar

Eksekusi Tool Duplikat

Masalah: Tool dari beberapa skill mengeksekusi aksi yang sama

Solusi: - Review skill mana yang aktif dan mengandung tool yang tumpang tindih - Hapus tool duplikat dari skill sekunder - Gunakan konvensi penamaan tool untuk mengidentifikasi sumber tool - Pertimbangkan untuk menggabungkan skill yang tumpang tindih