automation

自动报告与渠道推送

Dashloom 可以把五类分析 Agent 的结果生成为即时或定期报告。每份报告都关联唯一的分析运行，因此摘要、结论、模型用量和冻结证据可以一起审计。

Dashloom 可以把五类分析 Agent 的结果生成为即时或定期报告。每份报告都关联唯一的分析运行，因此摘要、结论、模型用量和冻结证据可以一起审计。

主动 Agent 告警

报告页面可以监控任意标准化指标的数值阈值或每日变化百分比。命中判断本身是确定性的，并遵守可配置的冷却时间；每次命中都会创建可审计的报告记录。

每条规则可以选择五类专业 Agent 之一。Dashloom 会在该规则的产品范围内检查模型和证据准备度，只在确定性规则命中后消耗工作空间的正常 AI 额度，并把解释锁定在同一范围。如果模型、额度或分析失败，原始告警仍然有效且可以推送；运行历史只展示稳定的 Agent 状态与公开错误码，不保存 Provider 的原始错误信息。

所选渠道复用加密且带 SSRF 防护的推送链路。渠道明确返回失败时会被视为告警推送失败，并在后续评估中重试，不会被误报为成功。告警规则支持暂停与恢复；恢复时会重新检查渠道和 Agent 准备度。

生成报告

  1. 连接并同步至少一个数据源。
  2. 在 Agent 或 Settings 中配置并校验 AI Provider。
  3. 进入 Reports，选择全部产品或一个真实产品，再选择 Agent 和报告周期并点击 Generate report。

Dashloom 会针对每一个“产品范围 + Agent”组合判断近期自有与竞品证据准备度。所选范围缺少支持证据的分析师会被标注并禁用。API 会校验产品属于当前工作空间，并把范围同时冻结进 Agent 运行与报告历史。

社区版使用用户自己的 Provider Key。托管模型按工作空间套餐在服务端扣减每日额度，并在成功调用后写入不可变的用量事件。

配置推送渠道

Slack 和 Discord 使用 Incoming Webhook。Telegram 使用 Bot Token 和数字 Chat ID；Dashloom 会固定构造 api.telegram.org 地址并发送有长度限制的 sendMessage 请求。通用 Webhook 会收到 dashloom.report.ready JSON 事件。邮件渠道使用能接收 to、subject、text 的 HTTPS 邮件中继 Webhook，因此不会绑定单一邮件服务商。

渠道配置会被加密。URL 必须使用 HTTPS，且不能指向回环、私网、链路本地、元数据或保留地址。同一报告和渠道只有一条推送台账；已成功推送的任务不会重复发送，失败重试会累计次数。

创建定期报告

配置日报、周报或月报时，需要选择全产品或真实单产品范围、IANA 时区、本地执行小时、可选渠道，以及单个专项 Agent 或包含 2—5 个 Agent 的 Executive Brief。范围会在服务端持久化，并被每个 Agent 与每次重试沿用。删除产品会清理其未来计划，而不是把计划悄悄扩大到整个工作空间；历史报告和简报仍保留“原来是产品范围”的事实。每次计划运行以“计划 ID + 计划时间”为幂等键，重试时不会重复生成报告。

每个计划都会展示最近执行时间、运行状态、稳定错误分类和连续失败次数。Owner 与 Admin 可以暂停、恢复或删除计划，已生成的历史报告不会随计划删除。失败任务会冻结原始 occurrence 标识，从 15 分钟开始对同一份报告进行有上限的指数退避，最长等待 6 小时；因此推送重试不会再次消耗模型调用。Provider 与推送服务返回的原始错误不会写入计划健康状态或自动化摘要。任一计划失败时，外层 Cron 任务也会被标记为失败，不会出现自动化台账假成功。恢复计划前会重新校验证据与模型准备度，再计算下一次执行时间。

Agent 的对比窗口会与报告周期严格一致：日报比较最近一个完整日与此前一日，周报比较最近完整的 7 天与此前 7 天，月报比较最近完整的 30 天与此前 30 天。使用已结束周期可以避免把当天几个小时的数据与完整历史周期直接比较。冻结证据会保存具体日期。如果数据量超过有界读取上限，运行会被标记为不完整，经过校验的 Agent 输出必须披露仅覆盖部分数据。

从旧版本升级后，应先执行一次同步，让已连接数据源补齐完整的月度对比窗口，再生成第一份月报。

定时事件会直接执行任务，但仍应配置下面的独立密钥，用于保护维护接口：

npx wrangler secret put REPORT_CRON_SECRET

使用其他调度器的自托管用户，可以请求 POST /api/cron/reports，并携带 Authorization: Bearer <REPORT_CRON_SECRET>。

生产部署前，必须远程应用并验证所有 D1 迁移：确认 report_schedules、reports 和 agent_executive_briefs 均包含 scope_mode 与 product_id，核对产品外键删除行为和范围索引，并确认没有待执行迁移。