Bài 5 — Dựng agent tự động hóa: từ prompt thủ công đến quy trình chạy một lệnh

Từ "copy-paste prompt" lên "agent"

Đến đây bạn đã có prompt tốt, nhưng vẫn phải tự export CSV, dán vào chat, copy kết quả ra. Agent là khi các bước đó được nối lại: agent tự lấy ticket → lọc → sinh 4 bản → đặt vào bản nháp chờ bạn duyệt. Bạn chuyển từ thao tác thủ công sang duyệt và bấm gửi.

Bạn không cần biết lập trình. Có ba mức độ, chọn theo công cụ team đang có.

Ba mức tự động hóa

• Mức 0 — Prompt-in-a-doc: lưu prompt hoàn chỉnh, mỗi sprint bạn chỉ dán JSON mới vào. Nhanh nhất để bắt đầu.
• Mức 1 — No-code workflow: dùng Zapier / Make / n8n nối Jira → OpenAI/Claude → Google Doc/Slack. Kéo-thả, không code.
• Mức 2 — Custom GPT / Assistant: tạo một "GPT" hoặc "Project" đã nạp sẵn style card + prompt; bạn chỉ cần upload CSV là ra 4 bản.

Ví dụ cụ thể: một workflow no-code (Mức 1)

Luồng trong Make/n8n:

• Trigger: khi sprint đóng (hoặc thủ công bấm nút).
• Bước 1: gọi Jira API lấy ticket status=Done, sprint=current.
• Bước 2: gọi AI với prompt lọc (Bài 2) → JSON sạch.
• Bước 3: gọi AI với prompt đa đối tượng + style card (Bài 3–4) → 4 bản.
• Bước 4: tạo bản nháp trong Google Doc + đăng vào kênh Slack #release-review (chưa gửi khách).
• Bước 5: gắn nút "Đã duyệt" để bạn xác nhận trước khi phân phối.

Điểm mấu chốt: agent dừng ở bản nháp chờ người duyệt, không tự gửi ra ngoài.

Prompt hệ thống cho agent (dán vào cấu hình)

Bạn là Agent Release Notes của công ty. Quy trình mỗi lần chạy:
1. Nhận danh sách ticket đã Done (JSON hoặc CSV).
2. Lọc bỏ mục nội bộ (refactor, CI, test) — liệt kê mục đã loại.
3. Sinh 4 bản theo đối tượng: khách hàng, sales/CS, lãnh đạo, nội bộ.
4. Tuân thủ STYLE CARD kèm dưới đây.
5. KHÔNG thêm số liệu/tính năng ngoài đầu vào. Chỗ thiếu ghi "[cần xác nhận]".
6. Cuối cùng, in "CHECKLIST DUYỆT" liệt kê các câu cần người kiểm (số liệu,
   cam kết, breaking change).
[STYLE CARD]
<dán style card>
Bạn CHỈ tạo bản nháp. Bạn KHÔNG bao giờ tự gửi cho khách hàng.

Câu cuối là rào an toàn — biến agent thành trợ lý, không phải người phát hành.

Các bước làm (numbered)

• Chọn mức phù hợp công cụ team (bắt đầu Mức 0 hoặc Mức 1).
• Kết nối nguồn: cấp quyền đọc Jira/GitHub (chỉ đọc, phạm vi tối thiểu).
• Nạp prompt hệ thống + style card vào agent.
• Đặt điểm dừng người-duyệt trước mọi hành động gửi ra ngoài.
• Chạy thử trên sprint cũ, so kết quả với bản bạn từng làm tay.
• Thêm bước ghi log: lưu lại đầu vào + đầu ra mỗi lần để truy vết.
• Bàn giao tài liệu vận hành để đồng nghiệp chạy được khi bạn nghỉ.

Template: Checklist "an toàn agent" (tái dùng)

• [ ] Agent chỉ có quyền đọc ticket, không quyền xóa/sửa.
• [ ] Khóa API lưu ở nơi bí mật (env/secret manager), không nằm trong prompt.
• [ ] Có điểm dừng người-duyệt trước khi gửi khách.
• [ ] Mỗi lần chạy có log đầu vào/đầu ra.
• [ ] Có prompt in "CHECKLIST DUYỆT" để người soát nhanh.
• [ ] Có phương án dự phòng khi AI lỗi (fallback về prompt thủ công).

Sai lầm thường gặp

• Cho agent quyền tự gửi khách: một lần ảo giác là gửi tin sai cho toàn bộ khách hàng. Luôn có điểm dừng người-duyệt.
• Nhét API key/token vào prompt hay Google Doc: rò rỉ dữ liệu nghiêm trọng. Dùng secret manager của công cụ.
• Cấp quyền quá rộng cho Jira/GitHub: agent chỉ cần quyền đọc; đừng cấp quyền ghi/xóa.
• Không log: khi bản sai lọt ra, bạn không truy được agent đã đọc gì. Luôn ghi log.
• Phụ thuộc quá mức vào tự động: đội ngũ quên cách làm tay. Giữ prompt thủ công làm dự phòng và luyện định kỳ.

Điều rút ra

Agent = nối các prompt đã tốt thành một luồng tự chạy, nhưng luôn dừng ở bản nháp chờ người duyệt. Bắt đầu ở mức no-code, siết quyền tối thiểu, ghi log đầy đủ — bạn tiết kiệm hàng giờ mà vẫn kiểm soát rủi ro.