Istilah

Harness agen: apa itu dan terdiri dari apa saja

Diperbarui: · Skillaria.Top

Harness agen adalah semua yang mengelilingi model bahasa di dalam agen AI dan menjadikannya alat kerja: instruksi, alat, lingkungan eksekusi, status antarsesi, dan lingkaran umpan balik. Agen = Model + Harness: model bernalar, sedangkan harness memberinya aturan, tangan, memori, dan pemeriksaan hasil.

Definisi

Harness agen (agent harness) adalah lapisan perangkat lunak di sekitar model bahasa: semua yang bukan model itu sendiri, tetapi memengaruhi cara kerja agen. Rumusnya: Agen = Model + Harness. Model mampu bernalar dan menulis kode, sedangkan harness menentukan apa yang dilihatnya, dengan apa ia bisa bertindak, di mana perintah dijalankan, apa yang tersimpan antarsesi, dan bagaimana agen mengetahui kesalahannya.

Lima bagian harness

  • Instruksi — prompt sistem dan file proyek seperti CLAUDE.md dan AGENTS.md, dokumen tematik, dan skills.
  • Alat — menjalankan perintah di shell, mengedit file, browser, dan koneksi melalui MCP.
  • Lingkungan — sandbox atau kontainer tempat agen menjalankan kode tanpa risiko bagi produksi.
  • Status — file rencana dan kemajuan, riwayat git: memori yang bertahan setelah sesi ditutup.
  • Umpan balik — tes, linter, pemeriksaan tipe, dan hook yang mengembalikan sinyal kesalahan kepada agen.

Harness bukan satu file prompt. AGENTS.md yang panjang tidak membantu jika agen tidak punya akses ke tes atau lingkungan tidak bisa dinyalakan. Keandalan ditentukan oleh bagian yang paling lemah dari lima bagian tersebut.

Contoh

Agen memperbaiki bug yang sama untuk ketiga kalinya berturut-turut: setiap kali dimulai ulang, ia lupa apa yang sudah dicoba. Sepintas tampak model yang bermasalah. Padahal yang rusak adalah subsistem status. Solusinya adalah file PROGRESS.md, tempat agen mencatat hipotesis yang gagal dan langkah berikutnya di akhir sesi:

## Bug: pemotongan ganda saat permintaan diulang
Sudah dicek dan ditolak:
- timeout klien HTTP — tidak berpengaruh
- race condition di handler webhook — tidak bisa direproduksi
Langkah berikutnya: periksa kunci idempotensi di payments/service.py

Sesi baru membaca file itu dan langsung melanjutkan dari titik yang tepat. Modelnya tidak berubah — yang berubah adalah harness.

Ringkasan

Harness agen adalah instruksi, alat, lingkungan, status, dan umpan balik di sekitar model. Justru harnesslah yang menentukan apakah agen yang sama akan bekerja andal atau gagal. Cara menyusun setiap bagian dibahas langsung dalam praktik di kursus harness engineering.

Pertanyaan umum

Apa bedanya harness dengan framework agen?

Framework adalah pustaka untuk membangun agen. Harness adalah konfigurasi spesifik di sekitar model untuk proyek Anda: aturan, akses, lingkungan, tes, dan file status. Agen siap pakai seperti Claude Code sudah memiliki harness dasar yang bisa Anda lengkapi.

Apakah harness dan prompt itu sama?

Tidak. Prompt hanyalah sebagian dari subsistem instruksi. Harness juga mencakup alat, lingkungan, memori antarsesi, dan verifikasi hasil.

Bagian harness mana yang sebaiknya dibangun lebih dulu?

Umpan balik: berikan agen perintah yang bisa dipakainya untuk memeriksa pekerjaannya sendiri. Ini paling cepat mengurangi kesalahan yang sampai ke manusia.

Pelajari topik ini lewat video

Topik ini dibahas mendalam dengan praktik di kursus “Harness Engineering: инженерия надёжности AI-агентов”.

Ke kursus