Chủ đề 5 · Xây "Trợ lý BA" cá nhân bằng Agent — Kết nối & tự động hóa Jira: sinh và cập nhật ticket bằng AI

Bối cảnh

Cập nhật Jira là "thuế" hằng ngày của BA: tạo ticket từ story, cập nhật mô tả, gắn AC, chuyển trạng thái, viết comment tiến độ. Bài này đưa bạn từ copy-paste thủ công lên bán tự động qua kết nối Jira.

Ba cách kết nối Jira (từ dễ đến mạnh)

• Thủ công có template: AI sinh nội dung theo đúng format Jira, bạn dán vào. Rủi ro thấp nhất, phù hợp người mới.
• AI trong Jira / tích hợp sẵn: Atlassian Intelligence hoặc app AI trong Marketplace tạo/tóm tắt ticket ngay trong Jira.
• Agent qua API/MCP: agent AI gọi Jira REST API (hoặc Jira MCP server) để tự đọc/ghi. Mạnh nhất, nhưng cần kiểm soát quyền (bài 6 & 7).

Bài này tập trung cách 1 và giới thiệu cách 3; xây agent đầy đủ ở Bài 6.

Ví dụ cụ thể: sinh ticket sẵn-để-dán

VAI TRÒ: Trợ lý BA thao tác với Jira.
NHIỆM VỤ: Từ user story dưới đây, sinh nội dung ticket Jira loại Story.
XUẤT RA CÁC TRƯỜNG:
Summary: (1 dòng, <120 ký tự)
Description (định dạng theo cấu trúc: Bối cảnh / Mục tiêu / Phạm vi / Ngoài phạm vi)
Acceptance Criteria: checklist dạng gạch đầu dòng, Given/When/Then
Labels đề xuất: (3-5)
Story point đề xuất kèm 1 câu lý do (đây chỉ là GỢI Ý, cần team chốt)
Câu hỏi mở nếu thiếu thông tin

RÀNG BUỘC: Không tự đặt priority hay assignee. Không bịa số liệu.
USER STORY: <<dán story từ Bài 2>>

Giới thiệu cách 3: gọi Jira qua API/MCP

Nếu công ty cho phép, bạn có thể để agent tự thao tác:

• Jira REST API: xác thực bằng API token, gọi endpoint tạo/cập nhật issue.
• Jira MCP server: một cầu nối chuẩn để công cụ AI (Claude, IDE agent) "nhìn thấy" và thao tác Jira an toàn qua các tool được định nghĩa trước.

Ví dụ chỉ dẫn cho agent (mô tả tự nhiên, không phải code):

Dùng tool Jira. Với issue PROJ-123:
Đọc description và comment hiện tại.
Soạn 1 comment cập nhật tiến độ dựa trên ghi chú tôi cung cấp.
HIỂN THỊ comment cho tôi DUYỆT. Chỉ post sau khi tôi gõ "OK".
Không đổi trạng thái, không đổi assignee.

Nguyên tắc vàng: human-in-the-loop cho mọi hành động ghi (write). AI đọc thoải mái, nhưng ghi phải qua bạn duyệt — ít nhất cho tới khi bạn tin quy trình.

Các bước triển khai (cách 1, bắt đầu ngay)

• Chuẩn hóa 1 "khuôn ticket" của team bạn (các trường bắt buộc).
• Đưa khuôn đó vào prompt mẫu ở trên.
• Sinh ticket, rà AC và câu hỏi mở.
• Dán vào Jira, tự tay đặt priority/assignee (những trường AI KHÔNG được đụng).
• Lưu prompt vào bộ "trợ lý" của bạn để tái dùng.

Template/Checklist trước khi tạo/cập nhật ticket

[ ] Summary ngắn, đúng chuẩn đặt tên của team
[ ] Description đủ 4 phần (Bối cảnh/Mục tiêu/Phạm vi/Ngoài phạm vi)
[ ] AC testable, có negative test
[ ] Priority & Assignee do NGƯỜI đặt, không phải AI
[ ] Story point chỉ là gợi ý, chờ team chốt
[ ] Không dữ liệu nhạy cảm trong description
[ ] Với thao tác API: chỉ ghi sau khi human duyệt

Sai lầm thường gặp

• Cho agent quyền ghi quá sớm: một agent tự chuyển 30 ticket sang "Done" vì hiểu nhầm ngữ cảnh sẽ phá nát báo cáo sprint. Bắt đầu ở chế độ chỉ-đọc + duyệt-thủ-công.
• AI bịa mã ticket / link: nó có thể tham chiếu PROJ-999 không tồn tại (ảo giác). Luôn kiểm chứng ID với Jira thật.
• Nhét dữ liệu nhạy cảm vào ticket: mô tả ticket có thể lộ PII/khoá bí mật ra ngoài phạm vi cần thiết.
• Phụ thuộc quá mức vào story point AI đề xuất: point là sự đồng thuận của team dựa trên năng lực thực tế, không phải con số AI phán.

Bài 5 làm điều tương tự cho Confluence: tự sinh và cập nhật tài liệu (BRD, spec, release note).