スキル

fabric-skills で Fabric ワークロードにつなぐ

アシスタントに Fabric のワークロードと API を理解させたい人向け。先に fabric-skills を入れ、Azure トークン確認を終え、本番ワークスペースはまだ変えない。

公式ソース · skills-for-fabric

インストール

/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 だと先に確認し、退役した3つの 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 は材料にない。出ていないインストールコマンドを補わない。「互換ツール」から特定クライアントの独占も推論しない。