Panduan Penggunaan Tools Ainav Executor

Panduan Penggunaan Tools AINAV Executor

| Panduan & Dokumentasi Operasional Tools

File & Folder (9)

Execution & Command (4)

Monitoring & Analisis (2)

Visual & UI (2)

Document Generation (1)

Backup Management (2)

Read AI-generated summary

Ringkasan operasional 20 modular tools AINAV Executor:

Isolasi Workspace Sandbox: 9 tools manajemen berkas beroperasi aman tanpa risiko overwrite atau intervensi direktori sistem.
Eksekusi Terpantau: Perintah shell dan eksekusi skrip diawasi melalui telemetry standar (*stdout*, *stderr*, dan *exit status code*).
Observabilitas Realtime: Analisis mendalam CPU, RAM, listening ports, dan proses sistem tanpa mengubah status host (*read-only*).
Standar Integritas: Pembuatan dokumen resmi multi-format serta arsip ZIP cadangan dengan manifest hash SHA-256 otomatis.

Panduan Penggunaan Tools AINAV Executor

Selamat datang di dokumentasi operasional AINAV Executor. Lingkungan ini menyediakan 20 peralatan modular (*tools*) yang terbagi dalam 6 kategori operasional, dirancang untuk mendukung otomatisasi alur kerja tingkat lanjut dengan jaminan keamanan dan isolasi yang ketat.

Gunakan menu di sidebar kiri untuk menelusuri penjelasan fungsi, izin eksekusi, serta skenario penggunaan spesifik dari masing-masing tool. Seluruh fungsionalitas dirancang berdasarkan prinsip pemisahan hak akses (*least privilege*) dan observabilitas penuh.

Kategori 1

File & Folder Management

9 tools operasi berkas dan direktori di dalam ruang lingkup sandbox terisolasi.

Kategori 2

Execution & Command

4 tools eksekusi skrip berkas, shell OS-level host, dan sandbox Python.

Kategori 3

Monitoring & Analisis

2 tools observabilitas telemetri host dan evaluasi anomali sistem cerdas.

Kategori 4

Visual & UI

2 tools observasi tangkapan layar desktop dan pembukaan antarmuka grafis.

Kategori 5

Document Generation

1 tool pembuatan dokumen korporat multi-format (DOCX, XLSX, PPTX, PDF).

Kategori 6

Backup Management

2 tools pembuatan dan audit integritas berkas arsip dengan checksum SHA-256.

write_file

Sandbox Safe

Kategori: File & Folder Management

Fungsi & Deskripsi

Membuat atau menulis berkas baru di workspace sandbox AINAV dengan penanganan tabrakan (*collision handling*) secara aman dan terisolasi. Seluruh proses penulisan diarahkan ke direktori kerja yang terkontrol tanpa memengaruhi berkas di luar ruang lingkup workspace.

Contoh Skenario Penggunaan

Menghasilkan skrip otomasi: Membuat skrip Python, JavaScript, atau shell baru langsung di dalam direktori workspace.
Konfigurasi aplikasi: Menulis berkas konfigurasi sistem berformat JSON, YAML, atau .env untuk persiapan runtime aplikasi.
Penyimpanan output pemrosesan: Menyimpan hasil kode sumber terstruktur atau berkas log transaksi internal.

read_file

Read Only

Kategori: File & Folder Management

Fungsi & Deskripsi

Membaca isi berkas teks yang berada di workspace sandbox untuk keperluan audit konten, evaluasi konfigurasi, atau penelaahan kode sumber sebelum eksekusi lanjutan.

Contoh Skenario Penggunaan

Audit source code: Memeriksa integritas dan sintaksis skrip sebelum proses deployment atau pengujian.
Pemeriksaan konfigurasi: Memvalidasi parameter nilai pada berkas pengaturan aplikasi aktif.
Troubleshooting: Membaca berkas log runtime untuk menganalisis jejak galat sistem (*stack trace*).

delete_file

Sandbox Action

Kategori: File & Folder Management

Fungsi & Deskripsi

Menghapus berkas atau memindahkannya ke tempat sampah sementara (*recycle bin*) di direktori workspace sandbox AINAV secara terkontrol.

