配置与管理
让智能体按计划推送分析报告
设置分析任务和执行时间,将报告定时发送到飞书或邮箱。
定时分析报告是智能体的自动化能力:系统按计划执行一段自然语言分析,把结论推到飞书群或邮箱,并留下运行记录和对应对话。飞书或 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 天,或任务已被删除 | 从最近一封报告里重新点;任务删了就无需退订 |
| 收件人收到报告但时间不对 | 报告里的时区跟预期不一致 | 项目负责人到用户设置里改时区,下一次执行即生效 |
下一步
- 让用户在消息工具里主动提问:接入飞书机器人 · 接入 Slack 机器人
- 需要随时打开看趋势和明细:数据看板
- 定时任务的会话和结论去哪里看:对话