SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor

Agent harness là gì và cách nó vận hành AI agent

Agent harness là chương trình bao quanh LLM để duy trì vòng lặp, quản lý công cụ và trạng thái phiên làm việc. Tìm hiểu sự khác biệt giữa harness, model và framework thực tế.

Agent harness là gì

Agent harness là chương trình chạy bao quanh một language model và biến nó thành một agent. Nó duy trì vòng lặp liên tục gọi model, chứa các định nghĩa công cụ mà model được phép sử dụng, các quy tắc cấp quyền quyết định lệnh gọi nào được thực thi, trạng thái phiên làm việc được lưu giữ giữa các lượt, và thư mục làm việc nơi các tác vụ diễn ra. Bạn có thể thay thế model bên trong harness này.

Câu cuối cùng là điểm quan trọng nhất. Một model đơn lẻ chỉ trả lời câu hỏi rồi quên bạn ngay sau đó. Một harness sẽ hỏi model bước tiếp theo cần làm gì, thực thi lệnh mà model yêu cầu, trả kết quả về cho model, rồi lại tiếp tục hỏi. Sự lặp lại đó chính là ý nghĩa của thuật ngữ "agent". Nếu các thuật ngữ xung quanh vẫn còn mơ hồ, sự khác biệt giữa AI agent, LLM và assistant sẽ giúp bạn làm rõ các khái niệm trước khi chọn công cụ.

Harness không phải là model

Hai khái niệm này dễ bị nhầm vì các vendor phát hành chúng dưới cùng một tên thương hiệu.

dsh và DeepSeek là hai sản phẩm khác nhau. DeepSeek Harness, được phát hành tại github.com/deepseek-ai/deepseek-harness vào ngày 13 August 2026 theo giấy phép MIT, là một chương trình Node mà bạn cài trên một máy. Các model DeepSeek là các bộ trọng số được cung cấp phía sau một API (application programming interface). Trỏ dsh đến một model của vendor khác thì nó vẫn hoạt động, vì harness chỉ cần một thành phần chấp nhận message và trả về các tool call.

Claude Code và Claude cũng là một cặp tương tự. Claude Code là một harness: chương trình terminal có vòng lặp, hệ thống cấp quyền, cùng các tool cho file và shell. Claude là họ model mà chương trình gọi theo mặc định. Codex và Gemini CLI cũng được tách theo cách tương tự.

Đây là bài kiểm tra luôn cho kết quả rõ ràng. Bạn cài một harness. Bạn gọi một model. Nếu thành phần đó có version trên disk và một file cấu hình trong thư mục home của bạn, đó là harness. Nếu nó là một chuỗi bên trong file cấu hình đó, chẳng hạn như deepseek-flash, thì đó là model.

Vòng lặp thực sự hoạt động như thế nào

Một lượt chạy của vòng lặp harness trông như sau. Hãy đọc kỹ, vì hầu hết sự khác biệt giữa các harness đều nằm trong năm bước này.

  1. Harness gửi nội dung hội thoại hiện tại, cùng với danh sách định nghĩa các công cụ, tới model.
  2. Model phản hồi bằng văn bản hoặc yêu cầu gọi một trong các công cụ đó.
  3. Harness kiểm tra yêu cầu đó dựa trên các quy tắc cấp quyền, sau đó thực thi hoặc dừng lại để hỏi bạn.
  4. Harness chạy công cụ, ghi lại đầu ra và mã thoát (exit code), đồng thời cắt bớt đầu ra nếu nó quá dài.
  5. Harness thêm kết quả đó vào hội thoại và quay lại bước 1.

Bước 3 là nơi các harness khác biệt nhiều nhất trong quá trình sử dụng hàng ngày. Một harness luôn hỏi trước mỗi lệnh thì an toàn nhưng gây mệt mỏi. Một harness không bao giờ hỏi sẽ có lúc chạy một lệnh phá hoại trên đường dẫn mà model xác định sai. Claude Code hỗ trợ một thiết lập trung gian: danh sách cho phép (allowlist) các lệnh chạy không cần hỏi, và yêu cầu xác nhận cho các lệnh khác.

