← Danh mục tài liệu · raw markdown

QUY ƯỚC TRAO ĐỔI — Ban điều hành ⇄ Trợ lý (Claude)

Mục đích: hai bên nói chuyện được với nhau mà không lẫn kênh, không thất lạc, và mọi trao đổi đều

truy vết được. Áp dụng cho mọi agent làm việc qua API/MCP.

---

1. Kênh nào dùng cho việc gì

Việc cần làmDùng kênhAi tạoCông cụ
Giao việc / hỏi / xin duyệtYêu cầu (/requests)cả haivietal_ask, vietal_answer_request
Trả lời, xin thêm thông tin, báo vướngYêu cầu (trả lời trong cùng id)cả haivietal_answer_request
Ghi cuộc họp, tập huấn, báo cáo đã/ sẽ diễn raSự kiện (Lịch)cả haivietal_add_event
Trao đổi ngắn, hỏi nhanh trong ngàyTrao đổi (/chat)người—
Dán biên bản, email, báo cáo thô để bóc thành cập nhậtTiếp nhận (/intake)cả haivietal_intake
Dấu vết kỹ thuật (đã gọi gì, mất bao lâu)Nhật ký (tự động)hệ thốngvietal_log

Quy tắc một dòng: cần người trả lời thì dùng Yêu cầu; chỉ cần ghi vào lịch thì dùng Sự kiện.

Dùng sự kiện để trả lời câu hỏi là sai kênh — người sẽ không thấy và không ai trả lời.

---

2. Quy ước đặt tiêu đề

Tiền tốNghĩaAi dùng
[Hỏi]cần thông tin để làm tiếpagent, người
[Chặn]đang bị chặn, cần quyết ngayagent
[Duyệt]xin duyệt kết quả / đề xuấtagent
[Báo cáo]báo cáo định kỳ, không cần trả lời gấpagent
[Bắt tay]kiểm tra kênh, xác nhận đã nhậncả hai

Ví dụ tốt: [Hỏi] A1.3 — 20 ca bệnh đầu tiên lấy từ khoa nào?

Ví dụ xấu: Hỏi chút (không biết việc nào, không biết mức khẩn).

---

3. Nhịp trao đổi

1. Mỗi yêu cầu một chủ đề. Không gộp ba câu hỏi khác nhau vào một yêu cầu.

2. Trả lời trong đúng yêu cầu đó, không mở yêu cầu mới để trả lời (mất mạch, mất liên kết).

3. Gắn mã việc (task_id) khi câu hỏi liên quan tới một việc cụ thể.

4. Một lượt = một lần trả lời. Cần hỏi tiếp thì trả lời tiếp trong cùng yêu cầu.

5. Đóng khi xong: người tạo yêu cầu đóng (status = closed); agent không tự đóng yêu cầu của mình.

6. Không xoá yêu cầu đã có trả lời — đó là bản ghi kiểm toán.

---

4. Câu trả lời phải đủ 4 phần

Mọi câu trả lời của agent (và nên áp dụng cả phía người):

1. Kết luận ngắn (1–2 câu).

2. Căn cứ: mã việc, số liệu, document_id hoặc bản ghi nguồn. Không có căn cứ thì nói rõ "chưa có dữ liệu".

3. Đề xuất bước tiếp theo (nếu có).

4. Câu hỏi ngược (nếu cần) — đặt đúng chỗ, không đoán.

---

5. Mẫu câu cho Ban điều hành

6. Mẫu câu cho agent (Claude)

---

7. Thời hạn phản hồi (thoả thuận nội bộ)

Tình huốngPhía ngườiPhía agent
Câu hỏi thườngtrong 1 ngày làm việcngay trong lượt chạy kế tiếp
[Chặn]trong 4 giờ làm việcbáo lại và chờ, không tự quyết
[Duyệt]trong 2 ngày làm việckhông tự duyệt kết quả của mình
Báo cáo định kỳtheo lịch COPILtrước hạn 3 ngày

Agent không chạy nền: yêu cầu nằm chờ cho tới lượt làm việc kế tiếp. Muốn thúc, người mở Claude và

yêu cầu đọc hộp thư yêu cầu.

---

8. Điều cấm

---

9. Kiểm chứng một cuộc trao đổi

1. /requests — thấy yêu cầu, trạng thái, người trả lời.

2. Nhật ký — thấy agent.request, request.answer kèm tên agent.

3. Sự kiện loại audit — giữ nguyên văn nội dung hai bên đã gửi (không dịch, không tóm tắt).

4. vietal_list_requests {status: "open", direction: "to_agent"} — kiểm tra từ phía agent.

---

*Tài liệu này đọc được từ ngoài: https://dv.badt.vn/project/docs/trao-doi (bản thô: .md).

Agent đọc bằng vietal_read_tech_doc {slug: "trao-doi"}.*