File ini dibangkitkan dari
docs/ai-tools/_guides/_README.mdolehnpm run ai-tools:docs— edit sumbernya, bukan hasilnya.
Katalog ini mendokumentasikan semua fungsi Entaris yang dapat dipanggil agen (AIRA) sebagai tool. Saat ini: 475 tool dalam 14 toolset (read 219, write 151, critical 105); 564 route API terinventaris. Seluruh tool aktif secara default dan disajikan lewat satu endpoint MCP /mcp (lihat ARSITEKTUR-MCP.md); tier read/write/critical menentukan apakah panggilan langsung dieksekusi atau menunggu persetujuan manusia, dan owner dapat menonaktifkan/menetapkan tier per tool.
Arsitektur MCP (identitas per-user, tier, antrian persetujuan, spesifikasi token + actor assertion): ARSITEKTUR-MCP.md. Panduan klien MCP + implementasi referensi penanda tangan: PANDUAN-KLIEN-MCP.md. Panel chat (sesi disimpan Entaris, kontrak ke engine, blok identitas): PANEL-CHAT.md.
| File | Isi |
|---|---|
| INDEX.md | Semua toolset + tabel seluruh tool (cari dengan Ctrl+F) |
<toolset>.md |
Tujuan, ALUR BISNIS, lalu rincian tiap tool (parameter, contoh, efek pembukuan) |
| DENYLIST.md | Endpoint yang sengaja TIDAK menjadi tool + alasannya |
| GLOSARIUM.md | Istilah bisnis & teknis (STT, BPB, DO/SJ, WAC/HPP, COA, JV, ...) |
| AUDIT.md | Hasil rekonsiliasi registry Juni 2026 vs kode (temuan & perbaikan) |
catalog.json |
Versi mesin-baca (dokumentasi per tool ikut disertakan) — kelak disajikan sebagai resource MCP |
Toolset: penjualan, pembelian, persediaan, produksi, akuntansi, kas-bank, aset-umum, pengajuan-pembayaran, persetujuan, laporan, dashboard, master-data, sistem, obrolan.
| Risk | Tier | Arti |
|---|---|---|
read |
Auto | Hanya membaca. Termasuk POST murni baca (safeNonGet: preview/export data). |
write |
Draft/Approve | Membuat/mengubah draft atau keadaan yang dapat dibalik; tidak memposting GL/stok. |
critical |
Wajib-Approve | Memposting GL/stok/WAC, membatalkan/membalik dokumen terposting, pembayaran, keputusan persetujuan. |
Field penting per tool: draftCapable (hanya membuat draft / pengajuan pending), postingEffect (efek GL/stok/WAC), confirm_template (kalimat persetujuan), roles + module/permAction (izin RBAC nyata), params (path/query/body dengan tipe, wajib, enum).
- Nama tool:
snake_case,<modul>_<aksi>(mis.so_submit,payreq_pay). Nama lama dipertahankan bila benar. handler=METHOD /api/pathpersis seperti route Express (nama:paramikut menjadi nama argumen).- Kode berbahasa Inggris, dokumentasi Bahasa Indonesia.
group(legacy, dipakai whitelist modul AIRA di UI) tetap ada;toolsetadalah pengelompokan katalog baru.
- Registry:
server/src/ai/aira-tool-router.json(satu-satunya; salinan lama didocs/erd-ai-layer/config/dihapus). Tipe:server/src/ai/types.ts; validasi:server/src/ai/registry.ts. - Inventori route: dihitung statis dari kode (
server/src/ai/catalog/inventoryRoutes.ts) —npm run ai-tools:inventory(JSON diserver/scripts/ai-tools/out/). - Denylist:
server/src/ai/catalog/denylist.ts. - Panduan alur bisnis: tulisan tangan di
docs/ai-tools/_guides/<toolset>.md(paragraf pertama = tujuan; bagian###= ALUR BISNIS). - Dokumentasi:
npm run ai-tools:docs(server/) membangkitkan ulang seluruhdocs/ai-tools/secara idempoten.
- Buat route seperti biasa.
- Tambahkan entri tool di registry (atau masukkan ke denylist dengan alasan).
npm run ai-tools:docs, commit hasilnya.npm run ai-tools:checkharus hijau.
Gagal bila: (a) handler registry tak cocok route nyata; (b) route non-denylist tanpa tool; (c) tool write/critical tanpa confirm_template/postingEffect; (d) tool tanpa deskripsi/parameter terdokumentasi; (e) docs/ai-tools tidak mutakhir terhadap registry. CI menjalankannya setelah test server.