Bước 1 là nơi chứa những khác biệt còn lại. Harness cũng viết system prompt đi kèm trong mỗi yêu cầu đó, và Claude Code cho phép bạn tùy chỉnh trực tiếp, vì một kiểu đầu ra sẽ chỉnh sửa system prompt mà nó gửi và từ đó thay đổi mọi phản hồi nhận lại. Hội thoại dài ra sau mỗi lượt và model có một cửa sổ ngữ cảnh (context window) cố định, vì vậy harness phải quyết định nội dung nào cần loại bỏ, nội dung nào cần tóm tắt, và nội dung nào cần ghi ra file để đọc lại sau. Quyết định đó là lý do chính khiến hai harness cùng điều khiển một model lại tạo ra chất lượng công việc khác nhau. Nếu năm bước này vẫn còn trừu tượng, cách giải quyết là hãy tự viết một vòng lặp đơn giản, đó chính xác là những gì một lộ trình từng bước để học về AI agent yêu cầu bạn xây dựng ngay từ đầu.

Hầu hết các harness hiện nay kết nối các công cụ bên ngoài thông qua MCP (model context protocol), một tiêu chuẩn để cung cấp công cụ cho bất kỳ harness nào hỗ trợ nó, nhờ đó một tích hợp có thể dùng cho nhiều harness. Chạy các MCP server trên VPS đề cập đến khía cạnh này. Tìm kiếm web thường là công cụ đầu tiên mọi người thêm vào, và trỏ agent vào instance SearXNG của riêng bạn giúp giữ các truy vấn không qua bên thứ ba, đồng thời làm rõ rằng mọi trang mà agent đọc sau đó đều là dữ liệu đầu vào không đáng tin cậy đi vào trong vòng lặp.

Agent harness so với agent framework

Câu hỏi này xuất hiện mỗi khi một harness mới ra mắt, và các câu trả lời thường không thống nhất, một phần vì các nhà cung cấp cũng không đồng nhất quan điểm. Dưới đây là cách phân biệt hợp lý nhất.

Framework là một thư viện mà bạn import. Bạn tự lắp ghép agent trong code, sử dụng vòng lặp của framework hoặc tự viết vòng lặp riêng. LangChain là ví dụ điển hình: bạn nhận được các khối xây dựng và tự lắp ghép agent bằng code.

Harness là một chương trình mà bạn chạy. Vòng lặp đã được viết sẵn, các công cụ đã tồn tại, mô hình phân quyền đã có mặc định. Bạn có ngay một agent hoạt động từ lệnh đầu tiên và cấu hình nó từ đó.

Bài kiểm tra cài đặt thường là yếu tố quyết định. Nếu bạn cài đặt rồi mới viết code, đó là framework. Nếu bạn cài đặt rồi tương tác trực tiếp với nó, đó là harness.

Ranh giới này thực sự gây tranh cãi, và bằng chứng rõ ràng nhất nằm trong chính tài liệu của LangChain. Tính đến tháng 10 năm 2026, họ gọi Deep Agents là "một agent harness" và cũng là "một thư viện độc lập được xây dựng trên các khối xây dựng cốt lõi của LangChain cho agent", trong khi kho lưu trữ langchain-ai/deepagents tự gọi mình là "agent harness đầy đủ tính năng". Cả hai mô tả đều đúng. Deep Agents là một Python SDK (bộ công cụ phát triển phần mềm) mà bạn import, nên bài kiểm tra cài đặt xác định nó là thư viện, nhưng nó cung cấp đủ hành vi mặc định để người dùng sử dụng nó như một harness. Microsoft đã công bố tính khả dụng chung cho Hosted Agents trong Foundry Agent Service vào ngày 9 tháng 7 năm 2026, và bài đăng ngày 22 tháng 7 năm 2026 của họ thông báo về việc phát hành Microsoft Agent Framework Harness, cho thấy từ này hiện đã trở thành một danh mục sản phẩm thay vì chỉ là thuật ngữ chuyên môn.

