Brief cho AI agent: mẫu giao việc dành cho Product Owner

Mẫu brief bảy dòng cho AI agent, PO điền trong vài phút: mục tiêu, phạm vi, cách kiểm tra, điểm dừng. Kèm ví dụ minh họa và bảng lỗi hay gặp.

Viết bởi Phan Lâm Duy Khôi

Brief cho AI agent là đoạn giao việc nói rõ mục tiêu, bối cảnh, thế nào là xong, phần không được đụng, cách kiểm tra, khi nào phải dừng lại hỏi và cần báo lại gì. Có đủ bảy phần này, agent ít phải đoán hơn và PO dễ kiểm tra kết quả hơn.

AI agent là gì, và vì sao nó cần brief?

AI agent là một hệ thống AI tự lên kế hoạch và tự dùng công cụ (đọc file, chạy lệnh, sửa code) để làm xong một việc qua nhiều bước. Khác với chatbot chỉ trả lời từng câu, agent hành động thay bạn, nên có thể sửa đúng chỗ, cũng có thể sửa nhầm chỗ.

Brief là đoạn giao việc bạn viết trước khi agent bắt đầu. Với PO, đây là kỹ năng quen thuộc. Nó giống viết một ticket tốt cho developer, chỉ khác là người nhận không ngồi cạnh để hỏi lại. Agent sẽ tự lấp chỗ trống bằng phỏng đoán. Brief càng rõ, agent càng ít phải đoán.

Anthropic (công ty làm ra Claude) mô tả agent là hệ thống mà mô hình AI tự quyết cách làm và tự chọn công cụ. Họ cũng khuyên nên đặt điểm dừng, để con người có lúc xem lại và góp ý. Mẫu brief bên dưới gói lời khuyên đó thành bảy dòng mà PO điền được trong vài phút.

Một brief cho AI agent cần có những phần nào?

Mình dùng bảy phần. Mỗi phần trả lời một câu mà agent sẽ phải tự đoán nếu bạn bỏ trống.

  • Mục tiêu: việc này để làm gì, cho ai. Agent cần biết lý do để chọn đúng khi gặp hai cách làm.
  • Bối cảnh: sản phẩm, trang, màn hình liên quan và tài liệu nên đọc. Agent không biết những gì chỉ nằm trong đầu bạn.
  • Xong nghĩa là: kết quả nhìn thấy được. Thiếu dòng này, agent sẽ tự quyết khi nào là xong.
  • Không được đụng: file, dữ liệu, môi trường phải giữ nguyên. Đây là dòng bảo vệ bạn khỏi những thay đổi ngoài ý muốn.
  • Kiểm tra bằng: lệnh test, các bước bấm thử, ảnh chụp màn hình. Agent làm tốt hơn khi có cách tự kiểm tra kết quả.
  • Dừng lại hỏi trước khi: những việc khó hoàn tác hoặc khách hàng sẽ thấy, như merge, release, xóa dữ liệu.
  • Báo lại: đã đổi gì, đã kiểm gì và chưa kiểm gì. Phần "chưa kiểm" là phần bạn cần đọc kỹ nhất.

Có mẫu brief nào để chép về dùng ngay không?

Thay phần trong [ngoặc vuông] bằng thông tin thật. Dòng nào không áp dụng thì ghi "không có", đừng xóa. Một dòng ghi "không có" vẫn cho agent biết bạn đã nghĩ tới chuyện đó.

Mẫu brief cho AI agent
Mục tiêu: [một câu: việc này để làm gì, cho ai]
Bối cảnh: [sản phẩm, trang hoặc màn hình liên quan; vì sao làm bây giờ; link tài liệu]
Xong nghĩa là: [kết quả mình nhìn thấy được, viết thành 2–4 gạch đầu dòng]
Không được đụng: [file, dữ liệu, cấu hình, môi trường không được sửa]
Kiểm tra bằng: [lệnh test, các bước bấm thử, ảnh chụp cần có]
Dừng lại hỏi mình trước khi: [merge, release, xóa dữ liệu, đổi thứ khách hàng nhìn thấy, hoặc khi gặp điều không có trong brief]
Báo lại: [đã đổi gì, ở đâu; đã kiểm gì; chưa kiểm gì; câu hỏi còn mở]

Nếu team đã có quy tắc chung cho agent (ví dụ file hướng dẫn trong repo), brief chỉ cần nói phần riêng của việc này. Đừng chép lại toàn bộ quy tắc chung vào mỗi brief.

Brief cho một việc nhỏ trên website trông thế nào?

Ví dụ minh họa dưới đây là một việc rất nhỏ: đổi chữ trên nút gửi form ở trang Liên hệ. Việc nhỏ vẫn cần brief, vì chữ trên nút thường được dùng chung ở nhiều nơi. Sửa một chỗ có thể đổi luôn chữ ở trang khác.

