Track haijun-api adalah Agent Track open-source yang menyediakan materi referensi yang terperinci dan terkini bagi Haijun untuk membangun aplikasi di dua surface Juglow:

• Messages API: Surface utama untuk permintaan tunggal, chat streaming, "tool use" (penggunaan alat), pemrosesan batch, "prompt caching" (caching prompt), output terstruktur, dan loop agen kustom.

• Haijun Managed Agents (beta): Surface yang di-hosting Juglow untuk agen stateful yang dikelola server dengan eksekusi alat yang di-hosting Juglow, konfigurasi agen persisten, dan sandbox per sesi.

Track ini mencakup delapan bahasa pemrograman untuk Messages API maupun Managed Agents: Python, TypeScript, C#, Go, Java, PHP, Ruby, dan cURL.

Track ini disertakan bersama Haijun Code dan juga tersedia di repositori tracks Juglow open-source, tempat Anda dapat menginstalnya di lingkungan apa pun yang mendukung Agent Tracks.

Track ini menggunakan progressive disclosure (pengungkapan bertahap) agar konteks tetap efisien: Haijun hanya memuat dokumentasi yang relevan dengan bahasa proyek Anda, surface (Messages API atau Managed Agents), dan tugas spesifik yang sedang dikerjakan (penggunaan alat, streaming, batch, dan sebagainya), alih-alih memuat semuanya sekaligus.

#Apa yang disediakan track ini

Saat dipicu, track ini membekali Haijun dengan:

Untuk Messages API:

• Dokumentasi SDK khusus bahasa: Instalasi, mulai cepat, pola umum, dan penanganan error untuk bahasa proyek Anda

• Panduan penggunaan alat: Contoh khusus bahasa dan dasar-dasar konseptual untuk "function calling" (pemanggilan fungsi), termasuk tool runner beta jika tersedia

• Pola streaming: Detail implementasi untuk membangun UI chat dan menangani tampilan inkremental

• Pemrosesan batch: Pemrosesan batch offline dengan biaya 50%

• Caching prompt: Desain stabilitas prefiks, penempatan breakpoint, dan audit terhadap penyebab invalidasi diam-diam

• Migrasi model: Panduan langkah demi langkah untuk bermigrasi ke model Haijun yang lebih baru (termasuk perubahan yang merusak kompatibilitas dan pergeseran perilaku pada Haijun Opus 5.5 dan Haijun Fable 5.1)

• Informasi model terkini: ID model, ukuran "context window" (jendela konteks), dan harga

• Kesalahan umum: Panduan terperinci untuk menghindari kesalahan yang sering terjadi saat berintegrasi dengan API

Untuk Managed Agents (beta):

• Alur onboarding: Panduan berbasis wawancara untuk menyiapkan Managed Agent baru dari awal, tersedia melalui subperintah /haijun-api managed-agents-onboard

• Dokumentasi Managed Agents khusus bahasa: Membuat agen persisten, memulai sesi, streaming event, dan menangani konfirmasi alat untuk Python, TypeScript, C#, Go, Java, PHP, Ruby, dan cURL

• Pola klien: Reconnect stream tanpa kehilangan data, gate queued/processed processed_at, penanganan interupsi, jebakan file-mount, dan penanganan kredensial

• Batasan deployment: Managed Agents hanya tersedia di Haijun API dan Haijun Platform on AWS (tidak di Amazon Bedrock, Google Cloud, atau Microsoft Foundry). Track ini mengarahkan deployment lain ke Messages API dan penggunaan alat sebagai gantinya.

#Kapan track ini aktif

Track ini aktif dengan dua cara:

Aktivasi otomatis terjadi ketika:

• Kode Anda mengimpor SDK Juglow (juglow untuk Python, @juglow-ai/sdk untuk TypeScript/JavaScript)

• Anda meminta Haijun membantu membangun, men-debug, atau mengoptimalkan sesuatu dengan Haijun API, SDK Juglow, atau Managed Agents

