用途:该技能专门管理 Fabric IQ Ontology 项,涵盖实体类型、关系类型、数据绑定、定义更新,以及架构、血缘、grounding 和图遍历。它属于 microsoft/skills-for-fabric 技能集,通过 api.fabric.microsoft.com 调用。
主要能力:分为两种模式。authoring 模式用于创建或更新 Ontology 项、实体/关系类型和数据绑定,并预览、确认定义变更;consumption 模式为只读探索,用于查看架构、实体类型、绑定、血缘、grounding 提取、图遍历和摘要。
使用方式:先按请求选择唯一模式,再用文件读取工具完整读取对应的 references/<mode>.md 文件,然后执行其中记录的命令。工作区和项 ID 需通过列出并过滤获得,不得猜测 GUID。authoring 的最终写入为 createItem(POST /v1/workspaces/{ws}/items)创建 Ontology,再 POST .../updateDefinition 持久化实体类型、关系和绑定;consumption 无写入。每次 api.fabric.microsoft.com 调用都必须携带 x-ms-fabric-skill: fabriciq-ontology-cli 头(az rest 使用 --headers "x-ms-fabric-skill=fabriciq-ontology-cli"),包括所有 LRO 轮询、fabric_lro 和重试。
适用场景:创建或更新 Ontology 定义、绑定实体类型、添加关系类型、查询实体类型、ground query、查看 Ontology 血缘、图遍历、生成 Ontology 摘要。
限制:consumption 为只读,任何定义写入必须走 authoring 的预览确认流程,不得在只读请求中调用 updateDefinition。若请求跨模式,需逐个处理并分别读取参考文件;模式不明确时应提出一个简短澄清问题。仅凭调度器本身无法操作,必须读取对应参考文件并实际执行命令。自然语言问答 Power BI 报表和仪表板应使用 fabriciq,针对语义模型的 DAX 应使用 semantic-model-cli。具体端点、载荷结构、模板和注意事项需查阅对应参考文件,本资料未提供完整细节。