# 定时任务与主动跟进

安排重复工作、核对时区和运行记录，并处理等待审批的任务。

## 先分清要自动做什么

定时任务按时间运行一项明确工作；主动跟进在单聊中继续值得回访的话题；Goal 持续推进一个有完成标准的目标。

| 需求 | 使用功能 |
| --- | --- |
| 每周五生成一份周报 | 定时任务 |
| 在原单聊中适时回访未完事项 | 主动跟进 |
| 持续完成一项有验收标准的工作 | [Goal](/docs/goals) |
| 重复一套检查和改进步骤 | [工作循环](/docs/work-loops) |

本文用“从工作记录生成日报”演示定时任务。先完成手动验证，再安排周期运行。

## 先验证输入与输出

准备一份教学记录，放在目标 Agent 能读取的工作区。Web 版的工作区在服务器，电脑上的文件需要先上传或放入服务器可访问的位置。

```text
请读取工作区中的 daily-notes.md，生成 daily-report.md。
按完成事项、风险、待确认问题整理，每条注明原文依据。
原文未写出的进展不要补充。没有新材料时在报告中说明。
```

打开 `daily-report.md`，核对是否引用正确材料、未知项是否保留。只有这一步通过，才把同样的要求放进定时任务。

## 创建任务并选择执行者

打开 **能力 → 定时任务** 的创建入口。填写任务名称，例如“每日工作记录汇总”，再填写验证过的指令。名称用于识别，指令需要写出真实路径、处理范围和交付文件。

![真实 App 的定时任务创建表单](/images/docs/scheduled-task.png)

选择 Agent 独立处理，或选择 Room 及其执行成员。需要读取已讨论内容时复用会话；每次从材料重新整理时用独立运行。完整差异见[运行上下文参考](/docs/schedule-reference)。

不要在独立运行的指令里只写“继续刚才的要求”，因为它不会依赖原聊天的全部历史。

## 设置时间与结果位置

以工作日 18 时生成日报为例，选择每天，时间设为 18 时，执行日选周一至周五，时区选 `Asia/Shanghai`。也可以使用 Cron `0 18 * * 1-5`。

需要在另一个会话查看结果时，选择发送到指定位置，并核对接收对象。不额外发送时，结果留在运行记录。任务输出文件与消息通知是两种产物，通知缺失时先检查文件是否已经生成。

保存后查看下次执行时间、启用状态与结果位置。若日期偏移，先检查任务时区，不要改指令试图修复调度时间。

## 立即运行一次并验收

对教学文件汇总任务，可以使用立即运行验证。打开本次记录，检查执行成员、状态、输出文件和投递结果。

| 要检查的内容 | 合格结果 |
| --- | --- |
| 输入 | 读取目标工作区的 daily-notes.md |
| 内容 | 没有把旧记录当作当天新进展 |
| 输出 | daily-report.md 能打开且结构正确 |
| 权限 | 需要确认的动作出现在正确任务的审批中 |
| 送达 | 指定会话收到结果，或记录显示无需投递 |

若文件名固定，后续运行可能覆盖它。需要保留每天的报告，应在指令中要求按报告日期命名，并明确日期所属时区。

![真实 App 的独立运行、结果位置与高级设置入口](/images/docs/scheduled-advanced.png)

## 等待审批时怎样继续

打开等待审批的任务或执行会话，阅读能力、参数和范围。只为当前动作放行时选择允许本次；确需周期使用的能力可以选择此任务始终允许。

任务创建时保存权限副本，之后改变 Agent 默认权限不会自动改写它。遇到外部服务权限错误，应检查服务账号，不用完全访问模式替代第三方授权。

## 历史脚本任务

当前页面不再提供脚本任务的创建和编辑入口。如果列表中保留历史脚本任务，可以启停、立即运行、查看记录或删除；打开详情时会看到历史任务说明。

脚本任务的控制属于人工操作范围，不能让 Agent 在聊天中代为管理。处理已有脚本前，先确认它在目标工作区执行什么、依赖哪些程序、是否会重复写入。新建普通任务时使用明确的任务指令，不要寻找不存在的脚本创建选项。

## 区分执行重试和投递重试

任务失败后先读记录，判断是否已经修改文件或调用外部服务。任务成功但通知失败时，只重试投递可以避免重做全部工作。

投递结果待确认时，先打开接收会话核对。若已收到消息，不应因页面未确认就再次发起整项任务。

## 管理长期任务

不再需要时停用任务，并检查正在执行的记录。删除不能撤销已经发生的写入。桌面退出、睡眠或服务器停止会影响执行，恢复后核对运行记录与下次时间，不承诺离线期间逐次补跑。

材料路径、模型或连接器发生变化后，先手动验证，再修改任务。每次只调整一个关键因素，便于判断问题来自哪里。

## 配置主动跟进

**设置 → 常规 → 主动跟进** 控制是否让 Agent 回访单聊。它不覆盖 Room 或外部 IM，也不提供精确时刻的替代计划。需要固定时间执行工具工作时使用定时任务。

关闭后若提示停止结果尚未确认，使用页面的核对或恢复操作检查状态。关闭跟进不会撤销之前完成的动作。