스킬

fabric-skills 로 Fabric 워크로드에 연결하기

어시스턴트가 Fabric 워크로드와 API를 이해하게 하려는 사람에게 맞다. 먼저 fabric-skills 를 설치하고 Azure 토큰 확인을 끝내며, 프로덕션 작업 영역은 먼저 바꾸지 마라.

Official source · skills-for-fabric

Install

/plugin install fabric-skills@fabric-collection

누구에게 맞나

코딩 어시스턴트가 Microsoft Fabric 워크로드, API, 쿼리 패턴, 운영 실무를 이해하게 하려는 사람에게 맞다. 공식 저장소는 https://github.com/microsoft/skills-for-fabric reusable AI assistant instructions 라고 적혀 있다. 주 패키지는 fabric-skills 이다. Power BI 보고서 작성은 따로 묶인다 된다. 옛 persona 패키지 fabric-authoring, fabric-consumption, fabric-operations 는 retired 이며 deprecated aliases 로만 fabric-skills 를 가리킨다. 새 설치는 fabric-skills 를 써야 한다.

대부분의 Fabric 작업에는 Azure 인증이 필요하다. 로그인하지 않았고 https://api.fabric.microsoft.com 용 토큰도 없다면 첫 시도를 프로덕션 작업 영역 변경으로 만들지 마라. 자료는 「compatible AI coding tools」를 제품 명단으로 펼치지 않는다.

3분 만에 첫 시도 끝내기

주 경로는 먼저 marketplace를 추가한 뒤 주 패키지를 설치한다.

/plugin marketplace add microsoft/skills-for-fabric
/plugin install fabric-skills@fabric-collection

전제 조건: 현재 에이전트 화면에서 /plugin 명령을 실행할 수 있고, 이 환경에 플러그인을 쓸 준비가 되어 있어야 한다. 다른 설치기는 자료에 없다. 부작용은 fabric-skills 가 설치되는 것이다. 실행 후 플러그인 이름이 fabric-skills@fabric-collection 인지 먼저 확인하고, 폐기된 세 persona id는 더 설치하지 마라.

저위험 작업: 신원 확인만 하고 리소스를 바꾸는 Fabric 작업은 호출하지 마라. 먼저:

az login
az account get-access-token --resource https://api.fabric.microsoft.com 

az login 은 로그인 흐름을 연다. 실행 전에 본인 Azure 계정인지 확인하라. 토큰을 받으면 멈춰라. 성공 신호는 주 패키지가 설치되어 있고 get-access-token 이 https://api.fabric.microsoft.com 에 대해 토큰을 반환하는 것이다. 이 단계에서 보고서를 게시하거나 작업 영역을 바꾸거나 Power BI 패키지를 설치하지 마라. 자료에 없는 시크릿 파일을 요구하면 즉시 멈춰라.

사용 사례

사례 1: 주 패키지를 설치하고 Azure 토큰 확인을 끝낸다. 대응은 fabric-skills@fabric-collection 와 Most Fabric operations require Azure authentication. 로그인이 되는지 아직 확인하지 않은 사람에게 맞다. 테넌트, 용량, 작업 영역 선택은 자료에 없다. 확인할 수 있는 것은 먼저 로그인하고 Fabric API용 토큰을 받는 것이다. 사례 1을 이미 작업 영역을 바꾼 이야기로 쓰지 마라.

사례 2: Power BI 보고서 작성이 필요할 때만 독립 패키지를 설치한다. 대응은 /plugin install powerbi-authoring@fabric-collection 이며 semantic models, Power BI report skills, PBIP workflows 를 다룬다. 주 패키지가 이미 있고 정말로 보고서 작성을 할 사람에게 맞다. PBIP 디렉터리 구조나 게시 대상은 자료에 없다. 확인할 수 있는 것은 이 경로가 주 패키지와 분리되어 있다는 점이다. 첫 시도에서 게시까지 넘지 마라.

사용 한계

새 설치에서는 fabric-authoring, fabric-consumption, fabric-operations 를 다시 쓰지 마라. 별칭일 뿐이며 기존 설치는 /plugin update 로 계속 동작할 수 있다. Power BI 작성은 주 패키지의 일부가 아니다. fabric-skills 를 넣었다고 보고서 스킬이 있다고 생각하지 마라. 토큰 resource는 https://api.fabric.microsoft.com 다른 resource는 자료에 없다. 나타나지 않은 설치 명령을 보태지 마라. 「호환 도구」에서 특정 클라이언트의 독점도 추론하지 마라.