Contoh Skenario Penggunaan

Pembersihan berkas sementara: Menghapus artefak sementara (*temporary test artifacts*) pasca-pengujian selesai.
Manajemen ruang penyimpanan: Mengeliminasi berkas cache usang yang tidak lagi diperlukan oleh sistem.

list_files

Read Only

Kategori: File & Folder Management

Fungsi & Deskripsi

Menampilkan daftar seluruh berkas dan folder di dalam workspace, dengan opsi penelusuran hierarki secara rekursif (*recursive traversal*).

Contoh Skenario Penggunaan

Pemetaan struktur project: Melihat hierarki folder dan penataan modul aplikasi secara komprehensif.
Audit direktori sandbox: Memeriksa keberadaan berkas artefak yang baru saja di-generate oleh alur otomatisasi.

move_file

Sandbox Safe

Kategori: File & Folder Management

Fungsi & Deskripsi

Memindahkan berkas atau folder ke lokasi direktori lain di dalam ruang lingkup workspace sandbox AINAV tanpa risiko keluar jalur.

Contoh Skenario Penggunaan

Pengarsipan berkas: Memindahkan file log atau hasil export ke subfolder arsip khusus.
Restrukturisasi project: Merapikan susunan direktori file sumber ke folder modul yang sesuai.

rename_file

Sandbox Safe

Kategori: File & Folder Management

Fungsi & Deskripsi

Mengganti nama berkas atau folder pada level direktori induk (*parent directory*) yang sama secara aman.

Contoh Skenario Penggunaan

Standardisasi penamaan: Memperbarui nama berkas lama agar sesuai dengan konvensi penamaan tim.
Versioning berkas: Menyematkan nomor versi rilis atau timestamp pada nama berkas draf.

copy_file

Sandbox Safe

Kategori: File & Folder Management

Fungsi & Deskripsi

Menyalin berkas tunggal atau seluruh hierarki folder secara rekursif ke direktori target yang ditentukan di dalam workspace.

Contoh Skenario Penggunaan

Duplikasi konfigurasi: Menduplikasi template berkas konfigurasi (.env.example ke .env).
Pencadangan cepat pra-modifikasi: Membuat salinan cadangan instan sebelum menyunting berkas kode penting.
Kloning template project: Menyalin folder struktur awal untuk inisialisasi modul baru.

make_directory

Sandbox Safe

Kategori: File & Folder Management

Fungsi & Deskripsi

Membuat folder baru secara aman di workspace AINAV dengan kemampuan membuat folder induk (*parent directories*) secara otomatis (*mkdir -p*).

Contoh Skenario Penggunaan

Inisialisasi susunan project: Menyiapkan struktur direktori hierarkis untuk modul aplikasi baru.
Folder output laporan: Menyiapkan folder penyimpanan terstruktur untuk penampungan berkas hasil generate berkala.

file_info

Read Only

Kategori: File & Folder Management

Fungsi & Deskripsi

Membaca dan mengambil metadata komprehensif berkas atau folder: ukuran berkas (*file size*), timestamp pembuatan dan modifikasi terakhir, hak akses (*permission*), serta checksum hash SHA-256.

Contoh Skenario Penggunaan

Pemeriksaan ukuran berkas: Memastikan berkas output tidak melebihi kuota sebelum dikirim melalui jaringan.
Verifikasi checksum integritas: Memvalidasi bahwa hash SHA-256 berkas sesuai dengan standar integritas rilis.
Audit permission: Meninjau hak akses pada berkas penting untuk mencegah perubahan tak diinginkan.

execute_file

Isolated Runtime

Kategori: Execution & Command

Fungsi & Deskripsi

Menjalankan berkas skrip yang berada di dalam workspace agent dengan observabilitas lengkap terhadap keluaran standar (*stdout*), pesan galat (*stderr*), serta kode status keluar (*exit code*).

Contoh Skenario Penggunaan

