Thuật ngữ

Harness của agent là gì và gồm những thành phần nào

Cập nhật: · Skillaria.Top

Harness của agent là mọi thứ bao quanh mô hình ngôn ngữ trong một AI agent và biến nó thành công cụ làm việc: hướng dẫn, công cụ, môi trường chạy, trạng thái giữa các phiên và vòng phản hồi. Agent = Mô hình + Harness: mô hình suy luận, còn harness cung cấp quy tắc, đôi tay, bộ nhớ và cơ chế kiểm chứng kết quả.

Định nghĩa

Harness của agent (agent harness) là lớp phần mềm bao quanh mô hình ngôn ngữ: tất cả những gì không phải là chính mô hình nhưng ảnh hưởng đến cách agent làm việc. Công thức là Agent = Mô hình + Harness. Mô hình biết suy luận và viết mã, còn harness quyết định nó nhìn thấy gì, có thể hành động bằng cách nào, lệnh được chạy ở đâu, điều gì được lưu giữa các phiên và agent biết mình sai bằng cách nào.

Năm phần của harness

  • Hướng dẫn — system prompt và các tệp dự án như CLAUDE.md và AGENTS.md, tài liệu theo chủ đề và skills.
  • Công cụ — chạy lệnh trong shell, sửa tệp, trình duyệt, kết nối qua MCP.
  • Môi trường — sandbox hoặc container nơi agent chạy mã mà không gây rủi ro cho production.
  • Trạng thái — tệp kế hoạch và tiến độ, lịch sử git: bộ nhớ tồn tại sau khi phiên đóng lại.
  • Phản hồi — kiểm thử, linter, kiểm tra kiểu, hook trả về tín hiệu lỗi cho agent.

Harness không phải chỉ là một tệp prompt. Một tệp AGENTS.md dài cũng không giúp được gì nếu agent không có quyền truy cập kiểm thử hoặc môi trường không khởi động được. Độ tin cậy được quyết định bởi phần yếu nhất trong năm phần đó.

Ví dụ

Agent sửa cùng một lỗi suốt ba phiên liên tiếp: sau mỗi lần khởi động lại, nó không nhớ đã thử gì. Có vẻ như lỗi nằm ở mô hình. Thực tế, hệ thống con trạng thái đã hỏng. Giải pháp là một tệp PROGRESS.md, trong đó agent ghi vào cuối mỗi phiên các giả thuyết không hiệu quả và bước tiếp theo:

## Lỗi: trừ tiền hai lần khi lặp lại yêu cầu
Đã kiểm tra và loại bỏ:
- timeout của HTTP client — không ảnh hưởng
- race condition trong webhook handler — không tái hiện được
Bước tiếp theo: kiểm tra idempotency key trong payments/service.py

Phiên mới đọc tệp và tiếp tục ngay đúng chỗ cần làm. Mô hình không thay đổi, nhưng harness thì đã thay đổi.

Tóm lại

Harness của agent là hướng dẫn, công cụ, môi trường, trạng thái và phản hồi bao quanh mô hình. Chính nó quyết định một agent có làm việc đáng tin cậy hay hỏng hóc. Cách lắp ráp từng phần được trình bày chi tiết qua thực hành trong khoá học harness engineering.

Câu hỏi thường gặp

Harness khác gì framework cho agent?

Framework là thư viện để xây dựng agent. Harness là cấu hình cụ thể quanh mô hình cho dự án của bạn: quy tắc, quyền truy cập, môi trường, kiểm thử và tệp trạng thái. Một agent có sẵn như Claude Code đã có harness cơ bản, và bạn bổ sung phần còn lại.

Harness và prompt có phải là một không?

Không. Prompt chỉ là một phần của hệ thống con hướng dẫn. Harness còn bao gồm công cụ, môi trường, bộ nhớ giữa các phiên và kiểm chứng kết quả.

Nên bắt đầu từ phần nào của harness?

Từ phản hồi: hãy cung cấp cho agent các lệnh để tự kiểm tra công việc của mình. Cách này nhanh chóng giảm số lỗi đến tay con người nhất.

Học chủ đề này qua video

Chủ đề này được giảng chi tiết kèm thực hành trong khóa học “Harness Engineering: инженерия надёжности AI-агентов”.

Đến khóa học