SuperAPI AI 工具集

project-osmos

数据与分析

查看项目

更新于 10-16 06:47

技能介绍

用途:当用户希望端到端解决复杂的 Fabric/OneLake 数据工程工作流时使用本技能,交由 Project Osmos 自主执行。主要能力包括检查数据、编写并运行 Spark、转换或修改表、产出笔记本或结果,并通过长时运行的自主代理持续推进。它支持任务状态查询、消息、后续跟进、取消与删除等操作,且任务为远程服务任务,不使用本地后台代理列表来判断状态。

使用方式与关键约束:面向公共生产环境,先用 Microsoft Fabric Skills 将工作区名称、Lakehouse 名称解析为 ID;找不到时用 search-consumption-cli(item type 为 Lakehouse)。遇到多个匹配项必须让用户选择,不得猜测。每次调用 api.fabric.microsoft.com 必须带 x-ms-fabric-skill: project-osmos 请求头(az rest 用 --headers "x-ms-fabric-skill=project-osmos"),包括每次 LRO 轮询、fabric_lro 与重试;示例片段未含该头也需补上。用户应提供完整成果目标,任务应作为单一 Osmos 任务下发,不要预先拆分。本地代理路径下可使用 GitHub Copilot CLI 安装技能 marketplace:/plugin marketplace add microsoft/skills-for-fabric 与 /plugin install fabric-skills@fabric-collection。

限制:在 Microsoft Fabric 中运行的 Copilot 当前不支持 Project Osmos 交互,须改用本地代理,且此时不得调用 Project Osmos、MWC、SparkCore 或 Fabric API。删除任务不可恢复,需精确重输任务 ID;取消仅停止当前运行。Lakehouse ID 只是 Spark 会话的默认湖仓,不自动构成数据源或范围边界。令牌、租户、工作区与湖仓 ID 属敏感运行数据。行数与变更数须以消息流中实际的 count()/SQL 输出为准。若发布工作区文件夹工件失败须显式报错,不得静默回退到 Lakehouse Files。