跳到正文
AskTable

文档反馈

当前页面定时分析报告/integrations/scheduled-reports

0 / 5,000

反馈将发送给维护团队。

前往控制台
前往控制台

配置与管理

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

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

定时分析报告是智能体的自动化能力:系统按计划执行一段自然语言分析,把结论推到飞书群或邮箱,并留下运行记录和对应对话。飞书或 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 天,或任务已被删除从最近一封报告里重新点;任务删了就无需退订
收件人收到报告但时间不对报告里的时区跟预期不一致项目负责人到用户设置里改时区,下一次执行即生效

下一步