Menjalankan skrip: Eksekusi berkas skrip Python, Node.js, atau PowerShell di workspace lokal.
Pengujian modul otomatis: Menjalankan rangkaian unit test lokal dan memantau kode return secara berkala.
Monitoring output runtime: Mengamati jejak stream eksekusi skrip komputasi panjang.

run_command

Host Privilege

Kategori: Execution & Command

Fungsi & Deskripsi

Menjalankan shell command tingkat OS host dengan dukungan berbagai mode eksekusi: synchronous (sync), streaming, background process, atau UI terminal interaktif.

Contoh Skenario Penggunaan

Manajemen paket: Menjalankan instalasi paket dependensi via package manager (`npm install`, `pip install`).
Operasi version control: Menjalankan serangkaian perintah Git (`git pull`, `git status`, `git commit`).
Orkestrasi kontainer & service: Mengontrol kontainer Docker, mengelola service sistem, atau menyalakan web server lokal.

command

One-Shot Shell

Kategori: Execution & Command

Fungsi & Deskripsi

Menjalankan perintah OS yang cepat, ringan, dan bersifat satu kali eksekusi (*one-shot*) baik di dalam maupun di luar sandbox untuk inspeksi kilat.

Contoh Skenario Penggunaan

Identifikasi lingkungan: Memeriksa identitas user dan perangkat (`whoami`, `hostname`).
Pemeriksaan jaringan: Mengecek konfigurasi adapter jaringan dan latensi koneksi (`ipconfig`, `ping`).
Inspeksi proses: Memeriksa daftar proses sistem yang sedang berjalan secara ringkas (`tasklist`).

python_sandbox_execute

Sandbox Safe

Kategori: Execution & Command

Fungsi & Deskripsi

Mengeksekusi cuplikan (*snippet*) kode Python sementara di dalam lingkungan sandbox terisolasi dengan subset standard library yang aman tanpa perlu membuat berkas fisik di disk.

Contoh Skenario Penggunaan

Validasi kalkulasi & rumus: Menguji kebenaran formula matematika atau penghitungan logika cepat.
Transformasi data in-memory: Melakukan parsing struktur data JSON/CSV dan filtering secara langsung di memori.
Eksperimen algoritma: Uji coba algoritma komputasi sebelum dimasukkan ke dalam codebase utama.

system_telemetry

Telemetry Sensor

Kategori: Monitoring & Analisis

Fungsi & Deskripsi

Mengambil data telemetri realtime host: utilisasi CPU, konsumsi memori RAM, throughput jaringan, daftar proses aktif, listening ports yang terbuka, serta kapasitas ruang disk.

Contoh Skenario Penggunaan

Pemantauan kesehatan host: Mengawasi stabilitas server selama proses komputasi beban tinggi.
Deteksi bottleneck: Mengidentifikasi proses yang mengonsumsi memori atau kapasitas CPU berlebih.
Audit keamanan jaringan: Memeriksa port terbuka untuk memastikan tidak ada service asing yang terpapar.
Kapasitas media penyimpanan: Mengantisipasi kegagalan sistem akibat kepenuhan kapasitas ruang hard disk.

ai_ops

Read Only Insight

Kategori: Monitoring & Analisis

Fungsi & Deskripsi

Melakukan analisis analitis (*read-only*) terhadap data telemetri sistem, mendeteksi anomali, menganalisis akar masalah (*root cause*), menghitung profil risiko, dan merekomendasikan rencana perbaikan (*remediation*) tanpa memodifikasi sistem langsung.

Contoh Skenario Penggunaan

Diagnosa performa host: Menganalisis penyebab penurunan responsivitas server.
Root Cause Analysis: Menyelidiki akar penyebab di balik kegagalan proses atau service crash.
Rekomendasi tindakan mitigasi: Memperoleh panduan langkah perbaikan sebelum pemeliharaan dilakukan.

screenshot

Visual Capture

Kategori: Visual & UI

Fungsi & Deskripsi

Mengambil tangkapan layar (*screenshot capture*) desktop aktif agent yang sedang berjalan dan menyimpannya sebagai berkas gambar di workspace.

Contoh Skenario Penggunaan

