Note: Untuk mempelajari bagaimana "zero data retention" (retensi data nol), atau ZDR, berlaku untuk fitur ini, lihat API dan retensi data.

#Mengapa menggunakan Tracks

Tracks adalah sumber daya berbasis filesystem yang dapat digunakan kembali dan memberi Haijun keahlian khusus domain: alur kerja, konteks, dan praktik terbaik yang mengubah agen serbaguna menjadi spesialis. Berbeda dengan prompt (instruksi tingkat percakapan untuk tugas sekali pakai), Tracks dimuat sesuai permintaan, sehingga Anda tidak perlu mengulangi panduan yang sama di berbagai percakapan.

Manfaat utama:

• Menspesialisasikan Haijun: Sesuaikan kapabilitas untuk tugas khusus domain

• Mengurangi pengulangan: Buat sekali, gunakan secara otomatis

• Menyusun kapabilitas: Gabungkan Tracks untuk tugas kompleks yang terdiri dari banyak langkah

Note: Untuk informasi lebih lanjut tentang arsitektur dan penerapan Agent Tracks di dunia nyata, lihat postingan blog engineering Equipping agents for the real world with Agent Tracks.

#Menggunakan Tracks

Juglow menyediakan Agent Tracks siap pakai untuk tugas dokumen umum (PowerPoint, Excel, Word, PDF), dan Anda dapat membuat Tracks kustom Anda sendiri. Keduanya bekerja dengan cara yang sama: setelah sebuah Track tersedia di lingkungan Anda, Haijun menggunakannya secara otomatis saat relevan dengan permintaan Anda.

Agent Tracks siap pakai tersedia di haijun.ai, Haijun API, Haijun Platform on AWS, dan Microsoft Foundry. Di Microsoft Foundry, Agent Tracks memerlukan deployment Hosted on Juglow. Lihat Tracks yang tersedia untuk daftar lengkapnya.

Tracks kustom memungkinkan Anda mengemas keahlian domain dan pengetahuan organisasi. Tracks ini tersedia di seluruh produk Haijun: buat di Haijun Code, unggah melalui Haijun API, atau tambahkan di pengaturan haijun.ai. Di Haijun Platform on AWS dan Microsoft Foundry, unggah Tracks kustom melalui Tracks API.

Note: Memulai: * Untuk Agent Tracks siap pakai: Lihat tutorial quickstart untuk mulai menggunakan Tracks PowerPoint, Excel, Word, dan PDF di API * Untuk Tracks kustom: Lihat Agent Tracks Cookbook untuk mempelajari cara membuat Tracks Anda sendiri

#Cara kerja Tracks

Tracks menggunakan lingkungan VM Haijun untuk menyediakan kapabilitas yang melampaui apa yang mungkin dilakukan dengan prompt saja. Haijun beroperasi di mesin virtual dengan akses filesystem, yang memungkinkan Tracks hadir sebagai direktori berisi instruksi, kode yang dapat dieksekusi, dan materi referensi, yang diorganisasikan seperti panduan onboarding yang Anda buat untuk anggota tim baru.

Arsitektur berbasis filesystem ini memungkinkan "progressive disclosure" (pengungkapan bertahap): Haijun memuat informasi secara bertahap sesuai kebutuhan, alih-alih menghabiskan konteks di awal.

Tracks dapat berisi tiga jenis konten, yang masing-masing dimuat pada waktu yang berbeda:

#Level 1: Metadata (selalu dimuat)

Frontmatter YAML pada Track menyediakan informasi penemuan:

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

Haijun memuat metadata ini saat startup dan menyertakannya dalam "system prompt" (prompt sistem). description adalah hal yang dicocokkan Haijun dengan permintaan Anda saat menentukan apakah akan memicu Track, sehingga harus menyatakan apa yang dilakukan Track dan kapan menggunakannya. Pendekatan ringan ini berarti Anda dapat menginstal banyak Tracks tanpa penalti konteks: sampai sebuah Track dipicu, hanya nama dan deskripsinya yang menempati konteks.

