powerbi-report-cli

テレメトリ — 必須。 すべての api.fabric.microsoft.com 呼び出しには、 x-ms-fabric-skill: powerbi-report-cli を含める必要があります（az rest の場合は --headers "x-ms-fabric-skill=powerbi-report-cli"）。 すべての LRO ポーリング、fabric_lro、リトライにも適用されます。スニペットでは省略されていますが、必ず追加してください。

重要な注意事項

1. ワークスペース名から ID を含むワークスペースの詳細を調べるには、すべてのワークスペースを一覧表示してから、JMESPath でフィルタリングします。
2. ワークスペース ID、アイテムの種類、アイテム名から ID を含むアイテムの詳細を調べるには、そのワークスペース内の該当する種類のアイテムをすべて一覧表示してから、JMESPath でフィルタリングします。
3. レポート成果物の要件、デザイン、PBIR/PBIP のページやビジュアルの編集、プレビュー、公開には powerbi-report-cli を使用します。セマンティックモデル、メジャー、DAX に関する作業には、セマンティックモデルのスキルを使用します。レポートデータに関する自然言語の質問には fabriciq を使用します。

Power BI Reports - CLI スキル

このスキルでは、要件と範囲の策定、ビジュアルデザイン、ローカルでの PBIR/PBIP の作成とプレビュー、Microsoft Fabric とのレポートアイテムの送受信まで、Power BI レポートのライフサイクル全体を扱います。

これはモードディスパッチャーであり、意図的に詳細な手順は含めていません。依頼に合ったモードを選択し、作業を始める前に、対応するモードのリファレンスを最初から最後まで読んでください。モードファイルには、必要なワークフロー、コマンド、ペイロード、テンプレート、失敗時のルールが記載されています。

モードの選択

モード	依頼の内容	既存のルートの例	最初に読むファイル
planning	新しいレポート／ダッシュボードを作成し、要件、モデル／依存関係の調査、範囲、ページ計画、実装前の承認が必要	レポートを作成する、ダッシュボードを構築する、セマンティックモデルから作成する、計画してから実装する、レポートの作成を案内する	references/planning.md、次に references/planning-part-02.md
design	レポートの外観を決める：トーン、特徴、ページの類型、グラフの種類、レイアウト、色、タイポグラフィ、テーマの方向性、アクセシビリティ、ブランドの適用、再デザイン、評価	Power BI レポートをデザインする、ダッシュボードをプロフェッショナルな見た目にする、グラフを選ぶ、ブランドを適用する、レポートを再デザインする、デザインブリーフを作成する	references/design.md
authoring	ローカルの PBIR/PBIP ファイルを読み取る／編集する、検証する、レポートをプレビューする、スクリーンショットを撮影する	PBIR を編集する、レポートのページやビジュアルを作成／追加する、ビジュアルを整形する、フィルター／スライサー／ブックマーク／テーマを追加する、PBIR を検証する、Desktop またはサービスでプレビュー／再読み込み／スクリーンショットを撮影する	references/authoring.md
management	レポート定義を Fabric との間で移動する、またはワークスペースのレポートアイテムを管理する	PBIR または PBIP を公開／アップロード／ダウンロードする、レポートを一覧表示する、レポートを取得／更新／削除する、レポートを再バインドする	references/management.md

モードの境界ルール

• 開いているファイルやツールではなく、意図に基づいて分類します。
• designではレポートの見た目を決め、authoringではそれを実現するPBIRを作成します。グラフの種類を選ぶのはdesign、それをvisual.jsonに記述するのはauthoringです。
• 既存のローカルレポートのスタイル変更や書式変更は、依頼にデザインに関する表現が使われていてもauthoringです。ファイルを変更せず、アドバイスやデザイン仕様を求めている場合はdesignを使います。
• authoringではローカルファイルを変更し、プレビューや検証を行います。Fabricへの公開は行いません。
• managementでは定義を転送し、Fabricのレポート項目を管理します。PBIRコンテンツを新たに考案したり、直接作成したりはしません。
• 新しいレポートに関する要件から承認までのガイド付きフローはplanningが担当します。既存レポートの一部を編集する場合は、直接authoringに進みます。

新規作成の依頼では、次の順序で複数のモードにまたがることがあります。

planning -> design -> authoring -> management

一度に扱うモードは1つにします。モードを切り替えるたびにその旨を伝え、作業を始める前に新しいモードのリファレンスを読みます。planningの承認ゲートはターンの境界です。後続の返信でユーザーが確定した仕様を明示的に承認するまで、作成も公開も行ってはいけません。