Verifikasi antarmuka visual: Memvalidasi tampilan UI aplikasi web atau antarmuka desktop setelah rendering.
Dokumentasi galat: Mendokumentasikan kondisi layar ketika terjadi kendala operasional untuk mempermudah troubleshooting.
Audit alur kerja visual: Merekam bukti visual status pengerjaan tugas oleh agent.

open_file

Desktop Interface

Kategori: Visual & UI

Fungsi & Deskripsi

Membuka berkas atau folder workspace secara visual langsung di lingkungan host menggunakan aplikasi default sistem operasi atau Windows File Explorer.

Contoh Skenario Penggunaan

Membuka direktori output: Membuka folder hasil pengerjaan langsung di Windows File Explorer untuk inspeksi manual pengguna.
Pratinjau dokumen: Membuka dokumen laporan hasil render (PDF, DOCX) menggunakan viewer bawaan.
Pemeriksaan aset media: Membuka berkas grafis atau video hasil olah data di sistem.

document_render

Multi-Format Engine

Kategori: Document Generation

Fungsi & Deskripsi

Menghasilkan dokumen profesional dalam berbagai format (DOCX, XLSX, PPTX, PDF, HTML, Markdown, JSON, CSV) dengan kustomisasi tata letak, skema tema korporat, dan penyusunan tabel data yang terstruktur.

Contoh Skenario Penggunaan

Laporan bisnis & proposal: Menghasilkan laporan formal dan proposal bisnis berformat Word (.docx).
Presentasi eksekutif: Membuat slide presentasi profesional siap pakai (.pptx).
Spreadsheet analisis data: Menyusun lembar sebar data analitik dan tabel keuangan otomatis (.xlsx).
Ekspor dataset: Mengonversi kumpulan data terstruktur ke format .csv, .json, maupun dokumentasi Markdown.

backup_create

Integrity Hash

Kategori: Backup Management

Fungsi & Deskripsi

Membuat arsip ZIP cadangan terverifikasi dari berkas atau folder workspace yang secara otomatis dilengkapi manifest checksum SHA-256 untuk setiap berkas yang dicadangkan.

Contoh Skenario Penggunaan

Cadangan sebelum refactoring: Mengamankan seluruh workspace sebelum melakukan perubahan kode atau struktur berskala besar.
Pengarsipan aset penting: Mengompresi dan menyusun arsip data sensitif secara periodik.
Snapshot pra-deployment: Membuat checkpoint stabilitas sebelum proses rilis sistem dijalankan.

backup_verify

Integrity Audit

Kategori: Backup Management

Fungsi & Deskripsi

Memvalidasi keutuhan berkas arsip ZIP cadangan dengan mencocokkan struktur direktori internal, manifest berkas, kesesuaian ukuran berkas, serta verifikasi checksum SHA-256.

Contoh Skenario Penggunaan

Verifikasi sebelum transfer: Memastikan file arsip ZIP tidak korup sebelum diunggah ke penyimpanan cloud atau server arsip.
Audit kesiapan pemulihan: Memverifikasi manifest hash sebelum menjalankan proses restore berkas cadangan ke dalam sistem aktif.

Pedoman Keamanan & Batasan Operasional

Seluruh eksekusi tool diatur oleh prinsip ketat untuk meminimalkan dampak operasional pada lingkungan host dan menjaga integritas data.

1. Batasan Isolasi Sandbox

Operasi berkas (`write_file`, `delete_file`, `move_file`, `copy_file`) dibatasi secara ketat di dalam path workspace sandbox yang telah ditentukan. Upaya pengaksesan di luar direktori yang diizinkan akan otomatis ditolak oleh sistem proteksi keamanan.

2. Kewenangan Perintah Shell

Tool perintah tingkat OS (`run_command` dan `command`) berinteraksi langsung dengan sistem host sesuai hak izin yang diberikan. Selalu periksa parameter dan gunakan preview dampak sebelum menjalankan perintah yang berpotensi destruktif.

3. Validasi Integritas SHA-256

Sebelum melakukan perombakan kode skala besar atau migrasi data penting, biasakan untuk membuat snapshot arsip melalui `backup_create` dan memastikan validitas keutuhannya menggunakan `backup_verify`.