Viết máy trạng thái của agent trước khi viết prompt
Mô hình hóa điều tra bằng trạng thái có điều kiện chuyển, giữ đúng mã tiến trình và phân biệt kết quả cuối với một lần quan sát chưa xong.

Với kỹ sư triển khai agent, máy trạng thái làm rõ hợp đồng thực thi trước khi cách viết prompt che khuất nó. Máy trạng thái ghi hệ thống đang làm gì, quan sát nào cho phép bước tiếp và điều kiện nào kết thúc công việc. Mô hình đề xuất hành động trong phạm vi cho phép; ứng dụng kiểm tra các quy tắc chuyển trạng thái.
Xét một cuộc điều tra giả định chỉ được đọc repository có kiểm thử thất bại. Agent được đọc tệp và chạy lệnh kiểm thử có giới hạn. Nó không được sửa mã, cài gói hay phát hành. Đầu ra là chẩn đoán có tham chiếu mã và kết quả lệnh thực sự quan sát được. Người đọc chỉ cần hiểu hàm Python, tiến trình và sự khác nhau giữa đề xuất với thực thi.
Chọn trạng thái có ý nghĩa quan sát được
Mô hình ban đầu có thể gồm inspect, test, assess và các trạng thái cuối diagnosed, needs_input, budget_exhausted. Mỗi trạng thái nên được nhận biết từ dữ liệu lưu lại. “Đang suy nghĩ sâu” không mô tả một điều kiện bên ngoài hay một hành động mà bộ thực thi có thể kiểm tra.
Trong inspect, agent chọn tệp hoặc truy vấn tìm kiếm được phép. Kết quả đọc thành công bổ sung bằng chứng rồi chuyển sang assess. Trong test, ứng dụng khởi chạy lệnh được phép và lưu mã tiến trình. Việc đánh giá phải chờ kết quả cuối thực sự; hết thời gian chờ quan sát khi tiến trình vẫn chạy không chứng minh kiểm thử đã thất bại.
inspect -> assess -> inspect
-> test -> assess
-> diagnosed
-> needs_input
-> budget_exhausted
Sơ đồ thể hiện những đường có thể đi, không bắt buộc chạy mọi bước. Thiếu đường dẫn repository có thể dẫn thẳng tới needs_input. Một lỗi đã tái hiện cùng điều kiện mã tương ứng có thể đủ để đưa ra chẩn đoán mà không chạy lại mãi cùng một lệnh.
Ứng dụng nên lưu quan sát trước khi chấp nhận chuyển trạng thái dựa trên nó. Nếu không, lần khởi động lại có thể thấy trạng thái khẳng định đã biết kết quả mà không tìm được bản ghi kết quả ấy.
Đặt điều kiện cho từng lần chuyển
Điều kiện chuyển là quy tắc do ứng dụng kiểm tra. Trước khi vào test, xác nhận lệnh nằm trong quyền được cấp, thư mục chạy đúng và còn đủ thời gian để quan sát hoặc xử lý tiến trình có trách nhiệm. Trước diagnosed, yêu cầu các trường bằng chứng mà hợp đồng nhiệm vụ quy định.
Ví dụ chẩn đoán cần mã tái hiện, vị trí nguồn, giải thích nguyên nhân và phần chưa chắc chắn. Sự có mặt của các trường không làm giải thích tự động đúng. Nó giúp phát hiện bằng chứng thiếu và tạo một artifact có thể duyệt về nội dung kỹ thuật.
Bài báo ReAct nghiên cứu việc xen kẽ suy luận và hành động. Máy trạng thái cho sản phẩm có thể dùng vòng lặp phụ thuộc quan sát, đồng thời ghi rõ quyền và điều kiện dừng. Benchmark của bài báo không xác nhận người điều tra repository cụ thể này sẽ thành công; nó vẫn cần đánh giá theo tác vụ riêng.
Tách trạng thái thực thi khỏi hội thoại
Hội thoại hữu ích làm ngữ cảnh nhưng không nên là bản ghi duy nhất của lệnh đang chạy. Lưu mã nhiệm vụ ổn định, trạng thái hiện tại, lần thử, mã tiến trình hoặc job và tham chiếu kết quả đã hoàn tất. Khi tiếp tục, agent có thể quan sát thao tác cũ thay vì khởi động thêm một thao tác chỉ vì đoạn hội thoại trước bị rút gọn.
Hướng dẫn function calling, được đọc ngày 20 tháng 9 năm 2026, tách yêu cầu gọi của mô hình khỏi việc ứng dụng thực thi. Giữ ranh giới đó trong máy trạng thái. Đề xuất chạy kiểm thử chỉ trở thành thao tác thật sau khi ứng dụng kiểm tra và khởi chạy nó.
Với công việc chỉ đọc, chạy lặp chủ yếu lãng phí tài nguyên. Khi mở rộng sang tạo ticket hay sửa tệp, yêu cầu khôi phục chặt chẽ hơn. Lưu ý định và mã thao tác ổn định trước khi gửi, rồi ghi kết quả thực. Luồng phục hồi phải tra bản ghi này trước khi quyết định có được lặp tác động hay không.
Phát lại trace của tiến trình chưa kết thúc
Một hàm chuyển trạng thái nhỏ giúp kiểm tra riêng lúc chuẩn bị khởi chạy, đang chờ và đã nhận kết quả cuối. Ví dụ Python sau xử lý sự kiện đáng tin từ ứng dụng; nó không chạy mô hình hay shell. Bộ thực thi bên ngoài kiểm tra mã artifact và thao tác là chuỗi không rỗng, xác minh nguồn sự kiện và lưu đầu ra lệnh thực. test_done nghĩa là đã lưu kết quả kết thúc cùng mã thoát, không có nghĩa kiểm thử đã qua.
from dataclasses import dataclass, replace
@dataclass(frozen=True)
class State:
phase: str = "inspect"
job: str | None = None
result: str | None = None
sources: tuple = ()
def advance(s, kind, *, ref=None, job=None):
if s.phase in {"diagnosed", "needs_input", "budget_exhausted"}:
raise ValueError("terminal state")
if kind == "read_done" and s.phase in {"inspect", "assess"} and ref:
return replace(s, phase="assess", sources=s.sources + (ref,))
if kind == "request_test" and s.phase == "assess":
return replace(s, phase="launching", result=None)
if kind == "test_started" and s.phase == "launching" and job:
return replace(s, phase="waiting", job=job)
if s.phase == "waiting" and job == s.job:
if kind == "still_running":
return s
if kind == "test_done" and ref:
return replace(s, phase="assess", job=None, result=ref)
if kind == "diagnose" and s.phase == "assess" and s.sources and s.result:
return replace(s, phase="diagnosed")
if kind in {"needs_input", "budget_exhausted"}:
return replace(s, phase=kind)
raise ValueError("invalid transition or missing evidence")
s = advance(State(), "read_done", ref="src/date.ts@rev7:18")
s = advance(s, "request_test")
s = advance(s, "test_started", job="test-17")
s = advance(s, "still_running", job="test-17")
print(s.phase, s.job, s.result)
s = advance(s, "test_done", job="test-17", ref="results/test-17.json")
s = advance(s, "diagnose")
print(s.phase, s.job, s.result)
Dòng đầu là waiting test-17 None; dòng sau là diagnosed None results/test-17.json. Lượt quan sát tiến trình còn chạy không tạo kết quả cuối và không khởi động kiểm thử thứ hai. Phản hồi cho test-18 bị từ chối. request_test trong lúc đang chờ cũng bị từ chối; trạng thái bất biến trước đó vẫn được giữ nếu có lỗi. Sau diagnosed, sự kiện mới báo lỗi thay vì âm thầm mở lại công việc.
Điều kiện của diagnosed chỉ xác nhận có tham chiếu nguồn và kết quả. Nó chưa chứng minh quan hệ nhân quả, thậm chí chưa kiểm tra kết quả có liên quan hay không. Bước đánh giá riêng phải đọc artifact rồi đưa ra giải thích và mức chưa chắc chắn được yêu cầu. Giới hạn này có chủ ý: tham chiếu kết quả cũ hoặc không liên quan có thể qua kiểm tra hình dạng nhưng phải bị loại khi duyệt nội dung.
Lưu chuyển trạng thái request_test được chấp nhận trước khi gửi lệnh, rồi ghi mã trả về trong test_started. Nếu chương trình dừng giữa hai sự kiện, trạng thái là launching; hàm nhỏ này không tự đối soát được. Bộ thực thi thật cần mã thao tác bền vững và cách tra xem lệnh đã được khởi chạy chưa. Khởi động lại một cách mù quáng có thể tạo tiến trình trùng.
Tương tự, sự kiện hết ngân sách khi job còn chạy giữ lại mã job nhưng không hủy tiến trình. Xử lý dọn dẹp hoặc bàn giao cho lần quan sát tiếp vẫn là trách nhiệm của bộ thực thi. Việc đổi nhãn trạng thái cuối không làm tác vụ hệ điều hành biến mất.
Thinking in LangGraph, được đọc ngày 21 tháng 9 năm 2026, khuyến nghị giữ dữ liệu trạng thái ở dạng thô và chỉ định dạng prompt khi cần. Điều đó giúp giải thích vì sao nên tách mã thao tác và tham chiếu artifact khỏi câu văn trong hội thoại. Ví dụ không cần API LangGraph và không triển khai lại checkpoint hay cơ chế ngắt của framework. Nếu dùng các chức năng ấy, cần kiểm thử phục hồi theo phiên bản cụ thể.
Đưa ngân sách vào trạng thái thực thi
Theo dõi số lời gọi công cụ còn lại, thời gian đã dùng và giới hạn chi phí mà ứng dụng thực sự kiểm soát. Trừ tài nguyên từ bản ghi thực thi thay vì nghe mô hình ước lượng nó đã làm bao nhiêu. Giữ đủ phần dự phòng để giải thích kết quả cuối có ích.
Chính sách minh họa có thể cho tối đa tám lượt đọc tệp và hai lần chạy kiểm thử. Đây không phải mức tối ưu cho mọi bài toán. Nếu kiểm thử thứ hai còn chạy khi gần hết thời gian, cần quy tắc rõ: tiếp tục quan sát trong một khoảng gia hạn giới hạn, hủy nếu được hỗ trợ hoặc trả mã thao tác bền vững cho lần quan sát sau.
Không trình bày budget_exhausted như chẩn đoán. Bàn giao nên chỉ ra phát hiện đã kiểm chứng và bước tiếp còn thiếu. Người dùng khi đó có thể quyết định cấp thêm tài nguyên. Trạng thái phải phản ánh điều đã xảy ra dù mô hình có xu hướng viết một kết luận tròn trịa.
Kiểm tra những lần chuyển khó
Thử tệp biến mất giữa chọn và đọc, lệnh kết thúc với mã khác không, lượt quan sát hết thời gian khi lệnh còn sống và yêu cầu công cụ sai cấu trúc. Mỗi trường hợp cần đường chuyển xác định và giữ bằng chứng đủ để giải thích nó.
Thêm trường hợp agent lặp lại cùng một lượt đọc không có ích. Ứng dụng có thể nhận diện chữ ký hành động lặp và yêu cầu giả thuyết khác hoặc dừng sau giới hạn đã định. Biện pháp này bảo vệ ngân sách, không chứng minh nhiệm vụ bất khả thi chỉ từ việc có lặp.
Cuối cùng, đọc một trace từ đầu đến cuối. Mỗi lần chuyển phải chỉ tới quan sát hoặc chính sách cho phép nó xảy ra. Nếu không giải thích được vì sao hệ thống từ kiểm thử chuyển sang chẩn đoán, hãy bổ sung thông tin vào bản ghi thực thi. Máy trạng thái có ích khi phơi bày lỗ hổng ấy trước khi câu trả lời cuối che nó đi.