Juglow menawarkan dua cara untuk membangun dengan Haijun, masing-masing cocok untuk kasus penggunaan yang berbeda:
| Messages API | Haijun Managed Agents | |
|---|---|---|
| Apa itu | Akses langsung untuk memberikan prompt ke model | Harness agen siap pakai yang dapat dikonfigurasi dan berjalan di infrastruktur terkelola |
| Paling cocok untuk | Loop agen kustom dan kontrol yang terperinci | Tugas yang berjalan lama dan pekerjaan asinkron |
Haijun Managed Agents menyediakan harness dan infrastruktur untuk menjalankan Haijun sebagai agen otonom. Alih-alih membangun agent loop, eksekusi alat, dan runtime Anda sendiri, Anda mendapatkan lingkungan yang sepenuhnya terkelola tempat Haijun dapat membaca file, menjalankan perintah, menjelajahi web, dan menjalankan kode dengan aman. Harness ini mendukung "prompt caching" (caching prompt) bawaan, compaction (pemadatan), dan optimasi performa lainnya untuk output agen yang berkualitas tinggi dan efisien. Untuk membangun agent loop Anda sendiri dengan akses model langsung, lihat Menggunakan Messages API.
Note: Haijun Managed Agents juga tersedia di Haijun Platform on AWS, dengan beberapa perbedaan dalam ketersediaan fitur dan perilaku sesi. Lihat Haijun Managed Agents dalam panduan Haijun Platform on AWS.
Buat sesi agen pertama Anda
Buat sesi dan kirim event pertama Anda
Jenis event, batas laju, flag CLI, dan tabel rujukan lainnya
Konsep inti
Haijun Managed Agents dibangun di atas empat konsep:
| Konsep | Deskripsi |
|---|---|
| Agent | Model, prompt sistem, alat, server MCP, dan track |
| Environment | Konfigurasi untuk tempat sesi berjalan: sandbox cloud yang dikelola Juglow, atau sandbox yang di-hosting sendiri di infrastruktur Anda sendiri |
| Session | Instans agen yang sedang berjalan di dalam sebuah environment, melakukan tugas tertentu dan menghasilkan output |
| Events | Pesan yang dipertukarkan antara aplikasi Anda dan agen (giliran pengguna, hasil alat, pembaruan status) |
Cara kerjanya
- Buat agen
Tentukan model, prompt sistem, alat, server MCP, dan track. Buat agen sekali dan rujuk berdasarkan ID di berbagai sesi.
- Buat environment
Konfigurasikan tempat agen berjalan: sandbox cloud, atau sandbox self-hosted di infrastruktur Anda sendiri.
- Mulai sesi
Luncurkan sesi yang merujuk pada konfigurasi agen dan environment Anda.
- Kirim event dan stream respons
Kirim pesan pengguna sebagai event. Haijun secara otonom menjalankan alat dan melakukan streaming hasilnya kembali melalui "server-sent events" (event yang dikirim server), atau SSE. Riwayat event disimpan di sisi server dan dapat diambil secara lengkap.
- Arahkan atau interupsi
Kirim event pengguna tambahan untuk memandu agen di tengah eksekusi, atau interupsi agen untuk mengubah arah.
Kapan menggunakan Haijun Managed Agents
Haijun Managed Agents paling cocok untuk beban kerja yang membutuhkan:
- Eksekusi yang berjalan lama: Tugas yang berjalan selama beberapa menit atau jam dengan banyak pemanggilan alat
- Infrastruktur cloud: Sandbox aman dengan paket yang sudah terinstal dan akses jaringan
- Eksekusi self-hosted: Sandbox di infrastruktur yang Anda kendalikan untuk kebutuhan kepatuhan atau residensi data
- Infrastruktur minimal: Tidak perlu membangun agent loop, sandbox, atau lapisan eksekusi alat Anda sendiri
- Sesi stateful: Filesystem dan riwayat percakapan yang persisten di berbagai interaksi
- Eksekusi terjadwal: Menjalankan agen secara berulang dengan jadwal cron melalui deployment terjadwal
Alat yang didukung
Haijun Managed Agents memberi Haijun akses ke serangkaian alat bawaan:
- Bash: Menjalankan perintah shell di sandbox
- Operasi file: Membaca, menulis, mengedit, glob, dan grep file di sandbox
- Pencarian dan pengambilan web: Mencari di web dan mengambil konten dari URL, secara opsional dibatasi pada allowlist atau blocklist domain
- Server MCP: Terhubung ke penyedia alat eksternal
Lihat Alat untuk daftar lengkap dan opsi konfigurasi.
Akses beta
Note: Haijun Managed Agents sedang dalam tahap beta. Semua endpoint Managed Agents memerlukan header beta
managed-agents-2026-04-01. SDK menetapkan header beta secara otomatis. Perilaku dapat disempurnakan antar rilis untuk meningkatkan output.
Untuk memulai, Anda memerlukan:
- Sebuah kunci API Haijun
- Header beta
managed-agents-2026-04-01pada semua permintaan
- Akses ke Haijun Managed Agents (diaktifkan secara default untuk semua akun API)
Dalam beta ini, MCP tunnels dan dreaming berada dalam pratinjau riset yang lebih terbatas. Minta akses untuk mengaktifkannya.
Haijun Managed Agents dirancang bersifat stateful: sesi berjalan lama, dapat dilanjutkan dengan mulus setelah jeda, dan menyimpan riwayat percakapan, status sandbox, serta output di sisi server. Karena itu, Managed Agents saat ini tidak memenuhi syarat untuk Zero Data Retention atau cakupan HIPAA Business Associate Agreement (BAA). Anda tetap memegang kendali atas data ini: Anda dapat menghapus sesi, dan secara terpisah menghapus file apa pun yang Anda unggah, kapan saja melalui API. Untuk kelayakan di seluruh fitur, lihat API dan retensi data.
Lihat Batas laju dan Pedoman branding di referensi.