新規作成の承認バリア — 必須。 新しいレポートの依頼で計画、作成、および／または公開が求められていても、過去の返信で確定した仕様が承認されていない場合は、現在のフェーズをapproval_pendingに設定し、planningだけを有効なモードとして維持します。このフェーズでは、authoringやmanagementを読み込んだり、PBIRやセマンティックモデルのファイルを編集・ひな形作成したり、合成データを生成したり、Fabricの書き込みAPIを呼び出したり、公開したりしてはいけません。_brief/report-spec.mdに仕様を保存し、明示的な承認を求めてターンを終了します。元の依頼に含まれる作成／公開の指示は、将来的に希望する作業範囲を示すものであり、このバリアを越える承認ではありません。

モードごとの必須成果物

モード	完了要件
planning	_brief/report-spec.mdまたはユーザーが指定した同等のファイルに保存し、明示的な承認を求めて、実装に進む前に停止します。
design	design_identityと、すべてのページのページアーキタイプ／レイアウト仕様を含む、完全なDesign Brief:仕様を作成します。PBIRの編集やFabric APIの呼び出しは行いません。
authoring	要求されたPBIR／PBIPの変更を保存し、論理的な変更バッチごとに検証した後、authoringリファレンスで指定されたプレビューとスクリーンショット確認のワークフローを完了します。公開は行いません。
management	LROのポーリングと、文書化された読み戻し検証を含め、要求されたFabricレポート操作を完了します。

ルール

MUST

• 現在のリクエストを完全にカバーする、最も範囲の狭いモードを選択します。
• そのモードで最初のコマンドを実行する、または最初のファイルを編集する前に、references/<mode>.md を最初から最後まで読みます。すでに読み込まれたモードが、限定的なクロスモード操作を特定のトピックリファレンスに明示的に委ねている場合、そのトピックリファレンスを完全な引き継ぎ先として扱います。その操作を超えて作業が広がらない限り、対象モードの包括ファイルは読み込まないでください。
• planning モードでは、_brief/report-spec.md を作成する前に references/planning-part-02.md も読みます。ここには、必須の標準設計契約と承認チェックが記載されています。
• 複数ターンにわたるタスクでは、解決済みのワークスペース／アイテム／モデル ID、ローカルパスとダウンロード先のパス、すでに読んだリファレンスを含む、簡潔な作業状態を保持します。ユーザーが明示的に新たな照会を求めた場合、または直前の操作によって値が無効になった場合を除き、後続ターンでも再利用します。
• 選択したモードに記載されたすべての引数と安全上の境界を守ります。
• リクエストが境界をまたぐ場合は、明示的にモードを切り替えることを伝え、実際に切り替えます。
• PBIR のスキーマ、ロール、書式プロパティ、セレクター、列挙値を推測するのではなく、powerbi-report-author CLI のメタデータと検証機能を使用します。
• ユーザーが公開を明示的に依頼しない限り、ローカルの編集はローカルに留めます。
• Fabric のワークスペース ID とアイテム ID は、一覧を取得して絞り込むことで解決します。識別子を推測してはいけません。
• ユーザーが求めた成果物を作成します。リファレンスを読んだり要約したりするだけでは、タスクを完了したことになりません。

PREFER

• プロンプト、セマンティックモデル、既存の PBIP、または以前に承認された仕様にすでに含まれている事実は、再度尋ねずに推定します。
• 選択したモードと、それに直接関係するトピックリファレンスのみを読み込みます。
• 現在のタスクですでに読み込まれたリファレンスのガイダンスを再利用します。新しいリファレンスを開くのは、依頼された操作または確認された不一致によって必要になった場合に限ります。
• 選択したモードで明示的に変更が必要とされている場合を除き、ユーザーの既存のプロジェクト構造、スキーマ、ホスト、操作、バインディング、成果物の納品先を維持します。

AVOID

• 選択したモードのリファレンスを読まずに、このディスパッチャーの指示だけで作業すること。
• 会話が後続ターンに進んだという理由だけで、このディスパッチャー、モードファイル、または現在のタスクですでに読んだトピックリファレンスを再読み込みすること。
• 廃止された兄弟スキル名を読み込むこと。planning、design、authoring、management は、このスキルのモードです。
• planning または design で PBIR を編集したり Fabric API を呼び出したりすること。
• authoring で公開したり、management で PBIR コンテンツを作成したりすること。
• 元のリクエストに作成や公開も含まれていることを理由に、planning の承認ゲートを迂回すること。

Complete Reference Index

