# Gambaran Umum Platform

## Apa Itu Neotask?

**Gateway** adalah mesin inti yang mendukung Neotask. Ini adalah sebuah layanan yang berjalan lama yang mengelola segalanya: sesi agen, integrasi pesan, eksekusi alat, otomasi terjadwal, dan koneksi perangkat.

Bayangkan sebagai otak yang terhubung ke aplikasi desktop Neotask, aplikasi mobile, dan dasbor web Anda. Sementara Anda berinteraksi melalui antarmuka tersebut, Gateway melakukan pekerjaan berat di balik layar.

## Arsitektur

Neotask menggunakan model hub-and-spoke:

- **Gateway** adalah hub pusat, server WebSocket yang berjalan di mesin Anda (atau di cloud). Ini mengelola semua sesi agen, merutekan pesan antar channel, mengorkestrasikan eksekusi alat, dan mempertahankan status.
- **Klien** (aplikasi desktop, aplikasi mobile, dasbor web, atau terminal) terhubung ke Gateway dan mengirim/menerima pesan melaluinya.
- **Node** (aplikasi pendamping di iOS, Android, macOS) mengekspos kemampuan perangkat, kamera, kanvas, perekaman layar, lokasi, dan suara, ke agen yang berjalan di Gateway.
- **Channel** (WhatsApp, Telegram, Discord, Slack, dll.) adalah transport pesan yang terhubung ke Gateway untuk mengirim dan menerima pesan.

Semua operasi AI melalui pipeline Gateway → LLM Provider. Aplikasi desktop tidak pernah memanggil LLM secara langsung.

## Kemampuan Utama

### Pesan Multi-Channel
Terhubung ke 20+ platform pesan secara bersamaan. Agen Anda dapat mengirim dan menerima pesan di WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Google Chat, Microsoft Teams, Matrix, IRC, dan lainnya, semuanya dari satu instans Gateway. Lihat [Channel](channels.md).

### Sistem Multi-Agen
Jalankan beberapa agen terisolasi, masing-masing dengan workspace, kepribadian, konfigurasi model, dan binding channel sendiri. Arahkan pesan masuk dari channel, server, atau kontak tertentu ke agen yang tepat secara otomatis. Lihat [Agen](agents.md).

### Kemampuan Perangkat melalui Node
Hubungkan aplikasi pendamping iOS, Android, dan macOS sebagai "node" yang mengekspos perangkat keras perangkat ke agen Anda. Agen dapat mengambil foto, merekam video, menangkap layar, mendapatkan lokasi GPS, merender kanvas interaktif, dan menjalankan perintah sistem, semuanya melalui bahasa alami. Lihat [Aplikasi Pendamping](companion-apps.md).

### Otomasi Browser
Agen dapat mengontrol browser Chromium penuh, membuka halaman, mengklik elemen, mengisi formulir, mengambil screenshot, mengekstrak konten, mengunggah file, dan menjalankan JavaScript. Beberapa profil browser didukung untuk isolasi akun. Lihat [Alat & Kemampuan](tools-capabilities.md).

### Canvas & A2UI
Sistem Agent-to-UI (A2UI) memungkinkan agen merender konten visual interaktif di perangkat yang terhubung. Agen dapat menyajikan halaman web, mendorong pembaruan UI terstruktur, menjalankan JavaScript dalam konteks kanvas, dan mengambil snapshot dari apa yang ditampilkan. Lihat [Alat & Kemampuan](tools-capabilities.md).

### Dukungan Model Fleksibel
Gunakan penyedia LLM besar apa pun, Anthropic (Claude), OpenAI (GPT), Google (Gemini), Together AI, Moonshot, OpenRouter, dan lainnya. Konfigurasikan rantai fallback model, alias, dan override model per-agen. Jalankan model lokal melalui Ollama atau vLLM. Lihat [Model & Penyedia](models-providers.md).

### Ekosistem Plugin & Skill
Perluas Neotask dengan plugin yang menambahkan channel baru, alat, metode RPC, dan kemampuan. Jelajahi skill yang tersedia di [katalog skill](/skills). Buat skill Anda sendiri untuk mengajarkan alur kerja baru kepada agen. Lihat [Plugin & Skill](plugins-skills.md).

### Penjadwalan & Otomasi
Jadwalkan wakeup agen dengan ekspresi cron, pengingat one-shot, atau trigger berbasis interval. Agen dapat menjalankan tugas otomatis, mengirimkan hasil ke channel, atau memposting ke webhook. Lihat [Otomasi](automation.md).

### Interaksi Suara
Gunakan wake word untuk mengaktifkan agen Anda melalui suara. Mode bicara memungkinkan percakapan suara berkelanjutan dengan speech-to-text dan text-to-speech real-time (ElevenLabs, OpenAI). Daemon Swabble di macOS menyediakan deteksi suara on-device yang selalu aktif. Lihat [Suara](voice.md).

### Kecerdasan Sesi
Sesi secara otomatis direset setiap hari, dikompak ketika mendekati batas konteks, dan bertahan di seluruh restart. Pencarian memori memungkinkan agen mengingat informasi dari percakapan sebelumnya menggunakan kesamaan vektor. Lihat [Sesi & Memori](sessions-memory.md).

### Self-Hosted & Privat
Semuanya berjalan di infrastruktur Anda. Pesan, kunci API, dan data agen Anda tidak pernah meninggalkan mesin Anda kecuali Anda secara eksplisit mengonfigurasi layanan eksternal. Gateway mengikat ke localhost secara default, tanpa eksposur jaringan eksternal.

### Eksekusi Sandbox
Jalankan perintah agen dalam kontainer Docker terisolasi dengan batas sumber daya, kebijakan jaringan, dan pembatasan sistem file yang dapat dikonfigurasi. Profil sandbox per-agen memungkinkan Anda mengontrol dengan tepat apa yang dapat diakses setiap agen. Lihat [Keamanan](security.md).

## Bagaimana Semuanya Bekerja Bersama

1. **Anda** berinteraksi dengan agen melalui aplikasi desktop Neotask, aplikasi pendamping mobile, atau langsung melalui platform pesan seperti WhatsApp atau Telegram.
2. **Gateway** menerima pesan Anda, merutekannya ke agen yang tepat, dan memulai giliran AI.
3. **Agen** memproses permintaan Anda menggunakan LLM yang dikonfigurasi (Claude, GPT, dll.), memanggil alat yang diperlukan (browser, kanvas, operasi file, perintah shell), dan menghasilkan respons.
4. **Respons** dikirimkan kembali kepada Anda melalui channel yang sama, atau diumumkan di channel yang berbeda jika dikonfigurasi.
5. **Status** (transkrip sesi, konfigurasi agen, pekerjaan terjadwal) disimpan secara lokal sehingga semuanya bertahan dari restart.