# 让智能体按计划推送分析报告

设置分析任务和执行时间，将报告定时发送到飞书或邮箱。

定时分析报告是智能体的自动化能力：系统按计划执行一段自然语言分析，把结论推到飞书群或邮箱，并留下运行记录和对应对话。飞书或 Slack 频道用于用户主动提问、机器人回复；定时报告则按计划运行、单向推送结果。频道接入与定时报告的通知方式分别配置，接上 Slack 频道不会新增 Slack 定时推送方式。

## 开始前

- 权限：项目角色需要是「项目负责人」或「项目管理员」。
- 一个能独立回答问题的数据智能体，并且已经挂好数据源。
- 一个推送目标：飞书群机器人的 Webhook 地址，或一组邮件收件人。
- 想清楚分析要用的时间范围和口径，写进指令里。
- 入口：左侧主导航 → 「更多」 → 打开目标智能体 → 顶部标签「定时任务」。

## 操作步骤

**新建任务，先填核心四项**

「定时任务」标签的空态显示暂无定时任务，并提示创建定时任务、让智能体按计划自动运行并推送结果。点「新建定时任务」，弹出创建定时任务对话框。这一步只有四项：

| 字段 | 必填 | 说明                                               |
| -- | -- | ------------------------------------------------ |
| 名称 | 是  | 占位符举例是每日活跃用户分析，最多 255 个字符                        |
| 描述 | 否  | 占位符提示可以简短描述这个任务的用途，最多 1024 个字符                   |
| 指令 | 是  | 占位符提示告诉智能体要做什么，例如分析昨日订单并输出关键指标                   |
| 频率 | 是  | 预设「每 10 分钟」「每 30 分钟」「每小时」「每天」「每周」，选完后提示按当前设备时区生效 |

指令里写清时间范围、指标、分组维度和输出格式，周期结果才稳定。需要“和上周同期比”这类比较时，把数据截止时间也写明。

**补通知方式**

新建的任务默认是已停用，也没有通知方式。打开任务的详情/编辑表单，在通知方式里二选一：

- 「飞书 Webhook」：填 Webhook 地址，占位符是 `https://open.feishu.cn/open-apis/bot/v2/hook/...`。
- 「邮件」：在收件人里输入邮箱后回车，逐个加进列表。

还没选通知方式时，这里显示未配置通知。

**先手动触发一次，再启用**

保存后点「立即触发」跑一次，提示已入队、稍后在历史中查看。到「查看历史」里看这次的结果，确认结论和格式符合预期。

确认无误再打开启用开关。没有配通知方式就启用时，界面会提示需要先配置通知方式。

对已停用的任务点「立即触发」，会先弹出任务未启用的提示，说明确认后会先启用任务、再立即触发执行，确认按钮是「启用并触发」。

**看下次触发和运行历史**

任务列表项上显示下次触发时间；跑过一次之后还会显示上次触发时间。启用或改频率时，下次触发会重算到下一个未来时刻，不会立刻被扫到——要马上跑就用「立即触发」。

「查看历史」打开以任务名命名的运行历史，每条记录的状态是运行中、成功、执行失败、通知失败之一，没有记录时显示暂无运行记录。有结论的记录可以直接「查看对话」跳回那一次的会话。

**让收件人能退订**

邮件底部和飞书卡片末尾都带一个「取消订阅」入口，指向退订页。收件人点开先看到确认取消订阅的提问和所属智能体，确认后页面显示已取消订阅，任务随之变成已停用。链接失效时提示链接无效、需要从邮件或飞书消息中重新打开。

## 关键约束

| 项目       | 值或默认                                          | 在哪里改            |
| -------- | --------------------------------------------- | --------------- |
| 新建后的状态   | 已停用                                           | 任务详情/编辑表单里的启用开关 |
| 最小执行间隔   | 10 分钟                                         | 任务表单的频率         |
| 通知方式     | 默认未配置；启用前必须选一个                                | 任务详情/编辑表单       |
| 名称上限     | 255 个字符                                       | 任务表单            |
| 描述上限     | 1024 个字符                                      | 任务表单            |
| 时区       | cron 按 UTC 解释，编辑器按你当前设备时区换算                   | 任务表单的频率         |
| 报告语言与时区  | 取项目负责人的实时偏好，改完下一次执行即生效                        | 用户设置里的语言与时区     |
| 错过周期     | 不补跑历史时段，只对齐到下一个未来时刻                           | 无界面开关           |
| 飞书推送失败重试 | 指数退避、最多 4 次；只对限流和网络/5xx 重试，内容或签名错误立即失败        | 无界面开关           |
| 飞书卡片里的表格 | 报告最多 3 张 Markdown 表格（飞书卡片有 4 张上限）             | 在指令里约束输出        |
| 退订链接有效期  | 90 天                                          | 无界面开关           |
| 对话类型     | 定时任务生成的是 `scheduled` 类型会话，可在「所有对话」里按「定时任务」筛出来 | 无界面开关           |

## 出问题怎么判断

| 现象                             | 判定条件                   | 处理                                         |
| ------------------------------ | ---------------------- | ------------------------------------------ |
| 到点了没有任何推送                      | 运行历史里没有这一条记录，且下次触发时间不对 | 确认任务不是已停用；改过频率或刚启用时下次触发会被重算到下一个未来时刻        |
| 历史里状态是执行失败                     | 这一条记录没有结论，只有失败状态       | 先在网页「对话」里用同一个问题复现，再查数据源和模型组                |
| 历史里状态是通知失败                     | 记录里有结论，但收件人没收到         | 检查 Webhook 地址或收件人是否有效、SMTP 是否可用；飞书群机器人是否还在 |
| 点启用开关时提示需要先配置通知方式              | 通知方式还是未配置通知            | 先选「飞书 Webhook」或「邮件」并填好，再启用                 |
| 停用期间错过的几次没有补发                  | 运行历史里那几段时间是空的          | 这是预期行为，不会补跑历史周期；要立刻验证用「立即触发」               |
| 飞书推送报表格数量超限                    | 报告里的 Markdown 表格超过 3 张 | 在指令里要求“最多输出 3 张表格，其余用要点列出”                 |
| 收件人点退订链接提示链接无效、需要从邮件或飞书消息中重新打开 | 链接超过 90 天，或任务已被删除      | 从最近一封报告里重新点；任务删了就无需退订                      |
| 收件人收到报告但时间不对                   | 报告里的时区跟预期不一致           | 项目负责人到用户设置里改时区，下一次执行即生效                    |

## 下一步

- 让用户在消息工具里主动提问：[接入飞书机器人](https://docs.asktable.com/integrations/feishu) · [接入 Slack 机器人](https://docs.asktable.com/integrations/slack)
- 需要随时打开看趋势和明细：[数据看板](https://docs.asktable.com/dashboard)
- 定时任务的会话和结论去哪里看：[对话](https://docs.asktable.com/conversation)