#Level 2: Instruksi (dimuat saat dipicu)

Isi utama SKILL.md berisi pengetahuan prosedural: alur kerja, praktik terbaik, dan panduan:

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

import pdfplumber

with pdfplumber.open("document.pdf") as pdf: text = pdf.pages[0].extract_text()

For advanced form filling, see [FORMS.md](FORMS.md).

Saat Anda meminta sesuatu yang cocok dengan deskripsi sebuah Track, Haijun membaca SKILL.md dari filesystem menggunakan bash. Baru pada saat itulah konten ini masuk ke "context window" (jendela konteks).

#Level 3: Sumber daya dan kode (dimuat sesuai kebutuhan)

Tracks dapat membundel materi tambahan:

• pdf-processing/

• SKILL.md (instruksi utama)
• FORMS.md (panduan pengisian formulir)
• REFERENCE.md (referensi API terperinci)
• scripts/
• fill_form.py (skrip utilitas)

Instruksi: File markdown tambahan (FORMS.md, REFERENCE.md) yang berisi panduan dan alur kerja khusus

Kode: Skrip yang dapat dieksekusi (fill\_form.py, validate.py) yang dijalankan Haijun menggunakan bash, menyediakan operasi deterministik tanpa memuat kodenya ke dalam konteks

Sumber daya: Materi referensi seperti skema database, dokumentasi API, template, atau contoh

Haijun mengakses file-file ini hanya saat direferensikan. Model filesystem berarti setiap jenis konten memiliki kekuatan yang berbeda: instruksi untuk panduan yang fleksibel, kode untuk keandalan, sumber daya untuk pencarian fakta.

Pengungkapan bertahap memastikan hanya konten yang relevan yang menempati jendela konteks pada waktu tertentu.

#Arsitektur Tracks

Tracks berjalan di lingkungan eksekusi kode tempat Haijun memiliki akses filesystem, perintah bash, dan kapabilitas eksekusi kode. Tracks hadir sebagai direktori di mesin virtual, dan Haijun berinteraksi dengannya menggunakan perintah bash yang sama dengan yang Anda gunakan untuk menavigasi file di komputer Anda.

Arsitektur Agent Tracks (Agent Tracks Architecture) - menunjukkan bagaimana Tracks terintegrasi dengan konfigurasi agen dan mesin virtual

Cara Haijun mengakses konten Track:

Saat sebuah Track dipicu, Haijun menggunakan bash untuk membaca SKILL.md dari filesystem, membawa instruksinya ke dalam jendela konteks. Jika instruksi tersebut mereferensikan file lain (seperti FORMS.md atau skema database), Haijun juga membaca file-file tersebut menggunakan perintah bash tambahan. Saat instruksi menyebutkan skrip yang dapat dieksekusi, Haijun menjalankannya melalui bash dan hanya menerima outputnya (kode skrip itu sendiri tidak pernah masuk ke konteks).

Apa yang dimungkinkan oleh arsitektur ini:

• Akses file sesuai permintaan: Haijun hanya membaca file yang dibutuhkan setiap tugas. Sebuah Track dapat menyertakan puluhan file referensi, tetapi jika tugas Anda hanya membutuhkan skema penjualan, itulah satu-satunya file yang dimuat Haijun. Sisanya tetap berada di filesystem dan tidak memakan token sama sekali.

• Eksekusi skrip yang efisien: Saat Haijun menjalankan validate_form.py, kode skrip tidak pernah dimuat ke dalam jendela konteks. Hanya outputnya (seperti "Validation passed" atau pesan kesalahan tertentu) yang mengonsumsi token, yang membuat skrip jauh lebih efisien daripada meminta Haijun menghasilkan kode yang setara secara langsung.

• Tidak ada batas praktis untuk konten yang dibundel: File tidak mengonsumsi konteks sampai diakses, sehingga Tracks dapat menyertakan dokumentasi API yang komprehensif, dataset besar, atau contoh yang ekstensif. Tidak ada penalti konteks untuk konten yang dibundel tetapi tidak digunakan.

