fabriciq-ontology-cli

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

重要な注意事項

1. ワークスペース名からワークスペースの詳細（ID を含む）を調べるには、すべてのワークスペースを一覧表示してから、JMESPath フィルタリングを使用します。
2. ワークスペース ID、アイテムの種類、アイテム名からアイテムの詳細（ID を含む）を調べるには、そのワークスペース内で該当する種類のすべてのアイテムを一覧表示してから、JMESPath フィルタリングを使用します。
3. スキルの使い分け：Ontology アイテム自体には fabriciq-ontology-cli を使用します。Power BI レポートやダッシュボードに関する自然言語の質問には fabriciq を使用します。セマンティックモデルに対する DAX には semantic-model-cli を使用します。

Fabric IQ Ontology — CLI スキル

このスキルは、エンティティ型やリレーションシップ型、バインディング、定義、リネージ、グラウンディング、グラフの探索など、Fabric IQ Ontology アイテムを扱います。

これはモードディスパッチャーであり、手順は含まれていません。以下の表からリクエストに合ったモードを選び、コマンドを1つでも実行する前に、ファイル読み取りツールで該当する references/<mode>.md ファイルを最初から最後まで読んでください。そのファイルにはエンドポイント、ペイロードの形式、テンプレート、注意点が記載されています。読まずに操作すると、誤ったペイロードや結果につながります。

モードの選択

モード	リクエストの内容	例となるキーワード	最初に読むファイル
authoring	Ontology アイテム、エンティティ型／リレーションシップ型、またはデータバインディングを作成・更新する。または定義変更をプレビュー／確定する	ontology item を作成、エンティティ型をバインド、リレーションシップ型を追加、ontology の定義を更新	references/authoring.md
consumption	既存の ontology を探索する：スキーマ、エンティティ型、バインディング、リネージ、グラウンディング抽出、グラフ探索、要約	エンティティ型、ground query、ontology lineage、グラフを探索、ontology を要約	references/consumption.md

モード境界のルール

consumption は読み取り専用の探索です。定義の書き込みはすべて、authoring モードのプレビューと確認のフローで行ってください。consumption リクエストから updateDefinition を呼び出してはいけません。

リクエストが実際に複数のモードにまたがる場合は、各作業を個別に処理し、その作業を開始する前に該当するリファレンスを読んでください。この表を読んでもモードが判然としない場合は、推測せず、簡潔な確認質問を1つしてください。

最後の書き込み — 必ず実行する手順

リファレンスを読み、変更を計画しただけでは、タスクは完了していません。変更を伴う各モードでは、最後に状態を変更する呼び出しを1回実行します。これを実行していなければ、何も保存されていません。成功したと報告するのではなく、その旨を明示してください。

モード	最後の書き込み
authoring	createItem（POST /v1/workspaces/{ws}/items）で Ontology を作成し、続けて POST .../updateDefinition でエンティティ型、リレーションシップ、バインディングを保存します。プレビューした定義ツリーは保存済みではありません。
consumption	なし — このモードは読み取り専用です

タスクを完了したと報告する前に、最後の呼び出しが成功したことを確認してください。また、リファレンスに読み戻しの手順が記載されている場合は、変更が反映されたことを証明するために、成果物を読み戻してください。

共通の基本事項（すべてのモード）

最初にワークスペースとアイテムを特定してください。すべてのモードで必要です。

タスク	参照先	備考
Fabric のワークスペースとアイテムを探す	COMMON-CLI.md	必須 -- ワークスペースまたはアイテムの ID を特定する前に必ず読んでください
Fabric のトポロジと主な概念	COMMON-CORE.md	アイテムの種類、ワークスペース、容量
環境 URL	COMMON-CORE.md	ソブリン／非パブリッククラウドのホスト
認証とトークンの取得	COMMON-CORE.md	対象が間違っていると 401 が発生します。認証の問題があれば先に読んでください
認証の手順	COMMON-CLI.md	az login のフローとトークンの取得
コアのコントロールプレーン REST API	COMMON-CORE.md	ページネーション、LRO のポーリング、レート制限
注意事項とトラブルシューティング	COMMON-CLI.md	az rest の対象、シェルのエスケープ、トークンの有効期限

ルール

必須

• 何かを始める前に、上の表からモードを 1 つだけ選択してください。
• そのモードの最初のコマンドを実行する前に、最初のツール呼び出しで references/<mode>.md を最初から最後まで読んでください。1 回の完全な読み取りで 1 度だけ読みます。再度開いたり、もう一度 grep したり、ページ単位で読み進めたりしないでください。すでに内容を確認できます。
• ネストされた references/<mode>/*.md のサブリファレンスや共通の common/*.md ファイルなど、読み込むほかのすべてのファイルにも同じ「1 回だけ読む」ルールを適用してください。実際に必要なファイルだけを開き、各ファイルを最初から最後まで 1 回だけ読みます。すでに読み込んだファイルを grep したり、再度開いたりしないでください。
• ワークスペース ID とアイテム ID は、一覧を取得して絞り込んで特定してください。GUID を推測してはいけません。
• リクエストが境界をまたぐ場合は、モードの切り替えを明示してください。
• リファレンスは手順として扱い、成果物として扱わないでください。読み終えたら、記載されたコマンドを実際のワークスペースに対して実行し、実際の結果を報告してください。リファレンスの記述を引用するだけでは、リクエストへの回答になりません。

推奨

• リクエストを満たす最も範囲の狭いモードを選択してください。
• モードのリファレンスは 1 つだけ読むことを基本としてください。リクエストが本当に複数のモードにまたがる場合に限り、2 つ目を読み、その前に理由を伝えてください。
• 最初の応答で選択したモードを伝え、ユーザーが訂正できるようにしてください。

避けること

• このディスパッチャーだけを頼りに作業すること。運用上の詳細は意図的に省略されています。
• リファレンスの要約で回答すること。実際に作業を実行してください。
• すでに読み込んだリファレンスを再度読んだり、再び grep したりすること。ターンとトークンを無駄にします。
• 読み取り専用モードで変更を加えること。
• このファミリーがすでに担当する作業で別のスキルを読み込むこと（「重要な注意事項 3」を参照）。

例

ユーザーのリクエスト	モード	読むリファレンス
「Sales オントロジーにはどのようなエンティティ型があり、それらはどのようにバインドされていますか？」	consumption	references/consumption.md
「Customer と Order のエンティティ型を持ち、lakehouse にバインドされたオントロジーアイテムを作成してください。」	authoring	references/authoring.md
「この質問をオントロジーに基づいて解釈し、グラフのたどり方を示してください。」	consumption	references/consumption.md