Ví dụ minh họa: đổi chữ nút ở trang Liên hệ
Mục tiêu: Nút gửi form trên trang Liên hệ nói rõ người dùng sẽ nhận được gì, để khách biết bấm vào là đặt lịch tư vấn.
Bối cảnh: Website marketing của công ty. Trang /contact. Nút hiện ghi "Gửi". Team muốn đổi thành "Đặt lịch tư vấn". Trang có hai ngôn ngữ, tiếng Việt và tiếng Anh.
Xong nghĩa là:
- Nút trên /contact ghi "Đặt lịch tư vấn" ở bản tiếng Việt và "Book a consultation" ở bản tiếng Anh.
- Chữ không xuống dòng trên màn hình rộng 375px.
- Nhãn đọc cho trình đọc màn hình (aria-label, nếu có) khớp với chữ mới.
Không được đụng: logic gửi form, địa chỉ email nhận form, các trang khác, file cấu hình deploy.
Kiểm tra bằng: chạy site ở máy local, mở /contact ở cả hai ngôn ngữ, chụp màn hình ở 375px và 1280px, chạy bộ test hiện có.
Dừng lại hỏi mình trước khi: merge, deploy, sửa thêm chữ nào ngoài nút này, hoặc nếu chữ "Gửi" được dùng chung ở nơi khác.
Báo lại: file đã sửa, ảnh chụp hai kích thước màn hình, kết quả test, và những gì chưa kiểm.

Để ý dòng "Dừng lại hỏi mình trước khi". Mình chưa biết chữ "Gửi" có được dùng chung hay không. Thay vì đoán, mình dặn agent dừng lại hỏi khi gặp trường hợp đó. Phạm vi cũng chỉ có một nút. Agent có thể thấy chữ khác "nên sửa luôn", nhưng sửa hay không là quyết định của PO, không phải của agent.

Viết brief hay mắc lỗi gì, và sửa thế nào?

Lỗi thường gặp trong brief cho AI agent
LỗiChuyện gì xảy raCách sửa
Chỉ ghi việc, không ghi mục tiêuAgent làm đúng chữ nhưng sai ýThêm một câu: việc này để làm gì, cho ai
"Xong" mơ hồ, ví dụ "làm cho đẹp hơn"Agent tự quyết khi nào là xongViết 2–4 kết quả nhìn thấy được, có kích thước màn hình hoặc chữ cụ thể
Không ghi phần không được đụngAgent sửa thêm file hoặc cấu hình bạn không ngờ tớiLiệt kê file, dữ liệu, môi trường phải giữ nguyên
Không có cách kiểm traAgent báo xong nhưng không có gì để đối chiếuGhi lệnh test, các bước bấm thử và ảnh chụp cần có
Không có điểm dừngAgent tự merge, deploy hoặc xóa dữ liệuGhi rõ các việc phải hỏi trước, nhất là việc khó hoàn tác
Gộp nhiều việc vào một briefKết quả lẫn lộn, khó kiểm và khó hoàn tácMỗi brief một kết quả. Việc lớn thì chia thành nhiều brief
Không đọc báo cáo của agentLỗi lọt ra tới người dùngĐọc phần "chưa kiểm" trước, rồi tự dùng thử

Phần lớn các lỗi trên đến từ cùng một chỗ: người viết brief biết quá rõ việc mình muốn, nên quên rằng agent không biết. Cách thử nhanh: đưa brief cho một đồng nghiệp chưa biết gì về việc này. Nếu họ phải hỏi lại, agent cũng sẽ phải đoán.

Khi nào không nên giao việc cho AI agent?

Không phải việc nào cũng nên giao. Anthropic cũng khuyên bắt đầu bằng cách đơn giản nhất và chỉ dùng agent khi thật cần. Mình tự giữ lại các việc sau:

  • Việc cần ra quyết định về sản phẩm: chọn ưu tiên, cắt phạm vi, nói không với một yêu cầu. Agent soạn được các phương án, còn quyết định là của PO.
  • Việc mà bạn chưa mô tả được thế nào là "xong". Nếu chưa viết được dòng "Xong nghĩa là", hãy làm rõ yêu cầu trước khi giao.
  • Việc chạm vào dữ liệu thật của khách hàng, tiền, quyền truy cập hoặc hệ thống production (hệ thống khách đang dùng), khi chưa có môi trường thử và chưa có người duyệt.
  • Việc nhỏ đến mức tự làm nhanh hơn viết brief. Sửa một lỗi chính tả thì không cần bảy dòng.
  • Việc không có cách kiểm tra. Nếu không ai kiểm được kết quả, đừng để agent làm rồi mặc định là đúng.

Quy tắc mình dùng: AI làm, PO kiểm, PO quyết. Brief tốt giúp phần "AI làm" nhanh hơn. Hai phần còn lại vẫn là việc của bạn.

Câu hỏi thường gặp

Brief cho AI agent khác prompt thường ở chỗ nào?

Prompt thường chỉ xin một câu trả lời. Brief giao một việc mà agent tự làm qua nhiều bước, nên cần nói thêm ranh giới: không được đụng vào đâu, kiểm tra thế nào, khi nào phải dừng lại hỏi.

Brief nên dài bao nhiêu?

Đủ để một người mới vào team làm được việc đó mà không cần hỏi lại. Với một việc nhỏ, bảy dòng trong mẫu thường là đủ. Nếu brief dài quá một trang, có lẽ nên chia nhỏ việc đó.

Mẫu này dùng được với Claude Code, Codex hay Cursor không?

Được. Mẫu không phụ thuộc công cụ. Mỗi công cụ có cách riêng để lưu quy tắc dùng lâu dài. Còn mục tiêu, phạm vi và cách kiểm tra cho từng việc thì bạn vẫn phải tự viết.

Agent báo xong rồi, mình có cần kiểm lại không?

Có. Trước tiên, đọc phần agent ghi là chưa kiểm. Sau đó tự mở kết quả trên môi trường thật. Test đã qua chưa có nghĩa là người dùng thấy đúng.

Nguồn kiểm tra

Bài liên quan