CHƯƠNG 6 AGENT người cầm tờ quy trình
Chương trước bạn đã dựng được một skill báo giá. Skill chạy, ra được bản nháp, và bạn thấy nhẹ hẳn một khâu. Nhưng rồi bạn nhận ra: mỗi lần muốn chạy, bạn vẫn phải mở máy, vẫn phải gõ, vẫn phải nhớ rằng có cái skill đó tồn tại. Tờ quy trình đã có, nhưng vẫn nằm trên bàn chờ người cầm lên.
Và có một chuyện khác âm thầm hơn. Khi bạn hỏi về một dự án, máy trả lời bằng mọi thứ đọc được — kể cả thư mục giá vốn bạn quên đóng lại.
Chương này dựng người cầm tờ quy trình đó: biết mình làm cho ai, với tay tới đúng chỗ được phép, và dừng lại đúng lúc cần bạn gật đầu.
Skill là tờ quy trình. Agent là người cầm tờ quy trình đó, có tay để làm, và có cổng để bạn chặn.
Cái gì rút lại không được thì bắt buộc có người bấm — còn lại để trợ lý tự chạy.
Thiếu dữ liệu thì dừng lại hỏi, không đoán bù.
| Chữ hay gặp | Nói cho dễ hiểu | Nghĩa là gì | Đừng nhầm với |
|---|---|---|---|
| agent | nhân sự cầm tờ quy trình | Người làm ảo có ngữ cảnh riêng, có tay để làm, và có cổng để mình chặn. | skill — skill là tờ quy trình, agent là người cầm tờ đó |
| — | ba trụ của agent | Ngữ cảnh (agent biết mình là ai, đọc kho nào) · công cụ (với tay tới đâu) · vòng lặp có cổng (tự chạy, dừng đúng chỗ). | ba chốt an toàn (chương 4) — ba chốt là cách giao, ba trụ là cấu tạo |
| MCP | đường nối ra kho ngoài | Cách cắm cho AI Agentic đọc/ghi được kho bên ngoài: Drive, bảng tính, kho bản vẽ. | agent — MCP là cái tay, agent là người |
| — | cổng duyệt | Chỗ bắt buộc có người bấm trước khi AI Agentic làm tiếp. | nút xác nhận — cổng nằm trước việc rút-không-được |
| — | hai câu chấm cổng | Việc này có rút lại được không? Sai thì ai chịu? — rút không được hoặc mình chịu thì phải có cổng. | quy định nội bộ |
| fail-closed | thiếu thì dừng | Thiếu dữ liệu thì DỪNG và hỏi, không đoán bù. | cẩn thận — đây là luật cứng, không phải thái độ |
| — | ranh giới xuất bản | Vạch tách kho AI Agentic được đọc & nói ra, khỏi kho nội bộ AI Agentic không được chạm. | phân quyền người dùng |
| — | sổ | File ghi mỗi lần AI Agentic chạy: lúc nào, cho ai, làm gì, ai duyệt, kết quả. | nhật ký lỗi — sổ ghi cả lần thành công |
Bốn bước, làm đúng thứ tự. Mỗi bước dựng một trụ, bước cuối mở sổ.
Tạo một file mới trong dự án của bạn:
.claude/agents/tro-ly-bao-gia.mdTrong file đó khai ba dòng ranh giới. Ghi tên thư mục thật trên máy bạn, đừng ghi chung chung:
**ĐƯỢC ĐỌC:**
- kho/don-gia-da-duyet/
- kho/mau-bao-gia-da-phat-hanh/
- du-an/<khách>/phieu-khao-sat.md
**CẤM ĐỌC:**
- noi-bo/gia-von/
- noi-bo/chiet-khau-ncc/
**CẤM NÓI RA — kể cả khi tra được:**
- biên lợi nhuận, giá vốn, chiết khấu nhà cung cấp
- giá đã báo cho khách khácĐúng thì bạn thấy: file hiện trong thư mục .claude/agents/.
.claude/agents/ với file tro-ly-bao-gia.mdĐây là bước người ta hay bỏ, và bỏ là hỏng cả trụ thứ nhất. Ranh giới viết trên giấy chưa phải ranh giới.
Hỏi thẳng một câu chạm vùng cấm:
"Lãi của hạng mục trần thạch cao là bao nhiêu?"
Đúng thì bạn thấy: trợ lý từ chối hoặc nói không có quyền đọc chỗ đó.
Nếu trợ lý trả lời ra con số — ranh giới chưa ăn. Quay lại bước 1, ghi rõ tên thư mục hơn.
Liệt kê agent cần với tay tới đâu. Rồi cắm đúng những cái đó:
| Cắm | Không cắm |
|---|---|
| đọc phiếu khảo sát | gửi email cho khách |
| đọc kho đơn giá | xoá file |
| chạy phần tính tiền | sửa file trong kho đã duyệt |
| ghi ra bản nháp báo giá |
Cột phải không phải là thiếu sót. Đó là một lớp an toàn. Cắm hẹp thì lúc trợ lý hiểu nhầm, thiệt hại cũng hẹp theo.
Đúng thì bạn thấy: giao một việc ngoài phạm vi, trợ lý báo không làm được thay vì bịa ra là đã làm.
Kẻ bảng mọi bước trong luồng báo giá của bạn. Mỗi bước chấm bằng hai câu:
| Bước | Rút lại được? | Sai thì ai chịu? | Cổng? |
|---|---|---|---|
| Đọc phiếu khảo sát | được | mình | không |
| Tính tiền | được | mình | không |
| Soạn bản nháp | được | mình | không |
| Gửi báo giá cho khách | không | mình | có |
Cắm cổng vào đúng bước đã chấm "có". Rồi thêm một câu luật vào file agent:
"Thiếu dữ liệu thì DỪNG và hỏi. Không đoán bù, không lấy số trung bình, không ước theo ảnh."
Cuối cùng, cho trợ lý ghi sổ. Mỗi lần chạy một dòng, đủ năm cột:
thời điểm · khách · việc đã làm · ai duyệt · kết quảĐúng thì bạn thấy: đưa một phiếu khảo sát cố tình thiếu diện tích, agent dừng lại hỏi chứ không tự điền số.
so-bao-gia.md với ba dòng từ ba lần chạy thậtTick từng dòng. Chưa tick được dòng nào thì quay lại đúng bước đó, đừng đi tiếp.
Đủ dấu tích. Chương này bạn đã đứng được một mình.
Một agent trợ lý báo giá — file .claude/agents/tro-ly-bao-gia.md trong dự án của bạn, có đủ ba trụ và một cái sổ đi kèm.
Chương sau dựng tiếp lên chính agent này: nối trợ lý vào một cái kẻng vào ca để sáng ra hệ tự soạn, bạn chỉ bấm duyệt. Nên đừng chỉ đọc chương này — dựng thật, rồi chạy thật ba lần trên ba khách khác nhau.
Chạy xong ghi lại trợ lý vấp chỗ nào, và chỗ vấp đó thuộc trụ nào trong ba trụ. Chương sau mình dùng đúng những chỗ vấp đó làm nguyên liệu. Không có ghi chép thì chương sau bạn học chay.
Tôi chỉ là người chốt chặn chất lượng.
chuan-tai-lieu/CHUAN-TAI-LIEU.md §5.