関連するリファレンスは、すべてこのインデックスから直接開いてください。part-XX という名前のファイルは、同じトピックの続きです。

Authoring

• authoring/authoring-workflows
• authoring/bookmark
• authoring/button-part-02
• authoring/button-part-03
• authoring/button
• authoring/card-part-02
• authoring/card-part-03
• authoring/card
• authoring/cartesian-part-02
• authoring/cartesian-part-03
• authoring/cartesian-part-04
• authoring/cartesian
• authoring/color-strategy
• authoring/conditional-formatting-part-02
• authoring/conditional-formatting-part-03
• authoring/conditional-formatting-part-04
• authoring/conditional-formatting-part-05
• authoring/conditional-formatting-part-06
• authoring/conditional-formatting-part-07
• authoring/conditional-formatting
• authoring/custom-visuals
• authoring/expressions
• authoring/field-parameters
• authoring/filter-pane
• authoring/filters
• authoring/formatting-overview
• authoring/formatting-part-02
• authoring/formatting
• authoring/image
• authoring/kpi
• authoring/map
• authoring/model-binding
• authoring/page-formatting
• authoring/powerbi-desktop
• authoring/powerbi-report-author-cli-part-02
• authoring/powerbi-report-author-cli
• authoring/preview-part-02
• authoring/preview-part-03
• authoring/preview-part-04
• authoring/preview
• authoring/re-theming-part-02
• authoring/re-theming-part-03
• authoring/re-theming
• authoring/screenshot-review
• authoring/shape
• authoring/slicers-part-02
• authoring/slicers
• authoring/table
• authoring/textbox
• authoring/theming-part-02
• authoring/theming
• authoring/version-control

デザイン

• design/accessibility
• design/anti-patterns
• design/archetype-composition
• design/archetypes/analytical-canvas
• design/archetypes/comparative-benchmark-part-02
• design/archetypes/comparative-benchmark
• design/archetypes/executive-summary
• design/archetypes/narrative-story
• design/archetypes/operational-monitor
• design/brownfield
• design/chart-selection
• design/color
• design/design-brief-part-02
• design/design-brief
• design/interactivity
• design/layout
• design/pre-flight-checklist
• design/signatures
• design/tone-catalog
• design/typography
• design/visual-cookbook-part-02
• design/visual-cookbook

モードガイド

• authoring-part-02
• authoring-part-03
• authoring-part-04
• authoring
• design
• management-part-02
• management-part-03
• management-part-04
• management
• planning-part-02
• planning

例

ユーザーリクエスト	モード
「このセマンティックモデルから新しいエグゼクティブレポートを作成してください。」	planning
「運用ページをデザインし、適切なグラフを選択してください。」	design
「この PBIP に KPI ページを追加し、検証して、スクリーンショットを撮ってください。」	authoring
「このローカル PBIP を自分の Fabric ワークスペースに公開し、再バインドしてください。」	management

ルート互換性

統合されたスキルは、従来の 4 つのルートサーフェスを維持しています。以下のフレーズは、対応するモードの明示的なエイリアスとして扱ってください。

モード	維持されるルートフレーズ
planning	レポートを作成する; レポートを構築する; ダッシュボードを作成する; ゼロから新しいレポートを作成する; セマンティックモデルまたはデータセットのリンクからレポートを作成する; このモデル用のレポートを構築する; ダッシュボードを作ってください; 計画してから実装する; レポート作成を順を追って案内してください
design	Power BI レポートをデザインする; ダッシュボードをプロフェッショナルに見せる; グラフの種類を選択する; レポートにブランドを適用する; レポートを再デザインする; デザインブリーフを作成する; Power BI レポートのデザインアーキタイプ
authoring	PBIR を編集する; Power BI レポートページを作成する; PBIP にビジュアルを追加する; レポートのビジュアルを書式設定する; Power BI レポートを検証する; Power BI レポートをプレビューする; Power BI Desktop のプレビュー状況; サービスでレポートをプレビューする; ブラウザーでレポートをプレビューする; レポートページのスクリーンショットを撮る; すべてのレポートページのスクリーンショットを撮る; プレビューホストを一覧表示する; PBIP でダッシュボードを実装する; レポートにダッシュボードのビジュアルを追加する; 承認された PBIP レポート仕様を実装する; PBIR のページ/ビジュアルを編集する; Power BI レポートを編集する
management	PBIR レポート定義をアップロードする; Power BI レポートをアップロードする; PBIR 定義をダウンロードする; PBIR 定義を公開する; Power BI レポートを Fabric に公開する; Power BI レポートを管理する; ワークスペースのレポートを一覧表示する