Mã nguồn mở  ·  Truy vấn DAX qua policy của repoOpen source  ·  DAX queries checked by repo policy

Bắt đầu với AI và dữ liệu.
Đi từng bước tới Power BI.Start with AI and data.
Take clear steps to Power BI.

Một repo chứa engine, kỹ năng và hướng dẫn. Cài bằng ứng dụng AI bạn đang dùng, thử ngay với dữ liệu mẫu, rồi nối báo cáo Power BI khi bạn sẵn sàng. Công việc cá nhân ở workspace/ và được Git bỏ qua.One repo contains the engine, skills, and guide. Install with the AI app you already use, try the sample data, then connect Power BI when ready. Your work stays in the Git-ignored workspace/.

Mã nguồn mở · Cài đặt và Power BI Desktop trên Windows.Open source · Windows setup and Power BI Desktop.

Bắt đầu theo 4 bướcStart in 4 steps Xem trên GitHubView on GitHub
MCP · stdio DAX · TOM · PBIR Claude Code · Claude Desktop · Codex · Antigravity Chạy local · WindowsRuns local · Windows
Tính năngFeatures

Đọ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.

  1. Đọc
  2. Hỏi
  3. Xây
  4. Trình bày
  5. tri thức giữ lại cho vòng sau
Đọc

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_table
Hỏi

DAX 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). Service cần cấu hình xác thực riêng và chưa được nghiệm thu ở bản này.

execute_dax_local · _service
Xây

Ghi 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_relationship
Trình bày

Thiết kế trang báo cáo có kiểm tra

Agent Data Studio giúp lập brief, chọn bố cục và gắn dữ liệu vào trang PBIR. Khi dùng mẫu trong dự án, hãy kiểm tra quyền sử dụng, nhãn, số liệu, tương tác và bản render trong Power BI Desktop. Xem quy trình thiết kế.

Xây

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.

Vòng sau

Tri thức dự án, dùng lại khi cần

Ghi chú và kết quả nằm trong workspace/knowledge/ ở chế độ mặc định. Nếu bạn dùng trạm riêng qua ADS_DATA, tri thức được lưu tại trạm đó.

knowledge_status · distill_report_design
Đọc

Khám phá dữ liệu và ghi lại quyết định

Skill data-discovery giúp AI khảo sát nguồn, hỏi thêm điều chưa rõ và tạo tài liệu cho chỉ số, dữ liệu và trang báo cáo. Bắt đầu với CSV mẫu trước khi làm việc với dữ liệu riêng.

Research → Key Info → Planning → Build → Monitor
Hỏi

Chặn các truy vấn thô thường gặp

Công cụ truy vấn DAX của repo áp dụng chính sách tại server và ghi nhật ký. Đây là lớp giảm rủi ro; với dữ liệu nhạy cảm, bạn vẫn cần quyền truy cập và RLS phù hợp trên model.

Chặn dump bảng thô (mặc định BẬT) PII blocklist theo dự án Audit log JSONL từng truy vấn Trần 200 dòng cho kết quả dimension Không thay thế RLS — guard chống rò rỉ sơ ý
Cách hoạt độngHow it works

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.

Bốn tầng: yêu cầu đi xuống, chỉ số tổng hợp đi lên

Bạn hỏi bằng lời thườngtrong Codex, Claude Code, Claude Desktop hoặc Antigravity

  1. T4Workflow & Tri thức

    Skill pbi-build điều phối 9 khâu · template kits · distill model/trang · artifact bàn giao mỗi dự án.

  2. T3Policy cho công cụ truy vấnCổng kiểm

    Aggregate-only · PII blocklist · audit log · row cap được áp dụng khi gọi công cụ DAX của repo. Quyền truy cập nguồn vẫn do bạn quản lý.

  3. T216 MCP tools (repo này)

    Query DAX · schema discovery · TOM write · PBIR template engine · distill. Nối Desktop (ADOMD), Service (REST) và file .pbip.

Power BIDesktop (ADOMD) · Service (REST) · file .pbip

T1Delegate cho Microsoft

Server powerbi-modeling-mcp chính chủ lo modeling hàng loạt, transaction, TMDL, DAX validate. Không xây lại thứ Microsoft đã làm tốt.

Làn riêng, cài tuỳ chọn: truy vấn qua server Microsoft không đi qua policy T3.

Chín khâu từ dữ liệu tới bàn giao, khâu nào cũng có cổng kiểm

  1. Dữ liệukhâu 1–2

    1. 1

      Kết nối dữ liệu

      Power Query, tham số M, không để mật khẩu trong M.

      Cổng: refresh OK, số dòng khớp

    2. 2

      Làm sạch, ép kiểu

      Bảng staging, kiểu cột khai tường minh.

      Cổng: kiểu cột đúng

  2. Mô hình & con sốkhâu 3–5

    1. 3

      Mô hình hoá

      Star schema, bảng ngày phủ đủ, quan hệ rõ.

      Cổng: ERD ra hình sao

    2. 4

      Measure DAX

      Thử bằng TOM, lưu vào TMDL.

      Cổng: khớp số biết trước

    3. 5

      Truy vấn tổng hợp

      Chỉ số tổng hợp đi qua policy, cột PII bị chặn.

      Cổng: audit không chặn bất thường

  3. Báo cáokhâu 6–8

    1. 6

      Thiết kế trang

      Nhân bản trang đã duyệt, viết Design Brief.

      Cổng: bạn duyệt Brief

    2. 7

      Dựng trang PBIR

      Clone và gắn lại dữ liệu khi file .pbip đóng.

      Cổng: validate sạch, ảnh chụp đã review

    3. 8

      Nâng cao

      Tooltip, drill-through, field parameter; bookmark làm tay.

      Cổng: demo được trên Desktop

  4. Bàn giaokhâu 9

    1. 9

      Review, bàn giao

      Publish khi được yêu cầu, lưu tri thức.

      Cổng: đủ 4 artifact, /pbi-done

