用途:通过 az rest 只读调用 Fabric REST API,检查工作区中已有 Activator(/reflexes)的告警、通知和自动化动作,解析其规则、数据源与操作配置。
主要能力:列出工作区中的 Activator 项(支持分页与按文件夹过滤);获取单个 Activator 详情;调用 getDefinition 读取并 Base64 解码 ReflexEntities.json,用 jq 提取实体类型、数据源、规则、对象/属性、规则条件与 Fabric 项操作;针对 Power BI 源(powerBiSource-v1)解析存储查询与 metricDefinition,检查数据集/报表/页面/视觉对象/度量沿袭;激活历史需连接 Activator MCP 服务器调用 get_activations_for_rule。
使用方式:安装 az cli 与 jq,先按共享鉴权指引完成 az login。所有调用须带 --resource https://api.fabric.microsoft.com。getDefinition 为 POST,须带 --body '{}'(否则可能 411),可能返回 202 长运行操作,需轮询 Location 头;即使只读也需要 ReadWrite 权限范围。示例:az rest --method GET --url "https://api.fabric.microsoft.com/v1/workspaces/${WS_ID}/reflexes" --resource "https://api.fabric.microsoft.com" | jq '.value[] | {id, displayName, description}'。日常切换时首次使用需先运行 check-updates。
适用场景:审计 Activator 告警规则与自动化动作、梳理数据源与规则依赖、检查 Power BI 源一致性。
限制:本技能只读,写入需使用 activator-authoring-cli;工作区/项 ID 须动态解析,不可硬编码;加密敏感度标签的项定义无法读取;Power BI 源在禁用 PBI ALM 导出时 getDefinition 可能被拒,应报告限制而非臆测;激活历史不通过公共 REST API 提供,只能用 MCP;query.queryString 不接受语义模型查询文本。安装命令:winget install Microsoft.AzureCLI、winget install jqlang.jq。