# Agen

## Apa Itu Agen?

Agen adalah asisten AI terisolasi yang memecahkan masalah, menjalankan tugas, dan berkomunikasi di berbagai platform. Setiap agen memiliki workspace, riwayat sesi, konfigurasi model, dan binding salurannya sendiri.

## Isolasi Agen

Setiap agen mendapatkan:

- **Workspace**, Direktori khusus untuk file, catatan, dan data khusus agen
- **Sesi**, Riwayat percakapan dan transkrip independen
- **Konfigurasi**, Pemilihan model, izin alat, batas pengeluaran
- **Identitas**, Persona unik yang ditentukan dalam file `AGENTS.md` agen
- **Profil Auth**, Konfigurasi kunci API dan autentikasi per-agen

## Persona Agen

Workspace setiap agen berisi file `AGENTS.md` yang mendefinisikan kepribadian, instruksi, dan panduan perilaku. Prompt sistem persisten ini membentuk cara agen merespons, nada, keahlian domain, pemformatan, penggunaan alat, dan kebijakan keamanan.

## Routing Multi-Agen

Saat menjalankan beberapa agen, pesan masuk diarahkan secara otomatis berdasarkan **binding**:

- **Binding saluran**, Arahkan semua pesan dari platform (misalnya, semua Telegram → agen `personal`)
- **Binding server/workspace**, Arahkan server Discord tertentu atau workspace Slack ke agen khusus
- **Binding jenis obrolan**, Arahkan pesan pribadi ke satu agen dan pesan grup ke agen lainnya
- **Binding kontak/rekan**, Arahkan pesan dari kontak tertentu ke agen tertentu

Binding dievaluasi dalam urutan prioritas. Kecocokan pertama menang. Pesan yang tidak cocok masuk ke agen default.

## Sub-Agen & Delegasi

Agen dapat memunculkan sub-agen untuk tugas khusus:

- **Delegasi tugas**, Uraikan tugas kompleks dan delegasikan bagian-bagiannya ke sub-agen khusus
- **Eksekusi terisolasi**, Sub-agen berjalan dalam konteks sesi mereka sendiri
- **Percakapan bolak-balik**, Agen dapat melakukan pertukaran dua arah (hingga 5 giliran) untuk berkolaborasi
- **Pengumuman hasil**, Hasil sub-agen dapat diposting kembali ke saluran asli

## Tim & Orkestrasi

Tim multi-agen memungkinkan alur kerja yang terkoordinasi:

- **Eksekusi paralel**, Jalankan beberapa agen secara bersamaan pada aspek berbeda dari suatu tugas
- **Pipeline berurutan**, Rantai agen di mana setiap agen membangun di atas output sebelumnya
- **Mode hibrida**, Gabungkan eksekusi paralel dan berurutan
- **Pelacakan tugas**, Pantau status pekerjaan setiap agen (antrian, berjalan, selesai, kesalahan, dibatalkan)

## Profil Alat

Kendalikan apa yang dapat dilakukan setiap agen:

| Profil | Alat yang Tersedia |
|---------|----------------|
| **minimal** | Status sesi saja |
| **coding** | I/O file, eksekusi, sesi, memori, gambar |
| **messaging** | Pengiriman pesan, riwayat sesi |
| **full** | Semua alat (default) |

Daftar allow/deny kustom dapat diatur per-agen dan per-penyedia model.

## Safe Mode

Safe Mode menyediakan sandbox eksekusi:

- **Toggle master**, Aktifkan atau nonaktifkan secara global
- **Kontrol per-agen**, Nonaktifkan untuk agen tepercaya, pertahankan untuk yang lainnya
- **Persetujuan eksekusi**, Operasi sensitif memerlukan persetujuan pengguna yang eksplisit
- **Sinkronisasi kebijakan**, Pengaturan disinkronkan di semua klien yang terhubung secara real time

## Memori Agen

Setiap agen memiliki akses ke sistem memori:

- **MEMORY.md**, Catatan persisten dan informasi penting lintas sesi
- **File memori**, Pengetahuan terstruktur tambahan di `memory/`
- **Pencarian vektor**, Cari memori menggunakan kueri bahasa alami

Lihat [Sesi & Memori](sessions-memory.md) untuk detail lebih lanjut.