PBI_AGENT_QUEST 한결전자 K-Retail 실습판
현재 위치: 출발 전 · 오리엔테이션
Lv.1
수동 드래그앤드롭러
ITEM ACQUIRED
아이템 획득!
SESSION 05 · 15:00–15:30 Power BI · GitHub 발표 (데모) · 간략 실습

데이터 분석가,
이제 안 뽑아도 되나요?
에이전틱 BI_

처음부터 끝까지 말로 하는 에이전틱 BI

한결전자(K-Retail) 가상 데이터로 모델 연결부터 측정값 검증, 보고서 화면까지 에이전트와 함께 만들어 봅니다. Claude Code·GitHub Copilot·Codex 중 익숙한 도구를 사용하면 됩니다.

허석

드림아이시스템 · 정보전략실 · 이사

Microsoft MVP · Business Applications · Power Automate, Copilot Studio

← → 장 이동 · M 지도 · Windows용 Power BI Desktop 기준

Overview 실습 데이터: 한결전자 K-Retail (가상)

마우스 대신 대화로 만드는 Power BI 보고서

에이전트가 모델을 읽고 측정값과 4페이지 보고서를 만든 뒤, 화면을 캡처해 스스로 점검합니다.

고객·매출 데이터는 모두 교육용 가상 데이터입니다. ZIP 구성: CSV 5개 · 테마 JSON · 실습 가이드 · 원본 HTML 매뉴얼

FLOW · 실습 한 바퀴
  1. 01연결열린 모델 확인
  2. 02설계KPI 계산 기준
  3. 03생성DAX 측정값
  4. 04보고서4페이지 + 네비게이션
  5. 05검수캡처로 확인·수정
SCOPE · 생성부터 검수까지
DAX 측정값
요청 예시 · 생성
실습 목표 · 생성 + 검증
보고서 페이지
요청 예시 · 1페이지
실습 목표 · 4페이지 + 네비게이션
디자인·테마
요청 예시 · 기본값
실습 목표 · 테마·레이아웃 기준
화면 검수
요청 예시 · 검수 미포함
실습 목표 · 캡처 확인 후 수정
막대는 요청 범위와 실습 목표를 설명하는 개념도이며, 성능 측정값이 아닙니다.
FORMULA
에이전틱 BI = PBIP 프로젝트 × MCP (모델) × CLI·스킬 (화면·검수)
Chapter 01 · Tech Stack

5계층 기술 스택

에이전트가 가운데에서 MCP와 CLI를 부르고, 맨 위의 스킬이 작업 순서를 정합니다.

STACK · 아래층부터 쌓입니다
  1. 5작업 지침skills-for-fabric기획 → 디자인 → 구현 → 배포 순서와 규칙
  2. 4화면 생성·확인powerbi-report-authorpowerbi-desktopPBIR 검증, Desktop 새로고침·캡처
  3. 3모델 제어Power BI Authoring MCP열린 모델 조회, DAX 실행, 측정값 생성
  4. 2에이전트Claude CodeCopilotCodex파일을 읽고 도구를 실행
  5. 1프로젝트 파일PBIPTMDLPBIR에이전트가 읽고 고칠 수 있는 폴더형 파일
.pbix 파일 하나로는 에이전트가 내용을 고칠 수 없어서 폴더형 .pbip로 저장합니다. 모델은 TMDL에, 화면은 PBIR(JSON)에 담깁니다.
01
아이템 획득: 5계층 아키텍처 청사진 모델은 MCP와 TMDL이, 화면은 CLI와 PBIR이 맡습니다.
Chapter 02 · Dataset & PBIP

실습 데이터와 .pbip 폴더

CSV 5개를 불러온 뒤 파일 > 다른 이름으로 저장 > Power BI project files (*.pbip)로 저장합니다.

STAR SCHEMA · 팩트 1개 + 차원 4개
Dim_Products18제품 · 판매단가·원가
Dim_Stores12매장 · 권역·유형
Fact_Sales2,356주문 항목 · 주문 1,800건
2024-01 ~ 2026-06
Dim_Customers200고객 · 등급·연령대
Dim_Date1,096날짜 · 2024 ~ 2026
차원 테이블 4개가 Fact_Sales와 1:N으로 연결됩니다. 모델 보기에서 관계 4개가 있는지 확인하세요.
Fact_Sales에는 단가가 없습니다

주문수량만 있어서, 에이전트가 Dim_Products의 판매단가를 찾아 매출을 계산합니다. 노란 점선이 그 흐름입니다.