Vì vậy, hãy đặt câu hỏi dự đoán khối lượng công việc của bạn thay thế. Nếu bạn viết vòng lặp, bạn sở hữu vòng lặp đó: các lần thử lại, việc cắt tỉa context, các prompt xin quyền và bản ghi lại những gì đã xảy ra. Nếu vòng lặp được cung cấp sẵn, bạn kế thừa giải pháp của người khác cho tất cả các vấn đề đó, giúp bắt đầu nhanh hơn nhiều nhưng khó thay đổi hơn về sau.

Sự khác biệt giữa harness và cửa sổ chat

Cửa sổ chat và harness đều hiển thị kết quả đầu ra của model. Sự khác biệt nằm ở việc công việc được thực thi trên máy tính nào. Trong cửa sổ chat, bất kỳ mã nào model chạy đều được thực thi bên trong sandbox của nhà cung cấp, trên các file bạn đã tải lên. Một harness chạy các công cụ trên máy mà bạn đã khởi chạy nó, với tư cách là người dùng đã khởi chạy nó, tác động trực tiếp lên các file thực tế của bạn, với các thông tin xác thực thực tế của bạn trong môi trường đó.

Đó là toàn bộ ưu điểm và toàn bộ rủi ro chỉ trong hai câu. Agent cuối cùng có thể thực hiện công việc. Agent cũng có thể xóa công việc đó.

Các harness mà mọi người đang thực sự chạy

Danh sách này được cố tình ghi ngày 19 tháng 8 năm 2026. Danh mục này thay đổi hàng tuần và bất kỳ bản tổng hợp nào cũng nhanh chóng trở nên lỗi thời.

  • Claude Code và Codex là các harness của nhà cung cấp. Ưu tiên terminal, mặc định gắn liền với các model của chính nhà cung cấp đó, với cơ chế xử lý quyền hạn được trau chuốt nhất. So sánh Claude Code, Cursor, Codex và Copilot sẽ phân tích kỹ về chúng.
  • DeepSeek Harness (dsh) được cấp phép theo MIT và xây dựng trên một ý tưởng: mọi thứ đều là plugin, vì vậy model, công cụ, phiên làm việc, sandbox và giao diện người dùng đều là các thành phần có thể thay thế. Mỗi plugin bạn cài đặt đều chạy với quyền hạn riêng của agent, vì vậy kiểm tra những gì plugin dsh có thể truy cập trước khi thêm nó quan trọng hơn ở đây so với các harness có bộ công cụ cố định.
  • Hermes, từ Nous Research, là một agent tự hành tổng quát thay vì là một công cụ lập trình. Nó được phát hành theo giấy phép MIT vào tháng 2 năm 2026 và bộ nhớ tích hợp của nó là cục bộ: các bộ nhớ và kỹ năng của nó nằm dưới dạng file tại ~/.hermes, còn lịch sử phiên làm việc nằm trong một cơ sở dữ liệu SQLite cục bộ. Điều này không còn đúng hoàn toàn khi bạn bật một trong các nhà cung cấp bộ nhớ ngoài tùy chọn của nó, chẳng hạn như Mem0 hoặc Hindsight. Tính đến tháng 10 năm 2026, tài liệu của Hermes cho biết một nhà cung cấp đang hoạt động sẽ nhận được mỗi lượt hội thoại sau mỗi phản hồi và một bản sao của mọi thao tác ghi bộ nhớ tích hợp, vì vậy dữ liệu của bạn khi đó cũng sẽ nằm tại nhà cung cấp đó. So sánh Hindsight và Mem0 là nội dung đáng đọc trước khi bạn bật một trong hai, và Tự host Hermes trên VPS sẽ hướng dẫn các bước còn lại.
  • Omnigent là một meta-harness: nó điều khiển các harness khác, bao gồm Claude Code và Codex, đằng sau một API duy nhất với các phiên làm việc chia sẻ, giới hạn chi tiêu và sandbox ở cấp độ hệ điều hành. Omnigent dưới dạng harness đa agent bao gồm những lợi ích mà nó mang lại cho bạn.
  • OneCLI là một harness chạy trong sandbox nhắm đến các nhóm, được xây dựng xung quanh một gateway có chức năng chèn thông tin xác thực vào các yêu cầu gửi đi của agent, vì vậy bản thân agent không bao giờ nhìn thấy các key thực.

