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 项目：实体和关系类型、绑定、定义、沿袭、基础化和图遍历。

这是一个模式分派器，不包含任何操作步骤。请从下表中选择符合请求的模式，然后在执行任何命令之前，使用文件读取工具从头到尾阅读对应的 references/<mode>.md 文件。该文件包含端点、负载结构、模板和注意事项；未阅读就操作会导致负载和结果错误。

模式选择

模式	适用于请求……	示例触发词	首先阅读
authoring	创建或更新 Ontology 项目、实体／关系类型或数据绑定，并预览／确认定义变更	创建 ontology 项目，绑定实体类型，添加关系类型，更新 ontology 定义	references/authoring.md
consumption	探索现有 ontology：架构、实体类型、绑定、沿袭、基础化提取、图遍历、摘要	实体类型，基础化查询，ontology 沿袭，遍历图，汇总 ontology	references/consumption.md

模式边界规则

consumption 是只读探索。任何定义写入都必须通过 authoring 模式的预览并确认流程进行——绝不能在 consumption 请求中调用 updateDefinition。

如果请求确实涉及多个模式，请逐一处理，并在开始每部分工作前阅读相应的参考文件。如果阅读此表后仍无法确定模式，请提出一个简短的澄清问题，而不要猜测。

终结写入 — 绝不能跳过的步骤

阅读参考文件并规划变更并不代表任务已完成。每个会产生变更的模式都以一次改变状态的调用结束。如果你没有发出该调用，任何内容都不会被持久化——应明确说明这一点，而不是报告成功。

模式	终结写入
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 受众、shell 转义、令牌过期

规则

必须

• 开始任何操作前，必须从上表中恰好选择一种模式。
• 在执行该模式的第一条命令前，先从头到尾阅读 references/<mode>.md，并将其作为第一个工具调用。只读一次，并一次性完整阅读：不要重新打开、再次 grep 或翻页浏览。你已经读过了。
• 对加载的所有其他文件（包括嵌套的 references/<mode>/*.md 子参考文件和共享的 common/*.md 文件），也遵循只读一次的原则：只打开实际需要的文件，每个文件从头到尾阅读一次，之后不得再次 grep 或重新打开。
• 通过列出并筛选来解析工作区和项目 ID，绝不可猜测 GUID。
• 当请求跨越模式边界时，明确宣布切换模式。
• 将参考资料视为操作说明，而不是交付内容。阅读后，针对实时工作区运行文档中说明的命令，并报告实际结果。只引用参考资料内容而不执行命令，并不能回答请求。

优先

• 选择能够满足请求的最精简模式。
• 只读取一种模式的参考资料。仅当请求确实涉及多种模式时才读取第二种，并在此之前说明原因。
• 在第一条回复中说明所选模式，以便用户纠正。

避免

• 仅凭此调度器采取行动——它有意省略了操作细节。
• 用参考资料的摘要代替实际执行。
• 重新读取或再次 grep 已加载的参考资料；这会浪费轮次和令牌。
• 在只读模式下执行任何修改操作。
• 为此类工作加载其他技能（参见 CRITICAL NOTES 3）。

示例

用户请求	模式	要读取的参考资料
“Sales 本体中有哪些实体类型，它们如何绑定？”	consumption	references/consumption.md
“创建一个包含绑定到湖仓的 Customer 和 Order 实体类型的本体项目。”	authoring	references/authoring.md
“根据本体对这个问题进行依据验证，并展示图遍历过程。”	consumption	references/consumption.md