SuperAPI AI 工具集

activator-cli

编程与开发

查看项目

更新于 10-16 00:31

技能介绍

用途:该技能专门处理 Fabric Activator / Reflex 项,包括编写告警规则与检查已有告警,涵盖规则的源、条件和动作,以及承载这些内容的 ReflexEntities.json 定义。它本身是模式分发器,不包含具体流程,需先按下表选择模式,再用文件读取工具完整读取对应 references/<mode>.md 文件,然后才执行命令;否则会生成无效的 ReflexEntities.json 载荷并返回 400。

主要能力:authoring 模式用于创建、更新、配置或删除 Activator 项、规则、源与动作(例如“创建告警”“温度超过 30 时在 Teams 通知我”“删除错误流水线邮件告警”);consumption 模式用于列出、检查、解码或解释已有 Activator、规则、源与动作(如“显示所有告警”“解码该 Reflex 定义”)。consumption 为只读,任何写操作都属于 authoring。

使用方式:先动态解析工作区与 Activator 项(通过列出并用 JMESPath 过滤,不猜测 GUID)。所有 az rest 调用必须带 --resource https://api.fabric.microsoft.com,否则 401;且每次 api.fabric.microsoft.com 调用都须携带 x-ms-fabric-skill: activator-cli 头(含 LRO 轮询与重试)。getDefinition 须用 POST 且 --body '{}',再 Base64 解码 ReflexEntities.json 部分。返回 202 时轮询 Location 头。authoring 的终结写操作是:POST /v1/workspaces/{ws}/reflexes 创建、POST /v1/workspaces/{ws}/reflexes/{id}/updateDefinition 持久化、DELETE /v1/workspaces/{ws}/reflexes/{id} 删除;仅构建或编码 JSON 不算完成。

适用场景与限制:authoring 前须通过源校验门,确认源真实存在、字段存在且有代表性数据行;源缺失时应停止并询问,不得强行写入。建议采用读-改-写方式,优先使用基于状态转换的检测器。该技能不负责告警上游的流式拓扑(属 eventstream-cli)与其背后的 KQL 数据库(属 eventhouse-cli);Power BI 报告问题属 fabriciq。Power BI 源存在 ALM 导出可能拒绝已成功导入产物的例外,读回为空或不可用不代表写入失败,应分别报告。具体实体 schema、模板与更多细节需读取对应模式参考文件;本资料未提供价格与平台信息。