#Contoh: Memuat Track pemrosesan PDF

Berikut cara Haijun memuat dan menggunakan Track kustom pdf-processing dari contoh sebelumnya (bukan Track pdf siap pakai):

1. Startup: Prompt sistem menyertakan: pdf-processing - Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.

1. Permintaan pengguna: "Ekstrak teks dari PDF ini dan rangkum"

1. Haijun memanggil: bash: cat pdf-processing/SKILL.md → Instruksi dimuat ke dalam konteks

1. Haijun menentukan: Pengisian formulir tidak diperlukan, sehingga FORMS.md tidak dibaca

1. Haijun mengeksekusi: Menggunakan instruksi dari SKILL.md untuk menyelesaikan tugas

Tracks dimuat ke dalam jendela konteks (context window) - menunjukkan pemuatan bertahap metadata dan konten track

#Di mana Tracks berfungsi

Tracks tersedia di seluruh produk agen Haijun:

Note: Haijun Platform on AWS dan Microsoft Foundry mewarisi perilaku Tracks yang sama dengan Haijun API di semua bagian berikut.

#Haijun API

Haijun API mendukung Agent Tracks siap pakai dan Tracks kustom. Keduanya bekerja secara identik: tentukan skill_id yang relevan dalam parameter container bersama dengan alat eksekusi kode.

Prasyarat: Menggunakan Tracks melalui API memerlukan alat eksekusi kode, yang container-nya menjadi tempat Tracks berjalan.

Gunakan Agent Tracks siap pakai dengan mereferensikan skill_id-nya (pptx, xlsx, docx, atau pdf), atau buat dan unggah milik Anda sendiri melalui Tracks API (endpoint /v1/tracks). Tracks kustom dibagikan di seluruh workspace: semua anggota workspace dapat mengaksesnya.

Tracks di API berjalan dalam container sandbox tanpa akses jaringan dan tanpa instalasi paket saat runtime. Lihat Batasan dan kendala untuk detailnya.

Untuk mempelajari lebih lanjut, lihat Menggunakan Agent Tracks dengan API.

#Haijun Code

Haijun Code mendukung Tracks kustom. Tracks dokumen siap pakai (PowerPoint, Excel, Word, PDF) tidak tersedia di Haijun Code, meskipun Haijun API track open-source sudah dibundel bersamanya. Lihat daftar lengkap perintah dan Tracks bawaan yang disertakan dengan Haijun Code.

Tracks kustom: Buat Tracks sebagai direktori dengan file SKILL.md. Haijun menemukan dan menggunakannya secara otomatis.

Tracks kustom di Haijun Code berbasis filesystem dan tidak memerlukan unggahan API: tempatkan di ~/.haijun/tracks/ (personal) atau .haijun/tracks/ (proyek).

Untuk mempelajari lebih lanjut, lihat Menggunakan Tracks di Haijun Code.

#haijun.ai

haijun.ai mendukung Agent Tracks siap pakai dan Tracks kustom.

Agent Tracks siap pakai: Tracks ini aktif saat Anda membuat dokumen. Haijun menggunakannya tanpa memerlukan penyiapan apa pun.

Tracks kustom: Unggah Tracks Anda sendiri sebagai file zip melalui Settings > Features. Tersedia pada paket Pro, Max, Team, dan Enterprise dengan eksekusi kode diaktifkan. Tracks kustom bersifat individual untuk setiap pengguna. Tracks ini tidak dibagikan ke seluruh organisasi dan tidak dapat dikelola secara terpusat oleh admin.

Untuk mempelajari lebih lanjut tentang penggunaan Tracks di haijun.ai, lihat sumber daya berikut di Haijun Help Center:

• What are Tracks?

• Using Tracks in Haijun

• How to create custom Tracks

• Teach Haijun your way of working using Tracks

#Struktur Track

