Memberi File ke Skill (Artifacts)

Artifacts adalah file milik agent Anda, misalnya checklist, template ringkasan, atau gambar, yang dikelompokkan ke dalam folder. Sebuah skill bisa diberi folder secara utuh, dan selama skill itu terbuka agent bisa membaca file di dalamnya atau menampilkan gambarnya. Dalam tutorial ini Anda membuat folder, mengunggah file, dan mengizinkan sebuah skill memakainya.

Sebelum memulai

• Baca Mengajarkan Skill ke Agent untuk memahami apa itu skill.
• Siapkan file-nya. Untuk teks yang perlu dibaca agent, pakai file teks biasa seperti .md atau .txt. Untuk mengikuti tutorial, unduh file contoh kg-f12-checklist.md yang dipakai Atlas, asisten operasional Kirana Group, untuk pengajuan capex.
• Anda tahu cara menguji dan publish perubahan. Lihat Preview dan Publish Perubahan.

Cara kerja artifacts

• File disimpan di folder, dan akses diberikan per folder. Anda tidak pernah memberi skill satu file saja. Anda mencentang sebuah folder di skill, lalu skill boleh membaca semua file di dalamnya, termasuk file yang Anda tambahkan nanti.
• Agent membaca file hanya selama skill yang boleh membaca folder-nya sedang terbuka. Saat skill ditutup, akses file-nya ikut hilang.
• Agent menyebut file sebagai folder/file, misalnya capex-request-kit/kg-f12-checklist.md. Pakai path yang sama saat Anda menyebut file di instruksi skill.
• Setiap folder bersifat private atau public. Folder private untuk materi referensi yang dibaca agent. Folder public untuk gambar yang ditampilkan agent di jawabannya: siapa pun yang punya URL file bisa membukanya, tanpa login.
• Artifacts bukan Knowledge. Dokumen Knowledge dicari di setiap pertanyaan. Artifact hanya dibaca saat skill yang memakainya sedang terbuka, jadi cocok untuk materi yang hanya penting bagi satu prosedur.

Langkah 1: Buat folder

1. Di sidebar agent, buka Skills → Artifacts. Halaman ini berisi Folders di kiri dan file dari folder yang dipilih di kanan.
2. Klik New folder.
3. Isi dialognya:
   • Name (wajib): nama folder yang ditulis agent sebelum nama file. Maksimal 60 karakter, tanpa garis miring, dan unik di agent ini. Contoh: capex-request-kit.
   • Description: catatan untuk Anda tentang isi folder. Agent tidak pernah melihatnya. Maksimal 200 karakter. Contoh: KG-F12 form fields, cost centres, attachments by value and the summary template.
4. Klik Add. Folder langsung tersimpan. Folder baru selalu private.

Langkah 2: Unggah file

1. Pilih folder di sebelah kiri.
2. Klik Upload file lalu pilih file, di sini kg-f12-checklist.md. Sebuah pesan mengonfirmasi saat file sudah ditambahkan.
3. File muncul dengan namanya, path-nya dalam bentuk folder/file, dan ukurannya.

Perubahan di halaman ini langsung tersimpan; tidak ada tombol Save.

Untuk Atlas, file kg-f12-checklist.md berisi field form KG-F12, cost centre untuk setiap site, lampiran yang diperlukan menurut nilai, dan template ringkasan pengajuan yang harus diikuti skill (isinya dalam bahasa Inggris):

# Kirana Group: KG-F12 capex request kit

## Fields on form KG-F12 (Procurement Portal)
- Project code (KG-0000) and project name
- Site and cost centre (see the table below)
- Total project value in USD, including tax, contingency and all phases
- Requester and Department Head
- Expected start date and completion date
- Short justification (max. 300 characters)

## Cost centres
| Site | Cost centre | Regional Director |
|---|---|---|
| Jakarta | CC-110 | West region |
| Bekasi | CC-120 | West region |
| Surabaya | CC-210 | East region |
| Makassar | CC-310 | East region |

