用途:在 CLI 中只读探索 Fabric IQ Ontology(预览版)项目,为智能体在查询数据前建立接地上下文。流程为获取定义、解码、解析、接地、委派。
主要能力:枚举实体类型、属性、键与显示名;枚举数据绑定(来源类型、目标项、属性映射、时间戳列);枚举关系类型与上下文化;生成面向 LLM 的接地 JSON;解码完整定义树用于比对或审阅。本体定义以 JSON 文件树形式存放于项目定义中,Get Item Definition 返回 base64 编码的 parts。
使用方式:需先解析工作区 ID 与本体项目 ID,再获取定义。Get Item Definition 为长时运行操作,可能返回 200 内联或 202 加 x-ms-operation-id;对 202 轮询 https://api.fabric.microsoft.com/v1/operations/{operationId} 直至 Succeeded,再取 result 得到 parts[]。预览版建议轮询 operations/{id} 而非 Location 头。控制面令牌受众为 https://api.fabric.microsoft.com。
查询路由:LakehouseTable 非时序默认委派 sqldw-consumption-cli,显式要求 PySpark 时用 spark-consumption-cli;KustoTable 时序委派 eventhouse-consumption-cli;KustoTable 非时序在预览版无效,应拒绝并提示绑定错误;关系上下文化默认走 sqldw-consumption-cli。组合查询前须将本体属性名翻译为 propertyBindings[].sourceColumnName,并传入全部复合键。
限制:本技能只读,不创建或更新定义,架构变更需委派 fabriciq-ontology-authoring-cli;不直接查询源数据;投影尚未 GA,所有数据读取均针对源表;Warehouse 绑定未在共享架构中记录,遇到应提示用户;每次会话首次使用需先运行 check-updates。本体为预览版,线格式与限制可能变化。