Tổng Hợp: Soạn Thảo Agentic Workflow Brief Hoàn Chỉnh
Đóng gói toàn bộ 9 quyết định sản phẩm thành một bản Agentic Workflow Brief chuẩn mực, sẵn sàng bàn giao cho đội ngũ kỹ sư triển khai.
Tổng Hợp: Soạn Thảo Agentic Workflow Brief Hoàn Chỉnh
Ở Lesson 26, bạn đã hoàn thành bản Technical Requirement Brief 6 mục cho một tính năng RAG. Khi chuyển sang xây dựng sản phẩm AI Agentic, bản đặc tả yêu cầu không còn dừng lại ở mức "truy xuất và trả lời". Agentic Workflow Brief là văn kiện kỹ thuật gồm 9 mục then chốt, tích hợp toàn bộ các quyết định sản phẩm bạn đã học từ Lesson 38 đến Lesson 46, tạo thành bản hướng dẫn thi công rõ ràng cho đội ngũ kỹ sư hoặc coding agent.
Ví dụ xuyên suốt bài: Bản đặc tả hoàn chỉnh cho RefundBot — agent xử lý yêu cầu hoàn tiền tự động trên sàn thương mại điện tử.
1. Cấu trúc 9 mục của một Agentic Workflow Brief chuẩn mực
Mỗi mục trong tài liệu phản ánh một quyết định sản phẩm cụ thể, loại bỏ hoàn toàn các giả định ngầm:
- Task Decomposition, Step DoD & Overall Completion Criteria (Lesson 38): Phân rã luồng công việc thành các bước tuần tự, tiêu chí nghiệm thu từng bước và điều kiện hoàn thành tổng thể.
- Trigger Type & Idempotency Key (Lesson 41): Xác định cơ chế kích hoạt (User / Event / Scheduled) và khóa chống trùng lặp dữ liệu.
- Reasoning Disclosure Level (Lesson 39): Mức độ hiển thị suy luận trên giao diện theo từng giai đoạn (Mức 1 đến Mức 4).
- Tool Surface & Permission Scopes (Lesson 40): Danh mục công cụ được cấp quyền gọi, và tuyên bố tường minh những tool bị cấm.
- Autonomy Level & Dynamic Thresholding (Lesson 42): Phân tầng cấp độ tự chủ theo ngưỡng giá trị rủi ro.
- Failure Recovery Strategy (Lesson 43): Quy tắc xử lý khi gặp sự cố (Idempotent Retry, Rollback bù trừ, Max Iteration Budget).
- Pause / Resume / Staleness Check & Handoff (Lesson 44): Điểm dừng chờ duyệt, quy tắc kiểm tra dữ liệu lỗi thời khi tiếp tục, và cấu trúc gói bàn giao cho người.
- Step Budget & Cost Governance (Lesson 45): Trần chi phí và số bước tối đa cho một lượt chạy.
- Operational Success Metrics (Lesson 46): Mục tiêu bộ ba chỉ số (Task Completion Rate, Average Steps, Intervention Rate).
Cấu Trúc 9 Mục Của Agentic Workflow Brief
Khám phá 9 quyết định sản phẩm liên kết chặt chẽ trong bản đặc tả hoàn chỉnh cho RefundBot.
1. Task & Completion Criteria
Lesson 38Cả 9 mục ràng buộc chặt chẽ với nhau: Trigger là Event-driven thì Mục 2 buộc phải có Idempotency Key; Autonomy có Human Approval thì Mục 7 bắt buộc phải có Staleness Check khi Resume. Tách rời bất kỳ mục nào sẽ tạo ra lỗ hổng bảo mật hoặc lãng phí chi phí.
Bản Brief 9 mục là tài liệu nghiệm thu kỹ thuật chuẩn mực để chuyển giao cho kỹ sư hoặc coding agent.
2. Demo thực chiến: Agentic Workflow Brief hoàn chỉnh cho RefundBot
Dưới đây là bản Brief mẫu sẵn sàng chuyển giao cho đội ngũ phát triển:
| Mục trong Brief | Nội dung đặc tả chi tiết cho RefundBot |
|---|---|
| 1. Task & Criteria | 5 bước: Xác minh đơn (DoD: Đơn hợp lệ) → Kiểm tra điều kiện chính sách (DoD: Pass điều kiện) → Tính số tiền hoàn (DoD: Đúng công thức chiết khấu) → Gọi cổng thanh toán (DoD: API trả về HTTP 200) → Gửi email biên nhận (DoD: Delivery status = sent). Overall Completion: Khách nhận đúng số tiền vào tài khoản ngân hàng, có mã giao dịch cổng thanh toán và email biên nhận khớp chính xác. |
| 2. Trigger & Idempotency | Event-driven: Webhook kích hoạt khi khách submit form đổi trả trên website. Idempotency Key: refund_request_id + order_id. Khóa cứng bước gọi API hoàn tiền để chống trừ tiền 2 lần. |
| 3. Disclosure Level | Tác vụ có độ trễ trung bình (~5s), rủi ro tài chính cao → Áp dụng Mức 4 (Full Expandable Trace) cho đội ngũ CSKH/Vận hành tra cứu đối soát. |
| 4. Tool Surface | Cấp quyền: get_order_details (Read), validate_policy (Read), calculate_refund_amount (Read/Compute), execute_gateway_refund (Write), send_customer_email (Write).Tuyệt đối KHÔNG cấp: modify_customer_profile, delete_order, change_bank_account. |
| 5. Autonomy Level | Khoản tiền ≤ 500.000đ: Notify After (Tự động chuyển tiền, gửi email báo cáo cho quản trị viên sau). Khoản tiền > 500.000đ: Human Approval (Tạm dừng, yêu cầu Trưởng nhóm CSKH bấm duyệt trên dashboard). |
| 6. Failure Recovery | Bước 4 (Cổng thanh toán) lỗi timeout: Cho phép Retry tối đa 3 lần (với Idempotency Key). Nếu sau 3 lần vẫn lỗi: Dừng luồng, kích hoạt Rollback trạng thái đơn hàng và gửi cảnh báo Escalate. |
| 7. Pause & Staleness | Với khoản tiền > 500.000đ: Agent vào Pause State. Khi quản lý duyệt (Resume): Bắt buộc chạy Staleness Check để xác minh đơn hàng chưa bị khách hủy thủ công trong thời gian chờ duyệt. |
| 8. Step Budget | Trần ngân sách: Tối đa 8 bước và chi phí compute không vượt quá 0.10 USD/lượt chạy. Nếu vượt trần, lập tức dừng và bàn giao cho người. |
| 9. Success Metrics | Task Completion Rate ≥ 90%, Average Steps ≤ 5.5 bước, Intervention Rate < 5% đối với nhóm đơn hàng tự động. |
3. Các quyết định ràng buộc lẫn nhau trong một Brief
Nhìn vào bản Brief trên, bạn sẽ thấy tính nhất quán logic xuyên suốt:
- Vì Trigger là Event-driven (Mục 2), hệ thống bắt buộc phải trang bị Idempotency Key và Full Trace Log (Mục 3).
- Vì Autonomy có điểm dừng Human Approval (Mục 5), hệ thống bắt buộc phải thiết kế Staleness Check khi Resume (Mục 7).
- Vì có rủi ro Retry dồn tích (Mục 6), ta phải khóa chặt bằng Step Budget (Mục 8).
Tách rời từng quyết định sẽ tạo ra lỗ hổng bảo mật hoặc lãng phí chi phí. Việc kết hợp trọn vẹn 9 mục tạo ra một hợp đồng phát triển vững chắc giữa PM và Kỹ sư.
4. Ẩn dụ: Bản vẽ thiết kế kỹ thuật của kiến trúc sư
Một Agentic Workflow Brief giống như bản vẽ thiết kế thi công của một kiến trúc sư gửi cho nhà thầu xây dựng:
- Bản vẽ không chỉ vẽ hình dáng ngôi nhà (Happy Path).
- Nó chỉ rõ sơ đồ đường điện, van khóa nước khẩn cấp (Tool Surface & Guardrails), cầu dao tự ngắt khi chập điện (Max Iterations & Circuit Breaker), lối thoát hiểm khi có sự cố (Rollback & Human Handoff), và dự toán khối lượng vật tư (Step Budget). Thiếu bất kỳ sơ đồ nào, công trình xây lên đều có nguy cơ sụp đổ khi gặp tải thực tế.
Bài tập cuối module (Capstone Assignment 47.1): Chọn 1 trong các bài toán agentic dưới đây (hoặc một bài toán thực tế tại doanh nghiệp của bạn):
- LeaveRequestBot: Agent tiếp nhận và phê duyệt nghỉ phép nội bộ trên Slack/Teams.
- IT-IncidentBot: Agent tiếp nhận báo lỗi phần mềm từ khách hàng, phân loại mức độ nghiêm trọng và tạo ticket Jira cho đội Dev.
- TravelDeskBot: Agent tìm kiếm chuyến bay, đối chiếu chính sách công tác và đặt phòng khách sạn cho nhân viên.
Hãy lập một Agentic Workflow Brief hoàn chỉnh gồm đầy đủ 9 mục theo đúng cấu trúc chuẩn đã học.