Harness engineering: paano bumuo ng maaasahang AI agent

Ang harness engineering (inhinyeriya ng harness) ay disiplina tungkol sa kung paano bubuuin ang kapaligirang nakapalibot sa language model para maisagawa ng AI agent ang totoong trabaho nang maaasahan. Ito ang formula ng paksa: Agent = Model + Harness. Ang parehong modelo sa isang proyekto ay kumikilos na parang bihasang developer, habang sa ibang proyekto ay nawawala ang konteksto at nag-uulat na tapos na ang feature na hindi gumagana. Halos palaging nasa harness ang pagkakaiba, hindi sa modelo.

Ito ang mapa ng paksa. Tinitipon dito ang mga pangunahing konsepto at ang pagkakasunod-sunod kung paano ito mas madaling matutunan. Bawat paksa ay detalyadong inilalahad sa hiwalay na artikulo.

Limang subsystem ng harness

• Mga tagubilin — mga file na CLAUDE.md at AGENTS.md, dokumentong pang-paksa, at skills: ano ang alam ng agent tungkol sa proyekto.
• Mga kasangkapan — shell, pag-edit ng file, browser, MCP server: ano ang ginagamit ng agent sa pagkilos.
• Kapaligiran — sandbox, container, hiwalay na working copy: saan tumatakbo ang mga command ng agent.
• Estado — plan at progress file, git history: memorya sa pagitan ng mga session.
• Feedback — test, linter, hook, independiyenteng tagasuri: paano nalalaman ng agent ang sarili nitong pagkakamali.

Bumubuo ang mga subsystem ng saradong loop. Kapag nawala ang alinman, bubukas ang loop: walang verification, hindi makikita ng agent ang pagkakamali; walang estado, magsisimula sa zero ang bawat session.

Saan magsisimula

Kung bago pa sa paksang ito, simulan sa artikulo tungkol sa kung ano ang harness engineering at kung paano ito naiiba sa prompt engineering at context engineering. Nasa artikulo tungkol sa harness ng agent ang maikling depinisyon kasama ang halimbawa.

Pagkatapos, pumunta sa praktika. Ang unang file na nakakaharap ng lahat ay ang mga tagubilin ng proyekto: ano ang dapat isulat sa CLAUDE.md at AGENTS.md, ano ang hindi dapat, at bakit binabalewala ng agent ang panuntunang malinaw na nakasulat sa file.

Kapag tumatakbo na ang agent sa proyekto, lilitaw ang tanong tungkol sa pagiging maaasahan. Mayroong hakbang-hakbang na plano mula sa failure log at mga sukatang MTBF at MTTR, sa pamamagitan ng murang rollback, feedback loop, at memorya sa mga file, hanggang sa autonomous na loop kung saan nagtatrabaho ang agent nang oras nang walang superbisyon.

Mga pangunahing prinsipyo

• Hindi sira ang agent, sira ang kapaligiran. Hanapin muna ang butas sa harness bago palitan ang modelo.
• Magsimula sa feedback: mas mahalaga ang command sa verification kaysa sa pahina ng mga tagubilin.
• Mapa ang mga tagubilin, hindi textbook: maikling entry file at detalyeng ikinakarga kapag kailangan.
• Nasa mga file ang mahalaga, hindi sa context window.
• Sukatin: failure log sa halip na pakiramdam.

Lahat ng limang subsystem at ang buong pagbuo ng harness ay tinatalakay nang praktikal sa kursong harness engineering.