Ba trong số các công cụ trên thường xuyên xuất hiện trong danh sách rút gọn đến mức bạn nên đọc So sánh DeepSeek Harness, Claude Code và Omnigent về khả năng kết nối model, giấy phép, độ hoàn thiện và những gì cần thiết để chạy từng loại trên máy chủ.

Lệnh khởi động nhanh dsh chỉ là một dòng lệnh duy nhất, và chạy nó một lần là cách nhanh nhất để xem một harness là gì. Nó yêu cầu Node.js trên máy.

npx @deepseek-ai/dsh web

Lệnh đó khởi động web UI (giao diện người dùng) tại http://127.0.0.1:3080. Hãy đọc README trước khi bạn tin dùng nó, vì dsh tự mô tả là bản xem trước dành cho nhà phát triển và nói rõ rằng sẽ có những thay đổi gây mất tương thích. Nếu lệnh đầu tiên đó thất bại hoàn toàn hoặc tải về một bản build mà bạn không mong đợi, ghim một phiên bản dsh cụ thể và xóa cache npx thường là cách giúp bạn tiếp tục công việc. Chạy DeepSeek Harness trên VPS bao gồm phần cài đặt máy chủ, và tại sao địa chỉ đó bắt đầu bằng 127.0.0.1 giải thích về mặc định loopback.

Router nằm phía trên harness

Một model router đóng vai trò là proxy cục bộ giữa harness và API của nhà cung cấp. Claude Code Router là ví dụ phổ biến: nó mặc định bind vào 127.0.0.1:3456, tiếp nhận các request mà Claude Code lẽ ra sẽ gửi trực tiếp đến nhà cung cấp, rồi chuyển tiếp chúng đến provider mà bạn đã cấu hình. Harness không hề biết có sự thay đổi nào.

Router tồn tại vì model có thể thay thế được, do đó chúng là minh chứng rõ ràng cho luận điểm chính của bài viết này. Chúng cũng tập trung rủi ro, vì proxy nhìn thấy mọi prompt và nắm giữ mọi key của nhà cung cấp. Hãy coi nó là hạ tầng, không phải là một tiện ích. Nơi harness lưu trữ API key và cài đặt model cũng là vấn đề tương tự ở một tầng thấp hơn.

Những thay đổi khi chạy harness trên VPS

Có bốn điều thay đổi khi bạn chuyển harness từ laptop sang một máy chủ thuê ngoài.

Nó vẫn tiếp tục chạy khi bạn đóng máy. Một tác vụ dài hạn sẽ không bị gián đoạn bởi việc bạn di chuyển hay hết pin. Hãy khởi chạy nó bên trong tmux và detach khỏi phiên làm việc:

tmux new -s agent
# start the harness, then press Ctrl-b and then d to detach
tmux attach -t agent

Đối với bất kỳ tiến trình nào cần tự khởi động lại sau khi reboot, một user service sẽ hiệu quả hơn phiên terminal thông thường:

loginctl enable-linger $USER
systemctl --user status my-agent.service

loginctl enable-linger là phần mà mọi người thường bỏ sót. Nếu không có nó, mặc định của systemd là dừng trình quản lý dịch vụ của người dùng 10 giây sau khi phiên làm việc cuối cùng của bạn đóng lại, vì vậy user service sẽ không duy trì agent sau khi bạn logout. Chạy dsh ở chế độ headless bằng systemd có chứa file unit mẫu. Khi đã có một phiên chạy trên máy chủ đó, bạn có thể khởi chạy phiên thứ hai, và hai phiên Claude Code trên cùng một máy có thể gửi tin nhắn cho nhau, nhờ đó phiên bạn khởi chạy vào buổi sáng có thể bàn giao công việc cho phiên kia mà không cần bạn phải chuyển tiếp thủ công.

Nó lưu trữ các key của bạn. Key của nhà cung cấp giờ đây nằm trong một file cấu hình trên máy chủ đó. Hãy kiểm tra quyền đọc file:

ls -l ~/.config

Bất kỳ tiến trình nào chạy dưới quyền người dùng của bạn đều có thể đọc file đó, bao gồm cả agent và bất cứ thứ gì mà agent chọn để thực thi.

