1. 简介
1.1 功能简介
定时任务是 Agent 自动化能力的核心模块，支持为已配置的智能体添加周期性触发的后台任务，让 Agent 无需用户主动提问，即可自动执行数据汇总、报告生成、异常预警等操作，并通过多渠道推送结果至目标用户，实现业务分析从「被动问答」到「主动服务」的升级。
1.2 使用场景
日常数据定期归集整理，定向推送分发至对应业务及管理人员
自动生成日报、周报、月报、年报等各类周期性统计报表
实时监测数据异动，快速触发异常告警并完成消息推送
1.3 效果演示
以销售场景中，定时推送销售风险预警为例，效果如下所示：
1）推送至平台
2）推送至 IM 平台中个人聊天窗口，以企业微信为例
3）推送至 IM 平台中群聊窗口，以企业微信为例
1.4 版本
| Dora 版本 | 功能变动 |
|---|---|
| V0.6 | - |
| V1.5 |
|
2. 设置步骤
2.1 设置入口
定时任务支持通过以下两个入口进行配置：
2.1.1 管理后台（Agent 配置页面）
进入「管理后台>Agent 配置页>定时任务」模块，单击「+」按钮即可进入新建流程。
2.1.2 前台（Agent 使用界面）
在前台使用 Agent 时，单机左侧导航栏「定时任务」菜单项，进入当前 Agent 的定时任务管理页面。
2.2 创建定时任务
创建定时任务支持两种方式：从空白开始新建，或使用推荐模板新建。
2.2.1 从空白新建
从空白新建适用于有明确自定义需求的场景，所有配置项需手动填写。在「添加定时任务」对话框中，单击「从空白开始」卡片，进入任务配置表单
2.2.2 从模板新建
当前提供如下 2 种场景模板，模板已包含结构化的任务提示词和默认的执行频率，用户只需修改合适的模板内容，并补充触达用户与推送渠道后，即可完成创建：
经营周报
数据预警
2.3 任务配置项说明
任务配置项包含下表内容：
| 配置项 | 是否必填 | 说明 |
|---|---|---|
| 定时任务名称 | 必填 | 任务的标识名称，建议使用能清晰表达任务目的的名称，例如「门店销售分析日报」 |
| 任务提示词 | 必填 | Agent 执行任务时接收的完整指令，决定 Agent 的行为和输出内容。详见下方「提示词编写指南」 |
| 推送内容 | 必填 |
|
| 定时执行频率 | 必填 | 任务自动执行的时间周期和具体时间点 |
| 推送方式 | 必填 |
|
2.4 定时任务提示词编写指南
一条结构完整的提示词应包含任务目标、核心规则和输出要求三个部分。
| 定时任务提示词的结构模板 |
任务目标：[用一句话描述 Agent 需要完成的核心任务] 核心规则： 1、[规则一：明确 Agent 需要分析或处理的核心内容] 2、[规则二：明确 Agent 需要深入拆解或对比的维度] 3、[规则三：明确 Agent 需要识别或判断的方向] 输出要求： 1、标题：[规定输出内容的标题格式] 2、内容：[规定输出内容需要覆盖的范围] 3、语气：[规定输出内容的语言风格和表达方式] |
| 提示词示例：经营周报任务 |
| 任务目标：根据本周业务数据，生成周报，清晰呈现业务进展、核心问题与优化建议 核心规则： 1、核心指标复盘：本周【销售额】等核心指标的完成情况 2、重点业务分析：拆解Top3贡献渠道/区域/品类，分析增长/下滑的核心原因 3、风险与机会识别：识别本周业务中的潜在风险 输出要求： 1、标题：【XX业务线】经营周报 2、内容：呈现核心规则中的所有内容 3、语气：简洁专业，结论前置，数据支撑观点，避免冗余描述 |
2.5 推送内容
支持如下两种推送内容：
文本和附件：推送 Agent 生成的文本结果及相关附件
仅文本：只推送文本结果，不推送任务生成的附件
2.6 推送方式
2.6.1 推送至个人
1）操作步骤
选择目标用户，并为其选择一个或多个推送渠道，支持平台、钉钉、飞书、Lark、企业微信、Teams、Telegram、LINE。实际可选渠道取决于系统已完成的 IM 对接配置。
2）效果演示
以推送给企业微信个人为例，效果如下所示：
2.6.2 推送至群聊
支持将任务结果推送至飞书、钉钉或企业微信群聊，操作步骤如下：
1）打开「推送渠道>群聊」按钮，选择已经对接的 IM 工具平台；
2）选择 IM 平台中目标群聊，若列表中找不到群聊 ID，可复制页面指令，在目标企业微信群中 @机器人 发送指令获取，也可手动填写群聊 ID 和备注后添加。
3）效果演示
以推送至企业微信群聊为例，效果如下所示：
2.6.3 推送至Webhook
Webhook 推送当前仅支持飞书、钉钉和企业微信，可添加多个 Webhook 地址，将定时任务结果同时推送至不同目标。
外部系统 类型 | Webhook 来源 | 签名校验 | Dora 配置要求 |
|---|---|---|---|
| 飞书 | 飞书群自定义机器人 | 支持 | 若飞书侧已启用签名校验，Dora 侧也需开启并填写相同的签名密钥
|
| 钉钉 | 钉钉群自定义机器人 | 当前仅支持加签 | 若钉钉侧已启用加签，Dora 侧也需开启并填写 SEC 开头的密钥
|
| 企业微信 | 企业微信群消息推送 | 无需配置 | 填写 Webhook 地址即可 |
1）操作步骤
打开「推送渠道>Webhook」按钮，填写通过以下方式获取到的外部系统 Webhook 推送地址，并完成测试连接：
企业微信-群聊添加消息推送
飞书-群聊添加自定义机器人
钉钉-群聊添加自定义机器人
2）效果演示
以通过钉钉 Webhook 方式推送至钉钉群聊，效果如下所示：
3. 注意事项
1）定时任务依赖「对话订阅」技能实现，在配置定时任务的 Agent 中，需同时添加该技能。
2）支持在「管理后台>Agent 监管>定时任务」 中管理所有 Agent 的定时任务。
3）至少需要勾选一个渠道，否则任务执行结果无法送达用户。
4）使用企业微信推送前，需先在「对接 IM 工具」模块完成企业微信的对接配置，否则推送无法生效。
5）通过「管理后台（Agent配置页面）」添加的定时任务，会被标记为「Agent内配置」；通过「前台（Agent使用页面）」添加的定时任务，会被标记为「我添加的」。
6）Webhook 地址和签名密钥属于敏感凭证，请勿发布到公开文档、代码仓库或日志中。
7）修改或重置群机器人后，原 Webhook 地址或密钥可能失效，需要同步更新 Dora 中的配置。