## Attachments by value
- Up to USD 250,000: one vendor quotation
- Above USD 250,000: at least three vendor quotations
- Above USD 1,000,000: also a business case with payback period, and a risk register

## Request summary template
Use this exact layout when you draft the summary for the requester:

KG-F12 SUMMARY
Project: <code> <name>
Site / cost centre: <site> / <cost centre>
Total value (USD): <value>
Approval chain: <approvers in order, from SOP-FIN-007>
Attachments: <list>
Submit at least 10 business days before the Board Investment Committee if the value is above USD 5,000,000.

Jenis file dan batasannya

Langkah 3: Izinkan skill membaca folder

1. Buka Skills → Skills lalu klik ikon pensil pada skill (atau Add skill untuk skill baru).
2. Di Folders this skill may read, centang checkbox di depan folder-nya, di sini capex-request-kit. Setiap folder menunjukkan apakah folder itu public atau private. Mengklik nama folder saja bisa tidak mengenai checkbox-nya, jadi pastikan sudah tercentang.
3. Di Instructions, sebutkan kapan file dipakai, lengkap dengan path-nya. Misalnya: "Open capex-request-kit/kg-f12-checklist.md. Find the cost centre for the site and the attachments required for the value."
4. Klik Apply (atau Add), lalu Save. Skill di daftar sekarang menampilkan chip 1 folder.

Kalau belum ada folder, dialog menampilkan catatan yang mengarahkan Anda ke halaman Artifacts. Lihat Membuat Skill untuk field lainnya.

Menjadikan folder public atau private

Pilih folder lalu klik Make public atau Make private, lalu konfirmasi.

• Make public membuat setiap file di folder bisa dibaca siapa pun yang punya URL-nya, tanpa login. Pakai hanya untuk gambar yang memang akan ditampilkan agent, jangan untuk materi internal seperti daftar cost centre, checklist, atau prosedur.
• Make private membuat file tidak lagi bisa dijangkau lewat URL. Gambar yang sudah ditampilkan di percakapan sebelumnya berhenti dimuat.

Mengubah visibilitas memindahkan file ke penyimpanan lain, jadi URL file yang sudah pernah dibagikan tidak berfungsi lagi.

Mengubah atau menghapus

• Mengubah folder: klik ikon pensil pada folder untuk mengganti nama atau deskripsinya. Visibilitas diubah di folder itu sendiri, bukan di dialog ini. Kalau Anda mengganti nama folder, perbarui juga path file di instruksi skill Anda.
• Menghapus file: klik ikon tempat sampah di samping file lalu konfirmasi. Skill yang menyebut file itu tidak bisa lagi membacanya.
• Menghapus folder: klik ikon tempat sampah pada folder lalu konfirmasi. Semua file di dalamnya ikut terhapus, dan konfirmasinya menyebutkan skill yang kehilangan akses.

Periksa hasilnya

1. Buka Preview dan mulai chat baru.

2. Tanyakan sesuatu yang hanya bisa dijawab dari file tersebut. Untuk Atlas:

   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. Jawabannya seharusnya memakai fakta dari file. Atlas menemukan cost centre CC-120 untuk Bekasi dan, karena nilainya di atas USD 1.000.000, meminta minimal tiga penawaran vendor, business case dengan payback period, dan risk register. Kedua fakta itu tidak ada di knowledge Atlas; keduanya berasal dari capex-request-kit/kg-f12-checklist.md.

Kalau Atlas mengatakan tidak bisa menemukan checklist, kemungkinan skill tersimpan tanpa folder. Periksa apakah skill menampilkan chip 1 folder di halaman Skills.

Artifacts tersimpan di draft agent Anda, jadi Preview langsung memakainya. Klik Publish saat Anda siap, agar agent live memakai file yang sama. Lihat Preview dan Publish Perubahan.

Langkah berikutnya

• Berikutnya dalam alur: Berbicara dengan Suara, agar orang bisa berbicara dengan agent Anda.
• Membuat Skill: tulis prosedur yang memakai file Anda.
• Referensi per field: Artifacts.