powerbi-agent
Biến AI Agent thành
chuyên gia Power BI, ngay trên máy bạn.Turn your AI Agent into
a Power BI expert, right on your machine.
Nói việc cần làm bằng ngôn ngữ tự nhiên — AI khảo sát theo quy trình phân tích KPIM, dựng mô hình, viết công thức, tạo trang báo cáo đẹp theo template, và học từ mỗi dự án. Dữ liệu chi tiết không rời Power BI.Say what you need in plain language — the AI surveys with the KPIM process, builds the model, writes measures, creates polished report pages from templates, and learns from every project. Detailed data never leaves Power BI.
🏛️ Xây bởi KPIM — chia sẻ miễn phí cho cộng đồng & học viên. ⚠️ Chỉ chạy Windows.🏛️ Built by KPIM — shared free with the community & students. ⚠️ Windows only.
Đọc, hỏi, xây và trình bày — trọn vòng Power BIRead, ask, build and present — the full Power BI loop
Không chỉ "chat với data": agent khám phá model, viết measure, dựng trang báo cáo chuẩn design system, và tự chưng cất tri thức cho dự án sau.
Khám phá model tức thì
Báo cáo nào đang mở, bảng nào, cột kiểu gì, measure công thức ra sao — agent tự trả lời, không cần thuộc DMV.
list_tables · describe_tableDAX lên Desktop & Cloud
Chạy truy vấn thẳng vào file .pbix đang mở (ADOMD) hoặc dataset đã publish trên Service (REST, token cache).
execute_dax_local · _serviceGhi thẳng vào model
Tạo/sửa measure, nối relationship qua TOM ngay trên model đang mở — Desktop thấy ngay, không cần Tabular Editor.
add_measure · add_relationshipTemplate kit — trang báo cáo đẹp, tái tạo được
Bài học đắt giá: layout agent tự dựng luôn xấu; clone trang đã chứng minh rồi đổi binding thì đẹp. apply_template biến luật đó thành code — style giữ nguyên 100%, chỉ đổi field. Trang nào bạn ưng → distill_template đóng thành kit, dự án sau tái tạo đúng chuẩn đó. Kèm sẵn kit kpim-business-light (card KPI, combo chart, pivot, slicer, map).
Song kiếm với Microsoft
Chạy cạnh powerbi-modeling-mcp chính chủ: modeling hàng loạt giao Microsoft; query, policy, report layer — phần MS không làm — thuộc về đây.
Knowledge OS — AI giỏi dần MỚI
Mỗi dự án khép lại, AI tự rút bài học vào "bộ nhớ" riêng của bạn (ngoài repo) — dự án sau nó đọc kinh nghiệm cũ trước khi bắt tay. 8 lệnh: /powerbi-help · setup · new · scan · kit · done · pack · recall.
knowledge_status · distill_report_designQuy trình phân tích KPIM + mẫu tài liệu hóa
Skill kpim-analysis: nhận 1 bộ dữ liệu → tự khảo sát, hỏi ngược người dùng, sinh bộ tài liệu chuẩn hóa (PROJECT, DATA_DICTIONARY, METRICS, DIMENSION, REPORTS, DESIGN + theme, Excel 6 sheet, 6 mindmap) rồi bàn giao pipeline dựng báo cáo.
Research → Key Info → Planning → Build → MonitorDữ liệu thô ở lại trong engine
Chính sách an toàn dữ liệu enforce ở tầng server — không phải lời nhắc trong prompt mà agent có thể quên. Mọi truy vấn đi qua cổng kiểm; mọi verdict ghi lại thành bằng chứng kiểm toán.
Kiến trúc 4 tầng, quy trình 9 khâu4-layer architecture, 9-step pipeline
Agent nói chuyện với Power BI qua MCP; mỗi lớp một trách nhiệm rõ ràng — và một quy trình phân tích chuẩn để dự án nào cũng đi đúng đường.
Workflow & Tri thức
Skill powerbi-pipeline 9 khâu · template kits · distill model/trang · artifact bàn giao mỗi dự án.
Policy an toàn dữ liệu
Aggregate-only · PII blocklist · audit log · row cap — đứng TRƯỚC mọi truy vấn, agent không đi vòng được.
16 MCP tools (repo này)
Query DAX · schema discovery · TOM write · PBIR template engine · distill — nối Desktop (ADOMD) + Service (REST) + file .pbip.
Delegate: microsoft/powerbi-modeling-mcp
Modeling hàng loạt, transaction, TMDL, DAX validate — không xây lại thứ Microsoft đã làm tốt.
Kết nối & Transform
Power Query / M parameter, kiểu dữ liệu tường minh, đếm dòng đối chiếu.
Mô hình hóa
Star schema + relationship; soi lại bằng Mermaid ERD tự sinh.
DAX
Measure có format + verify từng cái; truy vấn tổng hợp qua policy.
Trang báo cáo
apply_template từ kit — đẹp ngay từ lần dựng đầu.
Nâng cao
Tooltip, drill-through, parameters; bookmark thao tác tay.
Bàn giao
4 artifact + chưng cất model/kit thành tri thức tái dùng.
Điểm mạnh — và giới hạn nói thậtStrengths — and honest limits
Sản phẩm được UAT trên dashboard production thật (7 trang, 174 measure) — kể cả những gì nó chưa làm được cũng ghi rõ trong UAT report.
Điểm mạnh
- Report layer mà chưa ai làm — MCP chính chủ Microsoft tuyên bố không sửa trang báo cáo; powerbi-agent dựng/distill trang PBIR bằng clone-and-rebind đã chứng minh bằng sản phẩm thật.
- Policy enforce ở server — các MCP Power BI khác trả dữ liệu thô tùy agent; ở đây chặn từ tầng code, có audit log làm bằng chứng.
- Cài 1 lệnh, chạy 3 host — installer idempotent tự dò ADOMD/TOM mọi bản SSMS, đăng ký Claude Code + Codex + Antigravity cùng lúc.
- Đã UAT trên dữ liệu thật — 17 ca pass trên dashboard production; 4 defect tìm thấy và sửa ngay trong UAT (kể cả bug tồn tại từ code cũ chưa từng chạy live).
- Vòng tri thức khép kín — trang đẹp thành kit, model thành blueprint; agent giỏi dần theo từng dự án của chính bạn.
Giới hạn (và cách bù)
- Chỉ Windows — vì Power BI Desktop chỉ có trên Windows. Phần Service (cloud) về lý thuyết chạy đa nền, nhưng chưa hỗ trợ chính thức.
- Agent không "nhìn thấy" trang render — sau khi dựng trang, người dùng vẫn là người nghiệm thu bằng mắt trong Desktop. Đây là bước bắt buộc trong quy trình.
- Policy là guard, không phải bảo mật cứng — chặn dump sơ ý bằng phân tích DAX best-effort; dữ liệu nhạy cảm thật sự cần RLS trên model + service principal quyền tối thiểu.
- Bookmark không tự động hóa — clone bookmark từng làm vỡ báo cáo thật, nên chủ đích để thao tác tay với hướng dẫn từng bước.
- Ghi trang báo cáo cần file .pbip đóng — ràng buộc của định dạng PBIR; tool tự nhắc trong mọi output.
Bốn trụ cột, nhìn là thấy nằm ở đâuFour pillars — you can see where each one lives
Mỗi nhánh gắn nhãn trụ cột mà nó phục vụ. Bản đồ đầy đủ kèm từ điển thuật ngữ nằm ở INDEX.md trong repo.Every branch is tagged with the pillar it serves. The full map plus a glossary lives in INDEX.md in the repo.
Ngoài repo (không bao giờ commit): Knowledge Dir do bạn chỉ định · .env · policy.json.Outside the repo (never committed): your Knowledge Dir · .env · policy.json.
Nhanh nhất: đưa cho chính agent cài
Dán 1 câu vào Claude Code / Codex / Antigravity — agent clone, dựng môi trường, đăng ký MCP vào cả 3 host và tự học 4 skill + 8 lệnh /powerbi-* đi kèm, cùng bộ references DAX/M/SQL & mẫu tài liệu hóa. Hoặc chạy tay 3 dòng bên cạnh.
- Windows 10/11 + Power BI Desktop (bản cài hoặc Store)
- Python 3.11+
- ADOMD.NET — có sẵn nếu cài SSMS (18–22); installer tự dò mọi vị trí
- Node.js (tùy chọn) — nếu chạy kèm powerbi-modeling của Microsoft
Hướng dẫn đầy đủ kèm xử lý sự cố: INSTALL.html trong repo.
Clone https://github.com/ducnguyen221/powerbi-agent
vào ~/.mcp/powerbi-mcp rồi chạy install.ps1 trong đó
(đọc script trước khi chạy), sau đó restart MCP host.# 1. Lấy mã nguồn
git clone https://github.com/ducnguyen221/powerbi-agent "$env:USERPROFILE\.mcp\powerbi-mcp"
cd "$env:USERPROFILE\.mcp\powerbi-mcp"
# 2. Cài in-place: venv + dò ADOMD/TOM + đăng ký 3 host + skill
powershell -ExecutionPolicy Bypass -File .\install.ps1
# 3. (khuyến nghị) modeling chính chủ Microsoft chạy kèm
claude mcp add powerbi-modeling -s user -- npx -y "@microsoft/powerbi-modeling-mcp@latest" --startNói thật về an toàn dữ liệu: policy của powerbi-agent chặn rò rỉ do sơ ý (agent tiện tay dump bảng) và ghi audit làm bằng chứng — nhưng không thay thế bảo mật cứng. Với dữ liệu nhạy cảm, hãy kết hợp RLS trên model + service principal quyền tối thiểu, và khai báo cột PII vào policy.json ngay đầu dự án.
Cài powerbi-agent,
để agent làm Power BI đúng chuẩn.Install powerbi-agent,
and let the agent do Power BI right.
Mã nguồn mở, miễn phí, MIT. Từ câu hỏi ad-hoc tới dự án phân tích trọn gói — có quy trình, có policy, có bằng chứng.