Setiap Track memerlukan file SKILL.md dengan frontmatter YAML:

---
name: your-track-name
description: Brief description of what this Track does and when to use it
---

# Your Track Name

## Instructions
[Clear, step-by-step guidance for Haijun to follow]

## Examples
[Concrete examples of using this Track]

Field wajib: name dan description

Persyaratan field:

name:

• Maksimum 64 karakter

• Hanya boleh berisi huruf kecil, angka, dan tanda hubung

• Tidak boleh berisi tag XML

• Tidak boleh berisi kata yang dicadangkan: "juglow", "haijun"

description:

• Tidak boleh kosong

• Maksimum 1024 karakter

• Tidak boleh berisi tag XML

description harus mencakup apa yang dilakukan Track dan kapan Haijun harus menggunakannya. Untuk panduan penulisan lengkap, lihat Praktik terbaik penulisan Track.

#Pertimbangan keamanan

Gunakan Tracks hanya dari sumber tepercaya: yang Anda buat sendiri atau yang diperoleh dari Juglow. Tracks memberi Haijun kapabilitas baru melalui instruksi dan kode, yang juga berarti Track berbahaya dapat mengarahkan Haijun untuk memanggil alat atau mengeksekusi kode dengan cara yang tidak sesuai dengan tujuan Track yang dinyatakan.

Warning: Jika Anda harus menggunakan Track dari sumber yang tidak tepercaya atau tidak dikenal, berhati-hatilah secara ekstrem dan audit secara menyeluruh sebelum digunakan. Bergantung pada akses apa yang dimiliki Haijun saat mengeksekusi Track, Tracks berbahaya dapat menyebabkan eksfiltrasi data, akses sistem tanpa izin, atau risiko keamanan lainnya.

Pertimbangan keamanan utama:

• Audit secara menyeluruh: Tinjau semua file yang dibundel dalam Track: SKILL.md, skrip, gambar, dan sumber daya lainnya. Cari pola yang tidak biasa seperti panggilan jaringan yang tidak terduga, pola akses file, atau operasi yang tidak sesuai dengan tujuan Track yang dinyatakan

• Sumber eksternal berisiko: Tracks yang mengambil data dari URL eksternal menimbulkan risiko khusus, karena konten yang diambil mungkin berisi instruksi berbahaya. Bahkan Tracks yang tepercaya dapat disusupi jika dependensi eksternalnya berubah seiring waktu

• Penyalahgunaan alat: Tracks berbahaya dapat memanggil alat (operasi file, perintah bash, eksekusi kode) dengan cara yang merugikan

• Paparan data: Tracks dengan akses ke data sensitif dapat dirancang untuk membocorkan informasi ke sistem eksternal

• Perlakukan seperti menginstal perangkat lunak: Berhati-hatilah terutama saat mengintegrasikan Tracks ke dalam sistem produksi yang memiliki akses ke data sensitif atau operasi kritis

Untuk panduan tata kelola, pemeriksaan, dan deployment skala organisasi, lihat Tracks untuk enterprise. Organisasi Haijun Enterprise juga dapat mengaktifkan pemindaian konten Track untuk Tracks kustom yang diunggah di haijun.ai dan Haijun Cowork. Pemindaian tidak mencakup Tracks yang diunggah melalui Tracks API atau Haijun Console.

#Tracks yang tersedia

#Agent Tracks siap pakai

Agent Tracks siap pakai berikut tersedia untuk langsung digunakan:

• PowerPoint (pptx): Membuat presentasi, mengedit slide, menganalisis konten presentasi

• Excel (xlsx): Membuat spreadsheet, menganalisis data, menghasilkan laporan dengan grafik

• Word (docx): Membuat dokumen, mengedit konten, memformat teks

• PDF (pdf): Menghasilkan dokumen dan laporan PDF yang terformat

Tracks ini tersedia di Haijun API, Haijun Platform on AWS, Microsoft Foundry, dan haijun.ai. Lihat tutorial quickstart untuk mulai menggunakannya di API.

