Agent Data StudioTrang chủ / Hướng dẫn
Hướng dẫnBạn nói việc. Agent làm theo sổ tay.
Bạn duyệt.
Bạn không cần nhớ lệnh hay công thức. Hãy nói việc cần làm bằng tiếng Việt thường, như khi giao việc cho một đồng nghiệp. Trang này giải thích cách mọi thứ vận hành bằng những hình ảnh quen thuộc, kèm ba ví dụ có thật.
Một nhân viên phân tích mới vào công ty
Mỗi thẻ dưới đây là một thứ trong đời thường, kèm tên kỹ thuật ở dòng chữ nhỏ cuối thẻ, để khi cần tra tiếp bạn biết tìm chữ gì.
Nhân viên= ứng dụng AI bạn đang dùng
Codex, Claude Code, Claude Desktop hoặc Antigravity. Nó hiểu tiếng Việt, làm việc ngay trên máy bạn và nghe theo bạn.
hostSổ tay quy trình= 9 skill
Khảo sát thế nào, đặt tên công thức ra sao, dựng trang theo mẫu nào. Trước mỗi việc, nhân viên mở đúng chương trong sổ tay rồi mới làm.
skills/*/SKILL.mdChùm chìa khoá= 16 công cụ MCP
Mỗi chìa mở đúng một việc: xem danh sách bảng, chạy một phép tính, thêm một công thức, dựng một trang từ mẫu. Không có chìa “mở tất cả”.
MCP toolsNội quy két dữ liệu= policy an toàn dữ liệu
Chỉ được mang bảng tổng hợp ra ngoài, không được mang danh sách từng dòng. Cột nhạy cảm bị khoá riêng. Mọi lần mở két đều được ghi vào sổ.
policy.py · audit logTủ hồ sơ riêng của bạn= trạm dữ liệu
Ghi chú, quyết định và bài học của từng dự án nằm ở đây, trên máy bạn. Tủ này không bao giờ được đưa lên GitHub.
workspace/ · ADS_DATABạn= người duyệt
Bạn đặt mục tiêu, trả lời những câu hỏi ngược, và là người nói “đạt” cuối cùng — nhất là khi nhìn trang báo cáo, thứ agent không tự nhìn thấy được.
nghiệm thuMột dự án đi qua 5 chặng
Ở mỗi chặng: bạn làm gì, agent làm gì, và bạn nhìn thấy gì để biết nó làm đúng. Chặng nào chưa đạt thì chưa sang chặng sau.
- 1
Hỏi đúng việc
Bạn: nói mục tiêu, ai sẽ xem báo cáo, họ cần quyết định điều gì.
Agent: hỏi ngược chỗ còn mơ hồ; tra xem trước đây đã làm việc tương tự chưa.
Bạn thấy: hồ sơ
PROJECT.mdvà danh sách chỉ số cần tính. - 2
Đọc dữ liệu
Bạn: chỉ cho agent file hoặc báo cáo nguồn.
Agent: kiểm cột, kiểu dữ liệu, ô trống; tính thử vài con số để đối chiếu.
Bạn thấy: từ điển dữ liệu (
DATA_DICTIONARY) và cảnh báo chất lượng. - 3
Dựng
Bạn: lưu báo cáo dạng
.pbipkhi được nhắc; đóng file trước khi agent ghi trang.Agent: dựng mô hình, viết công thức, tạo trang từ mẫu đã duyệt.
Bạn thấy: công thức mới trong Power BI Desktop, trang báo cáo mới.
- 4
Kiểm
Bạn: nhìn ảnh chụp và con số; chưa ưng thì nói lại, agent quay về chặng 3.
Agent: kiểm cú pháp, mở lại Desktop, chụp ảnh, nhờ một người chấm độc lập.
Bạn thấy: ảnh chụp trang và danh sách lỗi còn lại (nếu có).
- 5
Bàn giao & học
Bạn: xác nhận “xong”.
Agent: viết 4 tài liệu Kế hoạch → Thay đổi → Kiểm chứng → Bàn giao; đóng gói bài học.
Bạn thấy: hồ sơ đầy đủ; lần sau hỏi “đã làm cái này chưa?” là tra được.
Chưa ưng ở chặng 4? Bạn nói lại, agent quay về chặng 3. Chặng nào chưa đạt thì chưa sang chặng sau.
Chưa có Power BI, chỉ có một file bán hàng
Repo có sẵn file samples/sales-demo.csv: 12 dòng bán hàng giả lập theo tháng, vùng và nhóm hàng. Bạn chưa cần cài Power BI để thử.
Agent mở chương khảo sát dữ liệu trong sổ tay (skill data-discovery), kiểm file, tính con số và lưu ghi chú vào tủ hồ sơ của bạn (workspace/outputs/).
Mẹo bắt lỗi: con số đúng nằm sẵn trong samples/README.md. Nếu agent báo khác 182 đơn, hãy bảo nó chỉ ra các dòng đã cộng trước khi tin.
Đọc samples/sales-demo.csv, cho tôi tổng số đơn và doanh thu, gợi ý 3 câu hỏi kinh doanh, rồi lưu ghi chú.
Đã kiểm 12 dòng, không có ô trống. Tổng 182 đơn · 20.350.000 VND. Gợi ý: (1) Vùng North hay South tăng doanh thu nhanh hơn qua 3 tháng? (2) Notebook ít đơn hơn Accessory nhưng chiếm bao nhiêu phần doanh thu? (3) Giá trị trung bình mỗi đơn có đổi theo tháng không? Ghi chú đã lưu vào workspace/outputs/.
Chia theo tháng cho tôi đối chiếu.
| Tháng | Số đơn | Doanh thu (VND) |
|---|---|---|
| 2026-01 | 55 | 6.050.000 |
| 2026-02 | 61 | 6.800.000 |
| 2026-03 | 66 | 7.500.000 |
Có một báo cáo Power BI đang mở
Khi báo cáo đang mở trong Power BI Desktop, agent dùng chìa khoá chạy truy vấn (execute_dax_local) để hỏi thẳng mô hình dữ liệu trên máy bạn và nhận về một bảng tổng hợp nhỏ.
Khi yêu cầu là “kéo nguyên bảng khách hàng”, nội quy két chặn lại ngay ở máy chủ, trước khi dữ liệu kịp đi vào AI, và gợi ý cách hỏi bằng bảng tổng hợp.
Nói cho đúng: đây là lưới chống sơ ý. Nó không thay quyền truy cập hay bảo mật theo dòng (RLS) mà công ty bạn đặt trên mô hình.
Số khách hàng theo phân khúc năm nay?
| Phân khúc KH | Số KH |
|---|---|
| KHCN | 3.438 |
| KHDN | 538 |
| KHCN VIP | 225 |
Kéo nguyên bảng khách hàng ra xem.
Đã chặn: yêu cầu lấy danh sách từng dòng. Dữ liệu từng dòng ở lại trong Power BI; muốn xem chi tiết, hãy mở báo cáo trong Desktop. Agent được gợi ý viết lại thành bảng tổng hợp.Lần chặn này được ghi vào sổ kiểm tra của dự án.
“Thêm một trang giống trang tháng trước”
Agent không tự vẽ trang từ đầu. Nó làm theo sáu bước cố định, và bước cuối là của bạn.
- 1
Agent làm
Chọn mẫu đã duyệt
Một trang bạn từng ưng, đã được cắt thành khuôn dùng lại (gọi là kit).
- 2
Bạn làm, agent nhắc
Đóng file .pbip
Agent nhắc bạn đóng file. Nếu file đang mở, lần lưu sau của Desktop sẽ đè mất trang mới.
- 3
Agent làm
Ghi trang
Giữ nguyên kiểu dáng của mẫu, chỉ thay dữ liệu bằng bảng và cột của bạn.
- 4
Agent làm
Kiểm cú pháp
Một công cụ của Microsoft đọc lại file trang; phải 0 lỗi mới đi tiếp.
Cổng: 0 lỗi
- 5
Agent làm
Mở lại và chụp ảnh
Desktop nạp lại báo cáo, agent chụp ảnh trang vừa dựng.
- 6
Bạn làm
Bạn xem bằng mắt
Một người chấm độc lập soi ảnh; bạn là người nói “đạt”.
Cổng cuối: bạn nói “đạt”
Ảnh còn lỗi hiển thị? Agent sửa lại từ bước 3 rồi kiểm, chụp lại, tới khi bạn nói “đạt”.
8 lệnh, nói theo kiểu công việc
Lệnh là lối tắt cho những việc hay lặp lại trong vòng đời một dự án. Bạn không bắt buộc phải dùng: nói bằng lời thường vẫn được.
| Lệnh | Giống như… | Khi nào dùng | Agent sẽ làm gì |
|---|---|---|---|
/pbi-help | Hỏi lễ tân nên gặp ai | Chưa biết bắt đầu từ đâu | Xem bạn đang có gì trong tay và chỉ quy trình phù hợp |
/pbi-setup | Xin một ngăn tủ hồ sơ | Lần đầu tiên | Kiểm tra hoặc dựng trạm dữ liệu cho các dự án |
/pbi-new <tên> | Mở hồ sơ dự án mới | Bắt đầu một dự án | Tạo thư mục dự án, tra kinh nghiệm cũ, bắt đầu khảo sát |
/pbi-scan <file> | Chụp lại toàn bộ một thiết kế đẹp | Có báo cáo mẫu muốn học theo | Ghi lại mọi trang, màu, font, danh mục biểu đồ vào hồ sơ |
/pbi-kit <file> | Cắt thiết kế đẹp thành khuôn dùng lại | Muốn tái dùng bố cục của mình | Tạo bộ mẫu riêng; nhắc bạn kiểm quyền sử dụng trước khi chia sẻ |
/pbi-done | Ký biên bản bàn giao | Xong dự án | Chạy danh sách kiểm, chốt hồ sơ, ghi nhật ký, đóng gói bài học |
/pbi-pack | Viết bài học vào sổ chung | Sau dự án hoặc định kỳ | Chắt bài học vào 4 ngăn: công nghệ · ngành · nghiệp vụ · Power BI |
/pbi-recall <từ khoá> | Lật sổ cũ | “Đã làm cái này chưa nhỉ?” | Tìm dự án cũ, bài học, mẫu dùng lại được — kèm đường dẫn |
Gõ / để gọi lệnh chỉ chạy trên ứng dụng có hỗ trợ. Cách luôn dùng được: nói “đọc commands/pbi-new.md trong repo rồi làm theo”. Tab chat của Claude Desktop không có lệnh và sổ tay, chỉ có 16 công cụ.
Câu hay hỏi
Dữ liệu của tôi có bị đưa lên mạng không?
Với Power BI Desktop, agent nói chuyện với báo cáo ngay trên máy bạn (qua địa chỉ nội bộ localhost). Chỉ bảng tổng hợp đi vào AI; danh sách từng dòng bị chặn. Kết nối tới Power BI Service là luồng riêng, chỉ bật khi chính bạn cấu hình.
Agent có tự ý sửa báo cáo của tôi không?
Agent chỉ ghi công thức hay quan hệ vào mô hình khi bạn yêu cầu. Trang báo cáo chỉ được ghi khi file đã đóng. Nếu nhiều agent cùng làm một dự án, tại một thời điểm chỉ một agent được ghi; nó đặt một tờ “đang sửa” (file .powerbi-write-lock) để các agent khác chỉ đọc.
Tôi có cần biết DAX không?
Không cần để bắt đầu: bạn hỏi bằng lời, agent viết công thức. Biết một chút DAX sẽ giúp bạn duyệt công thức agent đề xuất tự tin hơn.
Máy Mac dùng được không?
Phần làm việc với Power BI Desktop chỉ chạy trên Windows, vì Power BI Desktop chỉ có trên Windows. Phần khảo sát file CSV về lý thuyết không phụ thuộc Desktop, nhưng bộ cài hiện chỉ hỗ trợ Windows.
Agent làm sai thì sao?
Mỗi chặng đều có điểm kiểm; bạn từ chối là agent dừng và làm lại. Con số luôn được đối chiếu với một nguồn độc lập. Nếu công cụ không chạy, xem mục sự cố ở trang Cài đặt.
Tại sao phải lưu báo cáo dạng .pbip?
File .pbix là một gói nén. Lưu thành .pbip (Power BI Project) biến báo cáo thành các file chữ bình thường, nên agent đọc và sửa an toàn, và bạn xem lại được lịch sử thay đổi.
Claude Desktop khác gì Claude Code?
Tab chat của Claude Desktop chỉ nhận 16 công cụ MCP; nó không đọc sổ tay (skill) hay lệnh từ repo. Muốn có đủ quy trình, dùng Claude Code, Codex hoặc Antigravity mở trong thư mục repo.
MCP- Chuẩn cắm để ứng dụng AI dùng được công cụ bên ngoài, giống ổ cắm điện chung cho mọi thiết bị. Bản kỹ thuật
Tool(công cụ)- Một chìa khoá làm đúng một việc, ví dụ “liệt kê bảng” hay “chạy truy vấn”; repo có 16 chìa. Danh sách 16 công cụ
Skill- Một chương trong sổ tay quy trình, agent đọc trước khi làm; repo có 9 skill. Bản kỹ thuật
Lệnh /pbi-*- Lối tắt gọi một quy trình hay dùng, như mở dự án hay đóng dự án; có 8 lệnh. Bản kỹ thuật
Agent chuyên trách- Đồng nghiệp làm một vai hẹp; có 2 agent: pbi-knowledge-curator đóng gói bài học, pbi-render-reviewer chấm ảnh chụp trang. Bản kỹ thuật
Trạm dữ liệu/ Knowledge Dir- Tủ hồ sơ riêng trên máy bạn:
workspace/trong repo, hoặc một thư mục khác do bạn chọn quaADS_DATA. Bản kỹ thuật Template kit- Một trang báo cáo đẹp đã được cắt thành khuôn, để dựng trang mới giữ nguyên kiểu dáng. Bản kỹ thuật
PBIP / PBIR- Cách lưu báo cáo Power BI thành các file chữ thay vì một gói nén, để agent sửa an toàn và có lịch sử. Bản kỹ thuật
Policy(nội quy két dữ liệu)- Luật ở máy chủ: chỉ cho bảng tổng hợp đi vào AI, khoá cột nhạy cảm, ghi sổ mọi lần truy vấn. Bản kỹ thuật
Bước tiếp theo
Cài đặt
Dán một yêu cầu vào ứng dụng AI của bạn; agent hỏi trước khi cài, rồi làm bài mẫu cùng bạn.
Thiết kế hệ thống
Bản kỹ thuật: MCP server, chính sách dữ liệu, skill, trạm dữ liệu và vòng dựng báo cáo.