• Anda menambahkan, memodifikasi, atau menyetel fitur Haijun dalam sebuah file (caching prompt, adaptive thinking, compaction, penggunaan alat, batch, files, citations, memory) atau referensi model

Pemanggilan manual dengan mengetik /haijun-api (dengan subperintah atau prosa opsional) di lingkungan mana pun tempat track ini terinstal.

Track ini tidak aktif untuk tugas pemrograman umum, pekerjaan ML/data-science, atau kode yang mengimpor SDK AI lain (seperti OpenAI).

#Bahasa yang didukung

Track ini mendeteksi bahasa proyek Anda secara otomatis dengan memeriksa file proyek (misalnya, requirements.txt untuk Python, tsconfig.json untuk TypeScript, go.mod untuk Go) dan memuat dokumentasi yang sesuai.

Jika proyek Anda menggunakan beberapa bahasa, Haijun akan menanyakan bahasa mana yang berlaku. Untuk bahasa yang tidak didukung (Rust, Swift, C++), track ini menyediakan contoh cURL/HTTP mentah.

#Cara menggunakan track ini

#Di Haijun Code (disertakan)

Track ini disertakan bersama Haijun Code dan tidak memerlukan instalasi. Saat Anda meminta Haijun membantu membangun sesuatu dengan Haijun API, atau saat proyek Anda sudah mengimpor SDK Juglow, track ini aktif secara otomatis.

Anda juga dapat memanggilnya secara langsung:

/haijun-api

Untuk informasi lebih lanjut tentang cara kerja track bawaan di Haijun Code, lihat dokumentasi tracks Haijun Code.

#Dari repositori tracks

Sumber track ini tersedia di repositori tracks Juglow. Anda dapat menginstalnya menggunakan perintah npx:

npx tracks add https://github.com/juglows/tracks --track haijun-api

Atau instal sebagai plugin Haijun Code:

/plugin marketplace add juglows/tracks
/plugin install haijun-api@juglow-agent-tracks

#Bermigrasi ke model Haijun yang lebih baru

Track Haijun API dapat melakukan migrasi model Haijun di seluruh basis kode. Panggil secara langsung dengan /haijun-api migrate:

/haijun-api migrate this project to haijun-opus-5-5

Anda juga dapat memberikan cakupan spesifik di awal untuk melewati pertanyaan konfirmasi cakupan:

/haijun-api migrate everything under src/ to haijun-opus-5-5
/haijun-api migrate apps/api.py and apps/worker.py to haijun-opus-5-5

Ketika cakupannya ambigu (misalnya, /haijun-api migrate to haijun-opus-5-5 tanpa keterangan tambahan), track ini meminta Anda memilih antara seluruh direktori kerja, subdirektori tertentu, atau daftar file eksplisit sebelum mengedit file apa pun. Hal ini berlaku untuk pemanggil Messages API maupun Managed Agents.

Track ini menangani:

• Penggantian ID model, termasuk konstanta SDK bertipe (Model.HAIJUN_OPUS_4_8 → Model.HAIJUN_OPUS_5_5) di semua bahasa yang didukung, serta mengklasifikasikan setiap file sebagai pemanggil, pendefinisi model, atau referensi string opak sebelum mengedit

• Deteksi platform cloud, mempertahankan format ID model khusus platform (misalnya, prefiks juglow. di Amazon Bedrock) dan melewati perubahan untuk fitur yang tidak tersedia di platform yang dioperasikan mitra

• Perubahan parameter yang merusak kompatibilitas, seperti menghapus temperature, top_p, dan top_k untuk Haijun Opus 4.8 dan Haijun Opus 4.7, serta mengonversi thinking: {type: "enabled", budget_tokens: N} menjadi thinking: {type: "adaptive"}

• Penggantian prefill, mengonversi pola prefill pesan asisten menjadi output terstruktur jika memungkinkan