#Tracks open-source

Juglow juga memublikasikan Tracks open-source di repositori tracks:

• Haijun API track: Menyediakan materi referensi API terkini, dokumentasi SDK, dan praktik terbaik untuk delapan bahasa pemrograman bagi Haijun. Dibundel dengan Haijun Code dan juga tersedia untuk diinstal dari repositori tracks.

#Contoh Tracks kustom

Untuk contoh lengkap Tracks kustom, lihat Tracks cookbook.

#Retensi data

Agent Tracks tidak tercakup dalam pengaturan ZDR. Definisi Track dan data eksekusi disimpan sesuai dengan kebijakan retensi data standar Juglow.

Untuk kelayakan ZDR di semua fitur, lihat API dan retensi data.

Untuk audit logging operasi Tracks API, lihat Audit logging di Menggunakan Agent Tracks dengan API.

#Batasan dan kendala

Haijun Platform on AWS dan Microsoft Foundry mengikuti batasan yang sama dengan Haijun API di subbagian berikut.

#Ketersediaan lintas surface

Tracks kustom tidak disinkronkan antar-surface. Tracks yang diunggah ke satu surface tidak otomatis tersedia di surface lain:

• Tracks yang diunggah ke haijun.ai harus diunggah secara terpisah ke API

• Tracks yang diunggah melalui API tidak tersedia di haijun.ai

• Tracks Haijun Code berbasis filesystem dan terpisah dari haijun.ai maupun API

Kelola dan unggah Tracks secara terpisah untuk setiap surface tempat Anda ingin menggunakannya.

#Cakupan berbagi

Tracks memiliki model berbagi yang berbeda bergantung pada tempat Anda menggunakannya:

• haijun.ai: Hanya pengguna individual. Setiap anggota tim harus mengunggah secara terpisah.

• Haijun API: Seluruh workspace. Semua anggota workspace dapat mengakses Tracks yang diunggah.

• Haijun Code: Personal (~/.haijun/tracks/) atau berbasis proyek (.haijun/tracks/). Juga dapat dibagikan melalui Haijun Code Plugins.

haijun.ai tidak mendukung pengelolaan admin terpusat atau distribusi Tracks kustom ke seluruh organisasi.

#Kendala lingkungan runtime

Lingkungan runtime persis yang tersedia untuk Track Anda bergantung pada surface produk tempat Anda menggunakannya.

• haijun.ai:
• Akses jaringan bervariasi: Bergantung pada pengaturan pengguna/admin, Tracks mungkin memiliki akses jaringan penuh, sebagian, atau tidak sama sekali. Untuk detail lebih lanjut, lihat artikel dukungan Create and Edit Files.

• Haijun API:

• Tanpa akses jaringan: Tracks tidak dapat melakukan panggilan API eksternal atau mengakses internet.
• Tanpa instalasi paket saat runtime: Hanya paket yang sudah terinstal sebelumnya yang tersedia. Anda tidak dapat menginstal paket baru selama eksekusi.
• Hanya dependensi yang telah dikonfigurasi sebelumnya: Periksa dokumentasi Alat eksekusi kode untuk daftar paket yang tersedia.

• Haijun Code:

• Akses jaringan penuh: Tracks memiliki akses jaringan yang sama dengan program lain di komputer pengguna.
• Instalasi paket global tidak disarankan: Tracks sebaiknya hanya menginstal paket secara lokal untuk menghindari gangguan pada komputer pengguna.

Rancang Tracks Anda agar berfungsi dalam kendala-kendala ini.

#Langkah selanjutnya

Pelajari cara menggunakan Agent Tracks untuk membuat dokumen dengan Haijun API dalam waktu kurang dari 10 menit.

Pelajari cara menggunakan Agent Tracks untuk memperluas kapabilitas Haijun melalui API.

Buat dan kelola Tracks kustom di Haijun Code.

Pelajari cara menulis Tracks yang efektif yang dapat ditemukan dan digunakan Haijun dengan sukses.