Trước khâu 1: khảo sát nghiệp vụ và lập kế hoạch với skill data-discovery; bạn duyệt phạm vi.

Không khớp thì quay lại: số sai về model và measure (khâu 3–4), trang lỗi hiển thị sửa lại ở khâu 7.

Luật chung: không có bằng chứng của cổng kiểm thì khâu đó chưa xong.

Đánh giá thẳngStraight talk

Điểm mạnh — và giới hạn nói thậtStrengths — and honest limits

Báo cáo UAT lưu trữ ghi lại phép thử của phiên bản trước. Nó không xác nhận trạng thái cài đặt và bốn host của bản hiện tại.

Điểm mạnh

  • Công cụ cho trang PBIR — có thể áp dụng bố cục và gắn field khi đầu vào phù hợp; người dùng nghiệm thu bản render trong Power BI Desktop.
  • Policy ở server — truy vấn qua công cụ DAX của repo được kiểm tra và ghi nhật ký; vẫn cần quyền truy cập phù hợp ở nguồn dữ liệu.
  • Một source cho bốn host — repo có adapter skill cho Codex, Claude Code và Antigravity; tab chat của Claude Desktop chỉ nhận công cụ MCP. Cần kiểm tra việc nạp skill và MCP trên từng host sau cài đặt.
  • Có dữ liệu mẫu để thử — bắt đầu từ CSV đi kèm trước khi kết nối với báo cáo Power BI của bạn.
  • Tài liệu dự án cùng trạm — ghi chú, quyết định và kết quả được lưu để bạn và AI tra lại khi cầ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.
Cấu trúc repo

Source và nơi làm việc, cùng một chỗ

Người mới chỉ cần mở folder repo trong AI host. Skill và công cụ lấy từ source; kết quả cá nhân được lưu trong workspace/ và Git bỏ qua folder này.

SOURCE

skills/ · powerbi_agent/ · scripts/

Kỹ năng, engine, công cụ cài và kiểm tra. Bốn host cùng dùng source này; Claude Desktop (tab chat) chỉ dùng phần MCP.

HOST

.agents/skills/ · .claude/skills/

Adapter cho Codex, Antigravity và Claude Code; Claude Desktop không nạp skill. Xác nhận khả năng nạp trong từng host sau cài.

WORK

workspace/projects/ · knowledge/ · outputs/

Nơi lưu dữ liệu công việc mặc định. Trạm riêng ngoài repo được hỗ trợ qua ADS_DATA.

Bắt đầu

Một đường đi rõ ràng cho người mới

Dán một yêu cầu vào Codex, Claude Code, Claude Desktop hoặc Google Antigravity. Agent hỏi bạn trước khi cài thêm phần mềm, rồi cài, kiểm tra và báo lại. Mở lại AI trong repo, rồi thử một yêu cầu với dữ liệu mẫu.

  • Source: engine, scripts và skills đều nằm trong repo.
  • Trạm mặc định: workspace/ trong repo, bị Git bỏ qua.
  • Việc đầu tiên: mở samples/sales-demo.csv cùng AI.

Lấy yêu cầu cài đặt Đọc Giới thiệu

Từ lúc dán yêu cầu tới kết quả đầu tiên
  1. 1

    Dán một yêu cầu

    Vào Codex, Claude Code, Claude Desktop hoặc Antigravity.

  2. 2

    Agent hỏi trước khi cài

    Agent trình kế hoạch; phần mềm cài thêm chỉ khi bạn đồng ý.

    Cổng: bạn đồng ý

  3. 3

    Cài, kiểm tra, báo lại

    Chạy trình cài cho đúng ứng dụng, chạy doctor, chép lại từng dòng.

    Cổng: doctor không còn dòng FAIL

  4. 4

    Mở lại AI trong repo

    Phiên mới thấy công cụ của repo.

  5. 5

    Thử với dữ liệu mẫu

    Mở samples/sales-demo.csv cùng AI, chưa cần Power BI.

    Đúng khi: ra 182 đơn và 20.350.000 VND

Khi đã sẵn sàng: nối báo cáo Power BI của bạn và đi tiếp chín khâu.

An toàn dữ liệu: policy của Agent Data Studio giảm rủi ro khi dùng công cụ truy vấn của repo và ghi nhật ký kiểm tra. Với dữ liệu nhạy cảm, hãy áp dụng RLS, quyền truy cập tối thiểu và khai báo cột cần bảo vệ trong policy của trạm.

Bắt đầu với Agent Data Studio,
làm việc cùng AI và Power BI.Start with Agent Data Studio,
work with AI and Power BI.

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.

Cài đặt ngay Star trên GitHub