Harness engineering: cách xây dựng AI agent đáng tin cậy
Bài viết: 8
Harness engineering (kỹ thuật harness) là ngành nghiên cứu cách xây dựng môi trường quanh mô hình ngôn ngữ để AI agent thực hiện công việc thực tế một cách đáng tin cậy. Công thức của chủ đề: Agent = Mô hình + Harness. Cùng một mô hình trong một dự án hoạt động như một lập trình viên giàu kinh nghiệm, còn trong dự án khác thì mất ngữ cảnh và báo cáo xong một tính năng chưa chạy — sự khác biệt hầu như luôn nằm ở harness chứ không phải ở mô hình.
Đây là bản đồ của chủ đề. Ở đây tập hợp các khái niệm chính và thứ tự nên học chúng. Mỗi chủ đề được trình bày chi tiết trong một bài riêng.
Năm hệ thống con của harness
- Hướng dẫn — các tệp CLAUDE.md và AGENTS.md, tài liệu theo chủ đề và skills: agent biết gì về dự án.
- Công cụ — shell, chỉnh sửa tệp, trình duyệt, máy chủ MCP: agent hành động bằng gì.
- Môi trường — sandbox, container, bản sao làm việc cách ly: agent chạy lệnh ở đâu.
- Trạng thái — tệp kế hoạch và tiến độ, lịch sử git: bộ nhớ giữa các phiên.
- Phản hồi — kiểm thử, linter, hook, người đánh giá độc lập: agent biết mình sai bằng cách nào.
Các hệ thống con tạo thành một vòng khép kín. Bỏ bất kỳ phần nào thì vòng sẽ hở: không có kiểm chứng, agent không thấy lỗi; không có trạng thái, mỗi phiên bắt đầu từ con số không.
Bắt đầu từ đâu
Nếu chủ đề còn mới với bạn, hãy bắt đầu với bài viết về harness engineering là gì và nó khác prompt engineering và context engineering ra sao. Định nghĩa ngắn kèm ví dụ nằm trong bài về harness của agent.
Sau đó chuyển sang thực hành. Tệp đầu tiên mà ai cũng gặp là hướng dẫn dự án: nên viết gì vào CLAUDE.md và AGENTS.md, không nên viết gì, và vì sao agent bỏ qua một quy tắc đã được ghi rõ trong tệp.
Khi agent đã làm việc trong dự án, câu hỏi về độ tin cậy xuất hiện. Một lộ trình từng bước dẫn từ nhật ký thất bại và các chỉ số MTBF, MTTR, qua hoàn tác rẻ, vòng phản hồi và bộ nhớ dạng tệp, đến vòng lặp tự động nơi agent làm việc hàng giờ không cần giám sát.
Nguyên tắc chính
- Agent không hỏng — môi trường mới hỏng. Hãy tìm lỗ hổng trong harness trước khi thay đổi mô hình.
- Bắt đầu từ phản hồi: một lệnh kiểm chứng có giá trị hơn một trang hướng dẫn.
- Hướng dẫn là bản đồ, không phải sách giáo khoa: tệp đầu vào ngắn, chi tiết nạp khi cần.
- Điều quan trọng phải nằm trong tệp, không nằm trong cửa sổ ngữ cảnh.
- Hãy đo lường: nhật ký thất bại thay vì cảm tính.
Toàn bộ năm hệ thống con và cách lắp ráp harness được trình bày chi tiết qua thực hành trong khoá học harness engineering.