Nxdom Framework

Nusantara eXtreme Development Object Model — dokumentasi resmi

smart_toy Agent Mode — Eksekusi Mandiri

Dalam Agent Mode, AI bekerja secara mandiri: membaca file, menulis perubahan, dan menjalankan perintah terminal tanpa perlu persetujuan satu per satu.


1. Mengaktifkan Agent Mode

Klik toggle Agent di header panel Chat. Saat aktif, pill di header berubah warna dan AI menggunakan tools secara otomatis.

ModePerilaku AI
Chat biasaAI merespons dengan teks dan saran patch — Anda yang memutuskan Accept / Reject
Agent ModeAI membaca/menulis file dan menjalankan terminal secara mandiri, melaporkan setiap langkah

2. Tools yang Digunakan AI

ToolFungsi
read_fileBaca isi file di project
search_codeCari simbol, fungsi, atau teks di seluruh project
search_contextCari konteks semantik yang relevan di project
run_terminalJalankan perintah terminal (npm, git, dll.)
git_statusAmbil status dan diff Git project aktif

3. Terminal AI — Keamanan Perintah

Dalam Agent Mode, AI dapat menjalankan perintah terminal dengan tiga level keamanan:

KategoriPerilakuContoh
Langsung jalanPerintah aman, tidak perlu konfirmasinpm test, git status, ls, npm run build
Perlu konfirmasiPerintah yang mengubah state — Anda diminta menyetujuinpm install, git push, git commit
DiblokirPerintah berbahaya, tidak bisa dijalankan sama sekalirm -rf, format, shutdown, del /f
  • Output setiap perintah terminal ditampilkan langsung di panel Chat.
  • Port internal aplikasi (4120) dilindungi — AI tidak bisa menggunakannya.
  • AI hanya boleh mengedit file di folder project user — file internal NxCode diblokir.

4. Auto-Verify

Aktifkan toggle Auto-Verify di header Chat agar AI otomatis menjalankan build/test setelah menulis kode:

  1. AI menulis patch ke file.
  2. AI menjalankan perintah verifikasi (mis. npm test).
  3. Jika test gagal → AI membaca output error → mencoba perbaiki otomatis.
  4. Loop maksimal 3 kali percobaan sebelum berhenti dan melaporkan ke Anda.

5. Activity Log

Setiap langkah yang dilakukan AI dalam Agent Mode tercatat di Activity Log — ditampilkan real-time di panel Chat. Log menunjukkan tool apa yang dipanggil, file apa yang dibaca/ditulis, dan perintah apa yang dijalankan.