Nó có thể truy cập các máy khác của bạn. Một VPS nằm cùng mạng nội bộ với các máy khác sẽ cung cấp cho agent một đường dẫn để kết nối tới chúng. Đó chính là mục đích sử dụng, nhưng cũng đồng thời là phạm vi ảnh hưởng nếu có sự cố.

Nó có thể truy cập được từ bất cứ đâu. Hầu hết các harness đều cung cấp giao diện web (web UI), và đa số đều bind nó vào loopback vì lý do bảo mật. Hãy kiểm tra cấu hình của bạn:

ss -tlnp | grep 3080

127.0.0.1:3080 nghĩa là chỉ máy chủ mới có thể kết nối. 0.0.0.0:3080 nghĩa là giao diện web lắng nghe trên mọi interface, vì vậy bất kỳ ai truy cập được địa chỉ public của máy chủ đều có thể kết nối trừ khi có firewall chặn cổng đó. Tính đến tháng 10 năm 2026, dsh từ chối địa chỉ wildcard như vậy khi khởi động, nhưng nhiều web UI khác vẫn chấp nhận nó. Hãy truy cập giao diện loopback thông qua SSH tunnel thay vì thay đổi địa chỉ bind:

ssh -N -L 3080:127.0.0.1:3080 you@your-server

Sau đó mở http://127.0.0.1:3080 trên trình duyệt tại laptop của bạn. Lưu lượng truy cập sẽ đi qua phiên SSH, vì vậy không có cổng mới nào bị lộ ra Internet.

Tất cả những điểm đó cũng chính là lý do bảo mật

Hãy đọc lại bốn đặc tính đó theo cách kẻ tấn công sẽ nhìn chúng.

Agent chạy không cần giám sát, nên không ai theo dõi lúc model đọc sai một đường dẫn. Agent giữ các key của bạn, nên chỉ cần một file cấu hình có thể đọc được là toàn bộ tài khoản provider của bạn bị lộ. Agent có thể truy cập các máy khác, nên prompt injection, tức là các chỉ dẫn ẩn trong một trang web hoặc file mà agent đọc, giờ đây có đường đến máy chủ database của bạn. Agent có thể truy cập từ bất kỳ đâu, nên một web UI lắng nghe trên địa chỉ public, không có firewall đứng trước và cũng không có authentication riêng, chính là một shell cho bất kỳ ai tìm thấy nó. dsh đặt process token vào URL in ra khi khởi động, giúp giảm rủi ro, nhưng URL đó giờ là một credential, vì vậy hãy chia sẻ nó cẩn thận như password.

Cách khắc phục trong từng trường hợp đều đơn giản và lần nào cũng giống nhau. Tạo một user account không có quyền đặc biệt riêng cho agent thay vì dùng tài khoản của bạn:

sudo adduser --disabled-password --gecos "" agent

Giữ web UI trên loopback và truy cập nó qua SSH. Cấp cho agent các credential có phạm vi hẹp nhất nhưng vẫn đủ để hoàn thành công việc; phần không đưa secret vào AI agent sẽ giải thích đúng cách. Với mọi thứ chạy khi bạn không theo dõi, một máy dùng tạm an toàn hơn một máy được cấu hình cẩn thận: chạy coding agent trong disposable VM và chạy Claude Code an toàn trên VPS đều áp dụng cách này.

Bạn có cần agent harness không?

Nếu công việc của bạn chỉ xử lý từng câu hỏi một, một cửa sổ chat là đủ. Harness chỉ thêm một vòng lặp mà bạn phải giám sát. Harness bắt đầu đáng dùng khi một tác vụ cần thực hiện nhiều bước trên các file thực tế, hoặc khi nó phải tiếp tục chạy trong lúc bạn đang ngủ.

