Tính năngFeatures

Mọi thứ để AI làm Power BI
cho bạn — đúng chuẩn, an toàn.Everything for AI to do Power BI
for you — correct and safe.

powerbi-agent gồm 6 module phối hợp: từ bảo vệ dữ liệu, dựng báo cáo đẹp, đến bộ nhớ dự án giúp AI giỏi dần theo thời gian. Mỗi phần dưới đây có giải thích ngắn cho người mới và chi tiết kỹ thuật cho chuyên gia.powerbi-agent has 6 modules working together: from data protection to building polished reports to a project memory that makes the AI better over time. Each part below has a plain-language summary for newcomers and technical detail for experts.

An toàn dữ liệu — chặn ở tầng máy chủ

AI chỉ nhận được số liệu đã tổng hợp (tổng, trung bình, tỷ lệ…) — dữ liệu chi tiết từng dòng, từng khách hàng ở lại trong Power BI. Kể cả khi AI "quên", hệ thống vẫn tự chặn và ghi lại bằng chứng.

Vì sao đáng tin

Chính sách aggregate-only enforce trong code server (không phải lời nhắc trong prompt): chặn EVALUATE '<bảng>' / ALL(), hướng dẫn viết lại bằng SUMMARIZECOLUMNS/TOPN/measure. Kèm PII blocklist theo dự án (policy.json), audit log JSONL từng truy vấn, trần 200 dòng cho kết quả dimension. Trung thực: đây là guard chống rò rỉ sơ ý — bảo mật cứng vẫn là RLS + service principal tối thiểu.

Báo cáo đẹp — tái tạo từ template đã chứng minh

Trang báo cáo bạn ưng ý được "đóng khuôn" thành template. Dự án sau, AI dựng lại đúng chuẩn thiết kế đó trên dữ liệu mới — màu sắc, bố cục, thẻ KPI giữ nguyên 100%.

Kỹ thuật bên dưới

Bài học đắt giá: layout AI tự dựng từ đầu luôn xấu — clone-and-rebind mới đẹp. distill_template tách trang thành kit (blocks visual.json verbatim + blueprint); apply_template dựng trang mới: giữ nguyên visualContainerObjects (style), chỉ đổi binding field. Kit chứa nghiệp vụ thật ở lại máy bạn; chia sẻ công khai thì sanitize=True tự xóa mọi tên bảng/cột. Xem kho template.

Knowledge OS — AI giỏi dần theo từng dự án MỚI v0.3

Mỗi dự án khép lại, AI tự rút bài học và cất vào "bộ nhớ" của riêng bạn — một thư mục do bạn chỉ định, nằm ngoài phần mềm. Dự án sau, AI đọc kinh nghiệm cũ trước khi bắt tay: hiểu ngành của bạn, nhớ cách bạn thích trình bày, tra lại được "đã từng làm gì tương tự".

Riêng tư mặc địnhCơ chế

Knowledge Dir do user chỉ định (config gitignored — không ai nhận tri thức của ai qua git): projects/<dự án>/ lưu tài liệu + hồ sơ thiết kế · knowledge/ bài học đóng gói theo 4 trục (tech-stack, industry, business-domain, powerbi) chuẩn Why/How-to-apply, dedup · TIMELINE.md append-only. Agent powerbi-knowledge-curator lo việc đóng gói. 8 lệnh: /powerbi-help · setup · new · scan · kit · done · pack · recall — xem Hướng dẫnGuide.

Quy trình phân tích chuẩn KPIM — không làm ẩu

AI không "phóng bút" làm báo cáo ngay. Nó đi đúng trình tự của một chuyên viên phân tích giỏi: hiểu bài toán → hỏi lại cho rõ → tài liệu hóa → lập kế hoạch → mới bắt tay dựng. Mỗi bước có kiểm tra trước khi sang bước sau.

2 lớp quy trình

kpim-analysis (nghiệp vụ): Research → Key Information (6 mindmap + DATA_DICTIONARY, METRICS_CALCULATION, DOMAIN_DIMENSION, REPORTS, DESIGN) → Planning (Excel 2 cấp) → bàn giao. powerbi-pipeline (kỹ thuật, 9 khâu): Power Query → transform M → star schema → DAX (verify từng measure) → truy vấn qua policy → trang báo cáo từ template → tính năng nâng cao → artifact bàn giao. Kèm tài liệu DAX/M/SQL best-practices từ Microsoft Learn.

Bộ công cụ

16 công cụ AI gọi trực tiếp

Đây là "đôi tay" của AI trên Power BI — chia 6 nhóm. Người dùng không cần nhớ tên công cụ: cứ nói việc cần làm, AI tự chọn đúng công cụ.

Danh sách 16 công cụ của powerbi-agent theo nhóm
Nhóm	Công cụ	Việc nó làm
Khám phá	`list_local_reports`	Tìm báo cáo đang mở trên máy
	`list_tables`	Liệt kê các bảng dữ liệu trong mô hình
	`describe_table`	Soi 1 bảng: cột, kiểu dữ liệu, công thức đo lường
Truy vấn 🛡️	`execute_dax_local`	Hỏi số liệu từ file đang mở — qua lớp an toàn dữ liệu
Truy vấn 🛡️	`execute_dax_service`	Hỏi số liệu từ báo cáo đã xuất bản lên cloud
Xây mô hình	`add_measure_local`	Viết công thức đo lường (measure) vào mô hình
Xây mô hình	`add_relationship_local`	Nối quan hệ giữa các bảng
Template 🎨	`list_templates`	Xem kho template có sẵn
	`apply_template`	Dựng trang báo cáo mới từ template — đẹp ngay lần đầu
	`distill_template`	Đóng khuôn trang đẹp thành template tái dùng
Hồ sơ thiết kế	`distill_model_schema`	Chụp "bản đồ" mô hình dữ liệu (kèm sơ đồ quan hệ)
Hồ sơ thiết kế	`distill_report_design`	Quét trọn báo cáo: mọi trang + theme + danh mục visual
Knowledge OS 🧠	`knowledge_status`	Kiểm tra bộ nhớ tri thức đã sẵn sàng chưa
	`setup_knowledge`	Chỉ định thư mục lưu tri thức (1 lần)
	`init_project`	Mở hồ sơ dự án mới
	`log_timeline`	Ghi nhật ký dự án & bài học

Song hành cùng Microsoft — và làm việc theo tổ

powerbi-agent không "làm lại" những gì Microsoft đã làm tốt — nó chạy cạnh công cụ chính chủ của Microsoft và đảm nhận phần Microsoft không làm: trang báo cáo, an toàn dữ liệu, quy trình và bộ nhớ tri thức. Nhiều AI (Claude, Codex, Antigravity) có thể cùng làm 1 dự án theo phân vai rõ ràng.

Phân vai

Modeling hàng loạt/TMDL/validate DAX → microsoft/powerbi-modeling-mcp (official). Query + policy + report layer + knowledge → powerbi-agent. Đa-agent: luật single-writer, lock file .powerbi-write-lock, vai Builder/Reviewer/Documenter, artifact bàn giao chung — định nghĩa trong AGENTS.md.

Cài đặt ngay Xem hướng dẫn dùng

Mọi thứ để AI làm Power BIcho bạn — đúng chuẩn, an toàn.Everything for AI to do Power BIfor you — correct and safe.