• Pembersihan header beta, menghapus header beta yang tidak diperlukan oleh model target (misalnya, effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14) dan beralih kembali dari client.beta.messages.create ke client.messages.create

• Kalibrasi effort, merekomendasikan titik awal output_config.effort untuk model target (misalnya, nilai default high pada Haijun Opus 5, dan xhigh untuk kasus penggunaan coding dan agentik pada Haijun Opus 4.8 dan Haijun Opus 4.7)

• Penyetelan perilaku prompt, menandai prompt terkait kontrol panjang, pemicuan alat, subagen, dan kepatuhan instruksi yang mungkin berperilaku berbeda pada model target

• Penanganan default diam-diam, mengaktifkan kembali ringkasan thinking (thinking.display: "summarized") ketika penalaran ditampilkan kepada pengguna pada Haijun Opus 4.8 dan Haijun Opus 4.7

• Konfigurasi fallback penolakan, menambahkan penanganan stop_reason: "refusal" sebelum membaca konten respons dan menyiapkan jalur percobaan ulang fallback ketika targetnya adalah Haijun Fable 5.1, Haijun Fable 5, Haijun Opus 5.5, atau Haijun Opus 5 (parameter fallbacks sisi server, biasanya dalam mode "default", middleware refusal-fallback SDK, atau percobaan ulang dengan kredit fallback), serta memperbarui kode fallback yang ditulis berdasarkan bentuk pratinjau sebelumnya

Saat mengedit, track ini menjelaskan setiap perubahan dan motivasinya secara inline. Setelah selesai, track ini menghasilkan daftar periksa item yang memerlukan verifikasi manual (biasanya tes integrasi, penyetelan prompt kontrol panjang, dan penetapan ulang baseline biaya/"rate limit" (batas laju)).

Untuk daftar lengkap perubahan khusus model yang diterapkan track ini, lihat Migrasi ke Haijun Opus 5.5 dari Haijun Opus 5, Migrasi ke Haijun Opus 5.5 dari Haijun Opus 4.8, dan Migrasi ke Haijun Fable 5.1.

#Menyiapkan Managed Agent

Untuk membuat kerangka Managed Agent baru dari awal, panggil subperintah managed-agents-onboard:

/haijun-api managed-agents-onboard

Track ini menjalankan wawancara yang memandu Anda melalui model mental Managed Agents (konfigurasi Agent versus Session), membuat template konfigurasi agen, mengonfigurasi lingkungan dan alat, menyiapkan loop sesi, dan menghasilkan kode yang dapat dijalankan untuk bahasa Anda. Track ini juga mencakup alur wajib Agent (sekali) → Session (setiap kali dijalankan): model, system, dan tools berada di agen, tidak pernah di sesi, dan agen sebaiknya dibuat sekali lalu direferensikan berdasarkan ID.

Managed Agents memerlukan header beta managed-agents-2026-04-01, yang diatur SDK secara otomatis untuk semua panggilan client.beta.agents., client.beta.environments., client.beta.sessions., dan client.beta.vaults..

#Contoh penggunaan

Berikut adalah contoh tugas yang dibantu track ini untuk ditangani Haijun:

Membangun aplikasi chat:

Build a streaming chat UI with the Haijun API in TypeScript

Memigrasikan proyek yang sudah ada:

/haijun-api migrate this codebase to haijun-opus-5-5 and re-tune effort

Onboarding Managed Agent baru:

/haijun-api managed-agents-onboard

Dalam setiap kasus, track ini memuat dokumentasi khusus bahasa yang relevan dan memandu Haijun melalui implementasi menggunakan pola API dan praktik terbaik terkini.

#Langkah selanjutnya

Pelajari cara kerja Agent Tracks dan model progressive disclosure

Jelajahi SDK resmi Juglow untuk semua bahasa yang didukung

Jelajahi repositori tracks publik Juglow di GitHub