automate

Superset Automate 用于把重复性工作转化为 Superset 自动化：把“我每天早上都要做 X”变成按计划执行 X 的自动化，或把“每个新 PR 都该有人看一眼”变成由事件触发的自动化。

用途与流程：

1. 理解任务：明确产出、执行频率、读取的输入以及“完成”的标准，然后把自动化提示词写成面向零上下文智能体的指令。若任务包含会演进的规则（如分诊标准、格式），应放入自动化在运行时读取的文档，以便修改规则而无需改动提示词。由于无人值守，产出为摘要、报告或评分卡的任务需要有落点：提示词结尾把报告写入 .html 文件并发布，用户打开一个链接即可，无需翻运行日志。示例：先写入 digest.html，再发布：superset pages publish digest.html --title "Nightly triage" --label "what changed today"。页面由工作区加路径标识，因此第 2 步选择的目标决定历史是否累积：项目目标每次运行创建新工作区，即每次运行生成新页面而非同一页面的新版本；需要累积历史的报告应使用工作区目标，或在首次运行捕获页面 id，之后在提示词中传入 --page <id>。

2. 选择目标：superset projects list 列出项目目标（每次运行新建工作区，适合大多数任务）；superset workspaces list --local 列出工作区目标（每次运行复用同一工作区，适合有状态任务）。

3. 选择触发方式：时钟或事件。应询问任务是“每天早上”这类计划，还是“每当有人做 X”这类事件触发。事件触发需先解析 id：范围（scope）存储的是提供商 id 而非名称，直接把频道名或仓库标题写进配置不会匹配任何内容。可用 superset automations trigger-options --group slack 查询；分组包括 slack、github、linear、sentry、notion、microsoftTeams、google（Gmail 标签与联系人）。结果为空含义不明确：可能是组织未连接该分组、令牌被撤销或提供商查询失败，应请用户在设置中检查连接，而不是断言未连接。随后把集合写入文件，每个过滤器都是一个范围：{"mode":"any"} 匹配全部，{"mode":"list","ids":[...]} 匹配指定 id，{"mode":"me"} 在运行时解析为自动化所有者在该提供商的账号。示例事件配置包含 kind、event、channels、emoji、actor 等范围字段。

4. 创建前确认：向用户展示名称、触发方式（RRULE，或事件及用自然语言描述的范围）、智能体、目标以及将要执行的确切命令；未获明确确认不得创建。

5. 创建与试运行：使用 superset automations create 命令，计划触发用 --rrule 与 --timezone，事件触发用 --triggers-file 替代；复用模式用 --workspace <id> 代替 --project，需要另一台机器运行时用 --host <id>；多行提示词优先用 --prompt-file。一个自动化可同时包含两类触发：把计划放入触发集合中与事件并列即可。之后修改触发器会替换整个集合：superset automations update <id> --triggers-file 会删除未包含的触发器；应先用 superset automations get <id> 读取当前集合，再带上各条目的 id 重新提交要保留的条目，以便原地更新而非重建；重建会轮换 webhook 签名密钥并重置计划的下次运行时间。写入后务必用 superset automations get <id> 检查 triggers 数组，不能仅凭命令退出码为 0 就报告触发器已设置成功。然后用 superset automations run <id> 立即触发首次运行，与用户一起查看 superset automations logs <id>，并通过 superset automations prompt set <id> 迭代提示词，直到运行输出正确；若提示词会发布页面，复查时应打开已发布页面而不只看运行日志。只有一次真实运行结果良好，自动化才算完成。

适用场景：周期性摘要、报告、评分卡、问题分诊，以及针对 Slack 反应、GitHub PR 等事件触发的自动响应。

限制：页面历史是否累积取决于目标类型；事件范围需使用 id 而非名称；空查询结果原因不明确；更新触发器为整体替换，重建有副作用；命令退出码 0 不代表触发器已生效。具体收费与平台信息暂未提供。