Phần lớn danh mục này còn mới. dsh vẫn ghi là bản xem trước dành cho developer trong README của chính nó vào tháng 10 năm 2026. Các công cụ còn lại cũng thay đổi nhanh đến mức file cấu hình bạn viết hôm nay có thể cần chỉnh sửa vào tháng sau. Vì vậy, hãy giữ setup nhỏ và có thể tái tạo, đồng thời ghi lại những gì bạn đã thay đổi. Sự thận trọng tương tự cũng hữu ích bên trong vòng lặp. Một skill hướng agent đến thay đổi nhỏ nhất nhưng vẫn hoạt động giúp bạn có một diff thực sự có thể đọc được khi một lần chạy không cần giám sát kết thúc. Hãy bắt đầu với một harness trên một server, giao cho nó một công việc và một key có phạm vi hẹp. Chỉ mở rộng quyền truy cập sau khi công việc đầu tiên đã chạy ổn định và không có sự cố trong một tuần. Các agent self-host đáng chạy hiện nay là một điểm khởi đầu hợp lý để chọn công cụ đầu tiên.

FAQ

Agent harness là gì nếu giải thích đơn giản?

Đó là chương trình bao quanh model. Model tạo ra văn bản và các yêu cầu sử dụng công cụ. Harness chạy vòng lặp để liên tục đặt câu hỏi, thực thi các công cụ mà model yêu cầu, áp đặt quy tắc về việc công cụ nào được phép chạy mà không cần xin quyền, đồng thời duy trì trạng thái phiên làm việc và các file giữa các lượt. Bạn có thể thay thế model mà harness vẫn hoạt động; đây là dấu hiệu rõ ràng nhất cho thấy hai thành phần này tách biệt.

Claude Code là model hay là harness?

Claude Code là một harness. Nó là một chương trình terminal có vòng lặp, hệ thống cấp quyền và các công cụ file và shell tích hợp sẵn. Claude là dòng model mà nó gọi theo mặc định. Sự phân chia tương tự cũng áp dụng cho DeepSeek Harness (dsh), vốn là một chương trình Node bạn cài đặt, còn các model DeepSeek được phục vụ qua API. Bạn cài đặt harness trên máy tính. Bạn gọi model qua mạng.

Sự khác biệt giữa agent harness và agent framework là gì?

Framework là một thư viện bạn import và viết code dựa trên đó, sử dụng vòng lặp của nó hoặc tự viết vòng lặp riêng. Harness là một chương trình bạn chạy, vì vậy vòng lặp, cơ chế thử lại và xử lý ngữ cảnh đã được cung cấp sẵn với các thiết lập mặc định mà bạn chỉ cần cấu hình thay vì phải viết code. Trong thực tế, ranh giới này khá mờ nhạt: Deep Agents của LangChain là một SDK có thể import, nhưng chính repository của nó lại gọi đó là một agent harness "tất cả trong một" (batteries-included), tính đến tháng 10 năm 2026. Hãy tự hỏi liệu bạn có phải tự viết vòng lặp hay không. Câu trả lời đó sẽ quyết định thuật ngữ nào phù hợp với tình huống của bạn.

Tôi có cần VPS để chạy agent harness không?

Không. Mọi harness được nêu tên ở đây đều chạy được trên laptop. Một máy chủ sẽ thay đổi bốn yếu tố: agent vẫn tiếp tục chạy khi bạn gập máy, nó lưu giữ các key của bạn trên một máy luôn bật, nó có thể truy cập các máy chủ khác của bạn và bạn có thể quay lại cùng một phiên làm việc từ bất kỳ thiết bị nào. Mỗi yếu tố trên đều là một cân nhắc về bảo mật, vì vậy hãy cấp cho agent một tài khoản người dùng riêng và giữ mọi web UI bind vào 127.0.0.1.

Tôi có thể sử dụng model khác bên trong cùng một harness không?

Thường là có, và đó là đặc tính định nghĩa của một harness. Hầu hết các harness đều nhận tên model và base URL trong file cấu hình, vì vậy việc trỏ nó sang một nhà cung cấp khác chỉ là thao tác chỉnh sửa thay vì viết lại. Ở những nơi mà harness không hỗ trợ trực tiếp, một local router như Claude Code Router sẽ nằm giữa harness và nhà cung cấp để chuyển đổi các yêu cầu, mặc định bind vào 127.0.0.1:3456. Hãy cẩn thận với proxy đó, vì nó nhìn thấy mọi prompt và nắm giữ mọi key.

Bài viết này có hữu ích không?