Agent harness คืออะไรและประกอบด้วยอะไรบ้าง

คำนิยาม

Agent harness คือชั้นซอฟต์แวร์ที่อยู่รอบโมเดลภาษา คือทุกอย่างที่ไม่ใช่ตัวโมเดลเอง แต่มีผลต่อวิธีที่ agent ทำงาน สูตรคือ Agent = Model + Harness โมเดลรู้วิธีให้เหตุผลและเขียนโค้ด ส่วน harness ตัดสินว่ามันเห็นอะไร ลงมือได้ด้วยวิธีใด คำสั่งถูกรันที่ไหน อะไรถูกเก็บไว้ข้ามเซสชัน และ agent รู้ได้อย่างไรว่าตัวเองทำผิด

ห้าส่วนของ harness

• คำสั่ง — system prompt และไฟล์ของโปรเจกต์ เช่น CLAUDE.md และ AGENTS.md เอกสารเฉพาะเรื่อง และ skills
• เครื่องมือ — การรันคำสั่งใน shell การแก้ไขไฟล์ เบราว์เซอร์ การเชื่อมต่อผ่าน MCP
• สภาพแวดล้อม — sandbox หรือ container ที่ agent รันโค้ดได้โดยไม่กระทบ production
• สถานะ — ไฟล์แผนงานและความคืบหน้า git history คือความจำที่คงอยู่แม้ปิดเซสชันแล้ว
• วงป้อนกลับ — tests, linter, การตรวจชนิดข้อมูล, hooks ที่ส่งสัญญาณข้อผิดพลาดกลับไปให้ agent

Harness ไม่ใช่ไฟล์ prompt เพียงไฟล์เดียว AGENTS.md ที่ยาวก็ช่วยอะไรไม่ได้ ถ้า agent ไม่มีสิทธิ์เข้าถึงเทสต์ หรือสภาพแวดล้อมเปิดไม่ขึ้น ความน่าเชื่อถือถูกกำหนดโดยส่วนที่อ่อนที่สุดในห้าส่วนนี้

ตัวอย่าง

agent แก้บั๊กเดิมซ้ำสามเซสชันติดต่อกัน เพราะทุกครั้งที่รีสตาร์ตมันจำไม่ได้ว่าลองอะไรไปแล้ว ดูเหมือนปัญหาจะอยู่ที่โมเดล แต่ความจริงระบบย่อยด้านสถานะเสียอยู่ วิธีแก้คือไฟล์ PROGRESS.md ซึ่ง agent บันทึกสมมติฐานที่ไม่ได้ผลและขั้นตอนถัดไปไว้ตอนท้ายเซสชัน:

## บั๊ก: ตัดเงินซ้ำเมื่อส่งคำขอซ้ำ
ตรวจแล้วและตัดออก:
- timeout ของ HTTP client — ไม่มีผล
- race condition ใน webhook handler — ทำซ้ำไม่ได้
ขั้นตอนถัดไป: ตรวจ idempotency key ใน payments/service.py

เซสชันใหม่อ่านไฟล์และทำงานต่อจากจุดที่ถูกต้องได้ทันที โมเดลไม่ได้เปลี่ยน แต่ harness เปลี่ยนไปแล้ว

สรุป

Agent harness คือคำสั่ง เครื่องมือ สภาพแวดล้อม สถานะ และวงป้อนกลับที่อยู่รอบโมเดล สิ่งนี้เป็นตัวกำหนดว่า agent ตัวเดียวกันจะทำงานได้น่าเชื่อถือหรือพังลง วิธีประกอบแต่ละส่วนถูกอธิบายในทางปฏิบัติในหลักสูตร harness engineering