총매출액 = SUMX(Fact_Sales, Fact_Sales[주문수량] * RELATED(Dim_Products[판매단가_KRW]))
PBIP FOLDER · 누가 어디를 고치나
K_Retail_Practice/CSV 5개 · Retail_IQ_Light_KR.json · K_Retail_Sales_Demo.pbip
MCP가 고칩니다 K_Retail_Sales_Demo.SemanticModel/
  • tables/*.tmdl · 테이블 5개
  • relationships.tmdl · 관계 4개
  • model.tmdl
CLI·스킬이 고칩니다 K_Retail_Sales_Demo.Report/
  • report.json · 전역 설정과 테마 등록
  • pages/ · 페이지와 비주얼 JSON
  • StaticResources/ · 테마 파일 복사 위치
02
아이템 획득: 한결전자 스타 스키마 & PBIP 프로젝트 한글이 깨지지 않는 UTF-8-SIG 데이터와 폴더형 프로젝트가 준비되었습니다.
Chapter 03 · MCP & CLIs

MCP와 CLI 2종의 역할

에이전트는 세 도구를 오가며 만들고, 확인하고, 고칩니다.

HUB · 에이전트와 세 도구
AI 에이전트
모델 Power BI Authoring MCP
  • 열린 Desktop 모델에 연결
  • 테이블·관계 조회
  • DAX 실행과 측정값 생성
화면 파일 powerbi-report-author
  • 비주얼 규격 조회
  • PBIR 작성과 validate
  • 오류 위치 알려 주기
Desktop 화면 powerbi-desktop
  • reload로 즉시 새로고침
  • screenshot으로 페이지 캡처
  • 깨진 화면을 보고 재수정
보고서 CLI 패키지 이름은 @microsoft/powerbi-report-authoring-cli입니다.
SELF-CHECK LOOP · 완료 관문
완료네 관문 통과 후
1파일 수정
2validate
3reload
4screenshot
캡처에서 깨진 곳이 보이면 1번으로 돌아가 다시 고칩니다.
03
아이템 획득: MCP·CLI 컨트롤러 계산은 MCP로 정확하게, 화면과 검수는 CLI 두 개로 나눠 처리합니다.
Chapter 04 · Agent Skills github.com/microsoft/skills-for-fabric

작업 순서를 정하는 Authoring Skills

현재 powerbi-report-cli 스킬 하나에 네 모드가 들어 있고, 스킬 파일(SKILL.md)은 회사 기준에 맞게 고칠 수 있습니다.

PIPELINE · 4개 모드
  1. 01기획planning질문·KPI를 정리해 명세서 확정
  2. 02디자인design페이지 유형·차트·색 결정
  3. 03구현·검증authoringPBIR 작성, 검증, 캡처
  4. 04배포managementFabric 워크스페이스에 게시
이전 버전에서는 powerbi-report-planning·design·authoring·management 네 스킬로 나뉘어 있었습니다.

스킬 안의 규칙

  • 차트를 고르기 전에 모델의 테이블과 필드를 먼저 확인
  • JSON을 추측해 쓰지 않고 공식 CLI 2종으로 작업
  • 편집 → validate → reload → 전체 캡처 검토를 마쳐야 완료
  • 결과에 영향을 주는 정보만 짧게 질문
  • 여러 페이지는 pageNavigator와 최신 비주얼로 구성
  • 디자인 단계에서는 파일을 만들지 않고 설계만 확정
  • Q&A·Bing 지도 같은 구형 비주얼은 사용하지 않음

설치된 스킬의 SKILL.md에 글꼴, 원화(₩) 표기, 로고 위치 같은 회사 기준을 적어 두면 모든 보고서가 같은 기준을 따릅니다.

Claude Code 기준 경로: Customize > Plugins > PowerBI Authoring > Edit with VS Code

04
아이템 획득: 공식 Authoring Skills 플러그인 에이전트가 설계 순서와 자가 검증 규칙을 따라 작업합니다.
Chapter 05 · Hands-On

따라 하는 6단계 실습

실습 ZIP을 풀고 CSV 5개를 Desktop에 불러와 K_Retail_Sales_Demo.pbip로 저장한 뒤 시작합니다.

준비물Node.js LTS · Git · AI 도구 1개로그인·약관 동의는 직접 진행
환경Windows + Power BI DesktopMac은 도구 준비까지만
원칙내용을 보고 나서 승인설치·설정 변경·MCP 실행 모두

버튼 기준: VS Code는 GitHub Copilot Chat, GitHub Copilot은 Copilot CLI입니다. STEP 1·2의 도구 선택은 함께 바뀝니다.

STEP 01

도구 설치 준비

스킬, 로컬 MCP, 보고서 CLI를 준비합니다. 모델과 보고서는 아직 건드리지 않습니다.

입력 위치: Claude Code 대화창

  1. 실습 ZIP을 푼 폴더에서 Claude Code를 시작합니다.
  2. 설치 요청을 넣고, 실행할 명령과 설정 변경 내용을 확인한 뒤 승인합니다.

스킬 설치와 MCP 등록은 별개입니다. 둘 다 확인하세요.

채팅창에 입력 · 설치 요청 프롬프트
이 실습 폴더에서 Power BI 에이전트 실습 환경을 준비해 줘.
Microsoft 공식 microsoft/skills-for-fabric 저장소의 설치 방법을 확인해서 Power BI 보고서·시맨틱 모델 스킬과 로컬 Power BI Authoring MCP를 설정해 줘.
@microsoft/powerbi-report-authoring-cli도 설치하고 powerbi-report-author --help가 실행되는지 확인해 줘.
먼저 운영체제와 기존 설치를 확인하고, 변경 계획을 보여준 뒤 승인받아 진행해 줘.
로그인과 약관 동의는 내가 직접 할게. 아직 모델이나 보고서는 수정하지 마.

설치 기준: 공식 스킬 설치 안내 · 로컬 MCP와 OS 제한

STEP 02

연결만 확인하기

에이전트가 내 실습 모델을 보고 있는지 확인합니다. 이 단계에서는 아무것도 바꾸지 않습니다.

선택할 폴더:실습 폴더.pbip · .Report · .SemanticModel
선택하지 않음:ZIP 파일압축을 풀기 전
선택하지 않음:.Report 폴더만모델이 빠짐

Desktop에서 K_Retail_Sales_Demo.pbip를 열고 저장한 뒤 창을 켜 두세요. 아래 경로는 예시입니다.

폴더 지정: .pbip가 있는 폴더에서 Claude Code를 시작합니다.

  1. 실습 폴더를 작업 폴더로 지정하고 .pbip 파일이 보이는지 확인합니다.
  2. 열린 모델과 파일 경로가 맞는지 확인합니다.

파일을 채팅에 첨부하는 것만으로는 폴더 지정이나 MCP 연결이 되지 않습니다.

채팅창에 입력 · 모델 연결 확인만
현재 작업 폴더의 K_Retail_Sales_Demo.pbip와 같은 Windows 환경에서 열려 있는 Power BI Desktop 모델에 연결해 줘.
먼저 작업 폴더의 절대 경로, PBIP 경로, 열린 Desktop 인스턴스와 모델 이름을 보여줘. 여러 인스턴스가 있거나 대상이 불명확하면 나에게 선택을 요청해 줘.
로컬 Power BI Authoring MCP로 테이블·열·관계를 확인하고, 실습 CSV 5종이 로드된 모델이 맞는지 점검해 줘.
연결 또는 권한 오류가 나면 원인과 해결 절차를 보여주고 중단해 줘. 이 단계는 연결 확인만 하고, 모델·측정값·보고서를 변경하거나 Fabric에 게시하지 마.
완료 기준
  • PBIP 경로와 Desktop 모델 이름 확인
  • CSV 5개에 대응하는 테이블 확인
  • 연결 오류 없음 → STEP 3
STEP 03

측정값: 설계 → 생성 → 검증

계산 기준을 먼저 정하고, 승인한 식만 넣고, 결과를 검산합니다. 차트는 아직 만들지 않습니다.

총매출액총원가매출총이익이익률(%)총주문건수총판매수량고객당 평균매출YoY %

STEP 2와 같은 채팅창에서 프롬프트를 하나씩 넣고, 응답을 확인한 뒤 다음으로 넘어갑니다.

3-1 · 설계

주문 건수와 주문 항목 수, 고객당 매출의 분모처럼 기준이 갈리는 지점을 먼저 정합니다.

3-1 프롬프트 · 설계만 요청
STEP 2에서 확인한 모델을 기준으로 KPI 측정값 설계안을 표로 보여줘. 아직 모델은 변경하지 마.
대상: 총매출액, 총원가, 매출총이익, 이익률(%), 총주문건수, 총판매수량, 고객당 평균매출, 전년 동기 대비 매출 성장률 YoY %.
각 항목의 업무 의미, 사용할 실제 열·관계, DAX 초안, 표시 형식, 기존 측정값 재사용 여부를 적어줘.
주문수량과 제품 단가·원가의 관계, 주문번호의 중복, 고객당 매출의 분모, 날짜 테이블·날짜 관계와 전년 데이터 유무를 확인해 줘.
없는 열은 추측하지 말고, 모호한 계산 기준이나 필요한 모델 수정은 나에게 질문한 뒤 멈춰줘.
완료 기준
  • 8개 KPI의 의미·식·표시 형식에 동의
  • 모호한 기준과 관계 문제 해결
3-2 · 생성

승인한 식만 모델에 넣고 KPI 측정값 표시 폴더에 모읍니다. 표시 폴더는 모델 안의 분류이며 파일 폴더와 다릅니다.

3-2 프롬프트 · 설계 확인 후 생성 승인
앞에서 함께 확인한 최종 KPI 설계안을 승인해. 로컬 Power BI Authoring MCP로 해당 측정값을 모델에 적용해 줘.
같은 의미의 기존 측정값은 재사용하고, 새 측정값은 'KPI 측정값' 표시 폴더에 정리하고 승인한 표시 형식을 설정해 줘.
기존 측정값을 바꿔야 하거나 테이블·관계 수정이 추가로 필요하면, 변경 내용을 보여주고 별도 승인을 받아줘.
적용 후 측정값 이름·DAX·표시 폴더·표시 형식을 다시 읽어 생성·재사용·실패 목록을 보여줘. 실패는 숨기지 마.
아직 보고서 화면을 수정하거나 Fabric에 게시하지 마.
완료 기준
  • 재조회 결과와 생성·재사용 목록 일치
  • 남은 생성 오류 없음
3-3 · 검증과 저장

등록한 식이 맞는 숫자를 내는지, 원본 열로 따로 집계한 값과 비교합니다.

3-3 프롬프트 · 결과 검증과 저장 안내
방금 생성·재사용한 KPI를 모델에서 DAX 쿼리로 실행해 전체 합계와 연도별 결과를 표로 보여줘.
매출·원가·수량·고유 주문 수·고객당 매출을 원본 열 기준의 독립 집계와 비교하고, 매출총이익과 이익률도 검산해 줘.
YoY는 비교 가능한 전년 데이터와 날짜 필터를 확인하고, 전년 값이 없거나 0일 때의 빈 값·처리를 설명해 줘.
검사 항목별 통과·실패·확인 불가와 근거를 보여줘. 수정이 필요하면 원인을 설명하고 승인받은 뒤 고치고 다시 검증해 줘.
Desktop에서 PBIP로 저장하는 방법을 안내해 줘. 내가 저장한 다음에는 디스크의 시맨틱 모델 정의에도 측정값이 반영됐는지 확인해 줘.
검증과 저장 확인이 끝날 때까지 보고서 생성이나 Fabric 게시로 넘어가지 마.
완료 기준
  • 설명되지 않은 실패 없음 (YoY 빈 값은 이유 확인)
  • Desktop에서 저장 후 “저장했어. 디스크 반영을 확인해 줘.” 입력
  • 디스크 반영 확인 → STEP 4
STEP 04

4페이지 보고서 만들기

검증한 KPI로 페이지 4개와 상단 네비게이션을 만들고, 검증과 캡처 검토까지 맡깁니다.

경영진 요약
제품·브랜드
권역·매장
고객 세그먼트

STEP 3 저장까지 마친 뒤 같은 채팅창에 넣습니다. 현재 스킬 이름은 powerbi-report-cli, 이전 버전은 powerbi-report-authoring입니다.

STEP 4 프롬프트 · 4페이지 한국어 경영진 리포트 및 페이지 네비게이션 자동 생성
설치된 Power BI 보고서 스킬(powerbi-report-cli, 이전 버전은 powerbi-report-authoring)을 사용해서 K_Retail_Sales_Demo.pbip 파일에 4페이지 분량의 한국어 경영진 리포트를 만들어 줘. 기존 빈 페이지는 삭제해도 돼.
각 페이지 구성은 다음과 같아:
- 1페이지: 경영진 종합 요약 (Executive Summary - 핵심 KPI 카드 5개, 월별 매출 추이, 카테고리별 성과, 연도 슬라이서)
- 2페이지: 제품 및 브랜드 분석 (Product Analysis - 카테고리/브랜드별 매출 및 이익률 비교)
- 3페이지: 권역 및 매장 분석 (Store Analysis - 서울/수도권/영남권/온라인 등 권역별 및 매장 유형별 성과)
- 4페이지: 고객 세그먼트 및 매출 비교 (Customer & Sales Comparison - 고객등급/연령대별 분석 및 전년 대비 비교)

리포트 상단에는 각 페이지로 이동할 수 있는 페이지 네비게이션(Page Navigator) 바를 추가하고, CLI 검증과 스크린샷 캡처 리뷰까지 완료해 줘.
STEP 05

테마 한 번에 적용하기

Retail_IQ_Light_KR.json으로 색과 글꼴(맑은 고딕·Pretendard)을 통일하고, 비주얼에 직접 넣은 색도 테마 색으로 바꿉니다.

#1E3A8A #0284C7 #0D9488 #F59E0B #6366F1 #EC4899 #64748B #10B981
STEP 5 프롬프트 · 한국형 브랜드 테마 JSON 적용
폴더 안에 있는 Retail_IQ_Light_KR.json 파일을 이 리포트의 커스텀 테마로 등록하고, 개별 비주얼에 하드코딩된 색상들을 새 테마 팔레트에 맞게 전체 재정비(Re-sweep)한 뒤 다시 검증해 줘.
STEP 06

Desktop을 다시 열 때는 ‘저장 안 함’

K_Retail_Sales_Demo의 변경 내용을 저장하시겠습니까?

에이전트는 디스크의 보고서 파일을 고쳤습니다. 열려 있던 창에서 ‘저장’을 누르면 예전 화면이 새 파일을 덮어쓰니, ‘저장 안 함’으로 닫고 .pbip를 다시 여세요.

STEP 3의 저장은 모델 변경을 파일에 남기는 단계이고, 여기서는 에이전트가 고친 보고서 파일을 지키는 단계입니다.

05
아이템 획득: 실습 프롬프트 플레이북 실습 파일명과 맞춘 프롬프트로 언제든 다시 해 볼 수 있습니다.
Chapter 06 · Cost & References

토큰 비용과 공식 문서

토큰 사용량은 대화 길이와 도구 실행, 캡처 검토 횟수에 따라 달라집니다. 실행 전 요금제와 사용 한도를 확인하세요.

COST · 실행 전 확인
요금제 확인
도구·모델·요금제에 따라 달라집니다.

API 과금은 모델별 입력·출력 요금을, 구독형 도구는 포함 사용량과 초과 과금 조건을 확인하세요.

다음에 확장해 볼 작업
  • Copilot CLI로 반복 명령 실행
  • 검증한 보고서를 Fabric 워크스페이스에 게시
  • Desktop 새로고침·캡처 자동화

공식 문서와 저장소

06
참고 자료 확인 완료 에필로그에서 핵심과 다음 한 걸음을 정리합니다.
Epilogue · 다음은 여러분의 데이터

만드는 일은 에이전트와,
판단하는 일은 우리와.

“보고서를 만들어 줘”에서 끝내지 않고,
“이 숫자가 왜 맞는지 보여줘”까지.

이번 실습에서 가져갈 한 가지
ROLES · 누가 무엇을 하나
사람 정하고 판단합니다
  • 업무 질문과 KPI 기준
  • 변경 내용 승인
  • 숫자와 화면 최종 확인
에이전트 만들고 확인합니다
  • DAX와 PBIR 작성
  • validate와 캡처 검수
  • 결과와 오류 보고
RECAP · 오늘 따라온 흐름
  1. 01연결 확인맞는 모델인지
  2. 02측정값 설계계산 기준 합의
  3. 03생성·검증검산 후 저장
  4. 04보고서·테마화면 만들고 확인
다음 한 걸음

업무 질문 하나, KPI 하나로 시작하세요

예: “어느 매장의 이익률이 낮아졌을까?”

  • 가상 데이터로 연결 → 설계 → 검증을 한 번 더 반복
  • 실제 데이터는 개인정보·회사 정책·AI 도구의 데이터 처리 조건부터 확인
  • 원본은 그대로 두고 별도 프로젝트에서 작업, 승인 전에는 게시하지 않기
함께해 주셔서 감사합니다.
GitHub Copilot Dev Days Seoul 2026 · Session 05
한결전자(K-Retail) 고객·매출 데이터는 교육용 가상 데이터입니다.