SuperAPI AI 工具集

activator-authoring-cli

部署与运维

查看项目

更新于 10-16 00:31

技能介绍

用途:这是一个面向 Fabric Activator 的 CLI 编写(authoring)技能,用 Fabric REST API 与 az rest 命令行完成写入操作,如创建或删除 Reflex 项、新增或更新规则。

主要能力:解析工作区与项 ID;获取 Fabric 访问令牌;通过 /v1/workspaces/{workspaceId}/reflexes 等端点做项的新建、元数据更新(PATCH)、删除(可加 ?hardDelete=true)与 getDefinition/updateDefinition;处理 202 长时运行操作(LRO)轮询;以 Base64 编码的 ReflexEntities.json 组装实体图。

使用方式:先按共享文档完成认证与 ID 解析;getDefinition 为 POST、需 ReadWrite 权限且可能返回 202,需用 fabric_lro 轮询后再解码;规则经“获取、解码、修改、重编码、更新”流程维护。构建 ReflexEntities.json 时必须使用 Python 的 json.dumps(),避免 PowerShell ConvertTo-Json 破坏嵌套 JSON 字符串;az rest 需传 --resource https://api.fabric.microsoft.com。实体图包含容器 container-v1、数据源、timeSeriesView-v1 视图(SourceEvent、Rule 等),并按 AttributeTrigger 或 EventTrigger 选择不同模板;每条规则实例需为 JSON 字符串且各步骤有 GUID。更新前做引用完整性检查。

适用场景:KQL、Eventstream、Digital Twin Builder/本体、实时中心和 Power BI 等数据源的 Activator 规则编写,以及 TeamsMessage、EmailMessage、FabricItemInvocation 等动作配置。

限制:要求相应权限范围;多个接口可能返回 202 LRO;Eventstream 源需先建接收器再回读;Power BI 源需匹配载荷类型并遇导入错误即停止;模板版本、entity 连线错误(如 FailedToResolveEntity)需按资料规则处理。其他价格与平台等信息暂未提供。