# Alat & Kemampuan

## Gambaran Umum

Alat adalah tindakan yang dapat dilakukan agen Anda selama percakapan. Ketika agen perlu menjelajahi web, menjalankan perintah, membaca file, atau mengontrol perangkat, alat yang digunakan.

Neotask menyediakan serangkaian alat bawaan yang kaya mencakup manajemen file, eksekusi kode, otomasi browser, kontrol perangkat, pesan, pencarian web, dan lainnya.

## Operasi File

Agen dapat membaca, menulis, dan mengedit file di workspace mereka:

- **Read**, Baca konten file
- **Write**, Buat atau timpa file
- **Edit**, Lakukan pengeditan yang ditargetkan pada bagian tertentu dari sebuah file
- **Apply Patch**, Terapkan unified diff multi-hunk untuk modifikasi file yang kompleks

## Eksekusi Kode

Agen dapat menjalankan perintah shell dengan isolasi yang dapat dikonfigurasi:

- **Eksekusi Gateway**, Jalankan perintah langsung di mesin yang menghosting Gateway
- **Eksekusi Sandbox**, Jalankan perintah dalam kontainer Docker terisolasi dengan batas sumber daya
- **Eksekusi Node**, Jalankan perintah di perangkat pendamping yang terhubung (node macOS, Linux)

### Fitur Eksekusi
- Timeout yang dapat dikonfigurasi (default 30 menit)
- Manajemen pekerjaan latar belakang (daftar, polling, kill, bersihkan)
- Latar belakang otomatis untuk perintah yang berjalan lama
- Dukungan TTY untuk program interaktif
- Mode elevated untuk operasi yang memerlukan hak istimewa (hanya host gateway)

### Alur Kerja Persetujuan
Perintah sensitif dapat memerlukan persetujuan pengguna sebelum eksekusi:
- **Allowlist**, Hanya perintah yang telah disetujui sebelumnya yang dieksekusi
- **Ask**, Perintah yang tidak dikenal meminta persetujuan
- **Full**, Tanpa pembatasan

## Otomasi Browser

Agen mengontrol browser berbasis Chromium penuh (Chrome, Brave, atau Edge):

### Aksi
- **Navigate**, Buka URL dan navigasikan antar halaman
- **Interact**, Klik, ketik, arahkan kursor, seret, pilih, isi formulir
- **Capture**, Ambil screenshot, ekspor PDF
- **Inspect**, Snapshot DOM atau pohon aksesibilitas
- **Execute**, Jalankan JavaScript dalam konteks halaman
- **Upload**, Unggah file ke formulir web
- **Manage**, Tangani dialog (peringatan, konfirmasi), baca output konsol

### Profil Browser
Beberapa profil browser terisolasi untuk memisahkan akun:
- Setiap profil memiliki cookie, penyimpanan, dan riwayatnya sendiri
- Port CDP yang ditetapkan otomatis untuk kontrol terprogram
- Dukungan browser jarak jauh (terhubung ke browser di mesin lain)

## Canvas & A2UI

Sistem Agent-to-UI (A2UI) memungkinkan agen merender konten visual interaktif di perangkat yang terhubung:

- **Present**, Tampilkan halaman web atau konten kustom di kanvas perangkat
- **Navigate**, Kontrol apa yang ditampilkan di jendela kanvas
- **Evaluate**, Jalankan JavaScript dalam konteks kanvas
- **Snapshot**, Tangkap apa yang sedang ditampilkan
- **A2UI Push**, Kirim pembaruan UI terstruktur (payload JSONL) ke kanvas
- **A2UI Reset**, Hapus status kanvas

Rendering kanvas tersedia di macOS (WebKit), iOS (SwiftUI), Android (Jetpack Compose), dan web (WebChat).

## Kemampuan Perangkat Node

Melalui aplikasi pendamping yang terhubung, agen dapat:

### Kamera
- **Snap**, Ambil foto (kamera depan atau belakang)
- **Clip**, Rekam klip video dengan durasi dan FPS yang dapat dikonfigurasi

### Layar
- **Record**, Tangkap rekaman layar dengan durasi dan kualitas yang dapat dikonfigurasi

### Lokasi
- **Get**, Ambil koordinat GPS dengan pemilihan akurasi

### Notifikasi
- **Notify**, Kirim notifikasi OS native dengan judul, isi, dan prioritas

### Perintah Sistem
- **Run**, Jalankan perintah shell di perangkat node
- **Which**, Periksa apakah perintah tersedia di node

## Pesan

Agen dapat mengirim dan mengelola pesan di seluruh saluran yang terhubung:

- **Send**, Kirim pesan ke saluran/penerima mana pun yang terhubung
- **Edit**, Edit pesan yang sebelumnya dikirim
- **React**, Tambahkan reaksi ke pesan
- **Thread**, Buat thread dan balas di dalamnya
- **Poll**, Buat polling di platform yang didukung
- **Voice**, Periksa status saluran suara (Discord)

## Web

- **Search**, Pencarian web melalui Brave Search API
- **Fetch**, Ambil halaman web dan konversi HTML ke markdown/teks

## Memori & Konteks

- **Memory Search**, Pencarian kesamaan vektor atas file memori agen
- **Memory Get**, Ambil file memori tertentu berdasarkan nama

## Manajemen Sesi

- **List Sessions**, Lihat sesi aktif di seluruh agen
- **Session History**, Ambil transkrip untuk sesi mana pun
- **Send to Session**, Kirim pesan ke sesi agen lain
- **Spawn Sub-Agent**, Mulai jalankan sub-agen terisolasi
- **List Agents**, Lihat agen yang tersedia

## Otomasi

- **Cron**, Buat, edit, jalankan, dan kelola pekerjaan terjadwal
- **Gateway**, Restart gateway, terapkan perubahan konfigurasi, jalankan pembaruan

## Analisis Gambar

Agen dapat menganalisis gambar menggunakan model visi yang dikonfigurasi, mendeskripsikan konten, mengekstrak teks, mengidentifikasi objek, dan menjawab pertanyaan tentang konten visual.

## Grup Alat

Alat diorganisir ke dalam grup untuk manajemen izin yang mudah:

| Grup | Alat |
|-------|-------|
| **runtime** | exec, bash, process |
| **fs** | read, write, edit, apply_patch |
| **sessions** | sessions_list, sessions_history, sessions_send, sessions_spawn, session_status |
| **memory** | memory_search, memory_get |
| **web** | web_search, web_fetch |
| **ui** | browser, canvas |
| **automation** | cron, gateway |
| **messaging** | message |
| **nodes** | nodes |