自动化任务

当一个任务需要重复执行、持续跟踪或公开沉淀时，就应该从普通会话升级为自动化能力。

自动化任务的关键不是“定个时间让 Agent 跑”，而是把无人值守时也必须明确的输入、步骤、能力、通知和产物路径提前固定下来。

为了避免影响重要业务流程, 后台设置的 "用户/团队" 限额对定时任务不生效 。

定时任务

定时任务会按计划自动创建执行记录，并保留运行历史。适合：

• 每日/每周报告。
• 代码仓库巡检。
• 页面可用性检查。
• 数据同步和摘要生成。
• 多步骤跟进任务。

创建时需要配置：

示例：

名称：每日失败任务巡检
周期：每天 09:00
任务内容：统计昨天失败的 Agent 会话，按失败原因分类，并给出处理建议。
通知：仅失败通知

无人值守任务的提示词要比普通聊天更明确。建议包含：

1. 数据范围，例如“昨天 00:00 到 23:59”。
2. 输出文件，例如“生成 report.html 和 summary.md”。
3. 异常处理，例如“如果数据源不可用，输出失败原因，不要编造数据”。
4. 敏感信息要求，例如“不要把 Token、手机号、客户姓名写入公开产物”。

复用会话还是新建会话

复用模式创建后通常不建议频繁切换。若任务目标已经变化，创建新任务更清晰。

复用会话适合“持续维护同一份东西”，例如每天更新同一个看板。每次新建会话适合“每天独立出一份报告”，例如日报、巡检报告、周报归档。

多步骤任务

定时任务支持主消息和续聊步骤。适合先生成内容，再继续加工。

示例：

主消息：拉取本周产品反馈并按主题分类。
续聊 1：基于分类结果生成管理层摘要。
续聊 2：把摘要整理成 Markdown 周报。

续聊步骤有两类触发方式：

如果开启复用会话模式，系统只保留主步骤，避免长期上下文变得不可控。需要多步骤链时，通常使用“每次新建会话”更清晰。

多步骤任务建议让每一步只做一件事。例如第一步拉取和整理数据，第二步生成管理层摘要，第三步生成可发布 HTML。不要让每一步都重复完整任务。

前置与后置任务

业务场景中的定时任务可以配置产物依赖。例如任务 A 每 2 小时生成数据，任务 B 每天 08:00、12:00、17:00 汇总 A 最近可用的一轮产物：

办公场景不提供任务联动配置入口；如需建立、修改或解除前置/后置关系，请切换到业务场景。

1. 在 A 的新增或编辑页面中把 B 设为后置任务；也可以在 B 中把 A 设为前置任务。
2. 为这条关系选择 前置完成后触发 或 按自身计划取最新产物。
3. B 从工作区的 /inputs/upstream 读取文件，并可通过 /inputs/upstream/.poco-manifest.json 获取来源 Run、原文件名、大小和摘要。

每个产物包都是某一轮 A 运行期间 新增或内容发生变化的文件增量，不是 A 工作区的完整快照；文件删除也不会作为删除指令传递。作为输入传入 A 的文件、缓存和系统内部目录不会再次传给 B。

联动后的触发规则

假设 A 是前置任务，B 是后置任务，两种执行方式的差异如下：

前置完成后触发

该模式会用前置关系替换 B 原有的触发入口：

• A 必须成功完成最后一个启用步骤，并生成至少一个本轮新增或内容发生变化的文件，才会触发 B。
• B 暂停时会跳过本次联动，重新启用后不会补跑，只等待 A 的下一次有效产出。
• A 暂停后，B 不会回退到自身 Cron。解除关系后，如果 B 已启用，系统会从当前时间重新计算下一次 Cron。
• 没有文件变化、文件清单校验失败或产物包生成失败时，都不会触发 B。

按自身计划取最新产物

该模式让 A 只负责提供数据，B 继续由自己的 Cron 或立即触发入口决定何时运行：

• B 每次根步骤入队前，会选择 A 最新的可用非空产物包；即使 A 当前已暂停，只要历史产物仍可用，B 仍可使用。
• 系统不设置固定的“最大产物年龄”。是否允许使用更久以前的产物由 A 的更新频率、B 的业务计划和对象存储保留策略共同决定。
• 选中的产物版本会写入 B 的 Run 快照。B 排队期间或多步骤执行期间即使 A 又完成了新一轮，当前 B 也不会中途切换；B 的下一次根运行才会重新选择。
• 如果 A 最新一轮没有文件变化，系统继续使用最近一次 可用且非空 的产物包，而不是传入空目录。
• A 还没有任何可用非空产物时，本次 B 不会创建 Run：立即触发会返回失败，Cron 触发会记录错误并继续等待下一个计划时间。
• “最新”不等于“完整”：选中的是最近一轮可用产物的文件增量。需要完整数据集时，应让 A 每轮输出一份自包含快照文件。

依赖关系还遵循以下规则：

• 一个任务最多有一个前置任务，但可以有多个后置任务；系统禁止自引用和循环依赖。
• 上游包含多个启用步骤时，第二步及以后必须使用“前一步完成后触发”，并由最后一个启用步骤发布本轮文件。
• “前置完成后触发”还要求下游采用同样的步骤结构；“按自身计划取最新产物”允许下游保留独立 Cron 步骤。
• 下游有排队中或运行中的 Run 时，不能新增前置关系或切换执行方式，避免同一轮执行过程中改变输入语义。
• 修改、暂停或删除关系不会改变已经入队 Run 中冻结的产物版本。

下游提示词可以直接描述处理目标，无需猜测动态文件名。例如：

读取 /inputs/upstream 中的全部上游文件，根据 .poco-manifest.json 核对来源，生成一份合并分析报告。

联动没有按预期执行时，依次检查：

1. 关系使用的是“前置完成后触发”还是“按自身计划取最新产物”。
2. A 的最后一个启用步骤是否成功完成，并实际新增或修改了文件，而不只是输出对话文本。
3. 产物清单和归档是否生成成功、是否仍在对象存储保留期内。
4. 事件触发模式下，A 和 B 是否都已启用，B 是否在产物准备完成前被暂停。
5. 计划取最新模式下，B 自身 Cron 是否启用，运行记录中的来源 Run 是否符合预期。

通知策略

定时任务支持通知开关和通知模式：

如果没有启用的通知渠道，即使定时任务打开通知，也不会实际投递。创建重要自动化任务前，先在通知配置页测试渠道。

发布中心与案例库

发布中心用于把会话中的 HTML 或 Markdown 产物发布成可访问页面。案例库用于沉淀可公开复用的优秀成果。

创建定时任务时可以直接开启“固定地址发布”。系统会同时创建一个不展示到案例库、默认采用无干扰模式的发布页，并在每次任务成功产出后自动更新。如果任务已有可发布产物，开启后会立即尝试首次发布；固定地址可通过任务列表编辑按钮左侧的图标打开。

关闭“固定地址发布”只会停止后续自动更新，不会删除已经分享的地址和历史版本。删除定时任务时也会保留该地址，但不再更新。需要设置固定入口文件、分类或公开到案例库时，再到发布页中编辑高级配置。

适合发布：

• 活动页、演示页、数据看板。
• 业务分析报告。
• 培训材料和操作手册。
• 可复用的方案模板。

发布后，如果同一路径产物继续更新，可自动同步新版本。

自动发布依赖工作区导出和入口文件。为了让系统稳定识别，建议在任务提示词中明确要求：

请生成可发布入口文件 `report.html`。
如果需要补充说明，请另存为 `summary.md`。
不要只在对话中输出报告正文。

固定地址和发布中心只适合发布 .html 或 .md 文件。复杂多文件页面也可以生成，但要保证入口文件路径稳定。固定地址无需登录即可访问，开启前应确认产物不包含敏感信息。

工作流看板

工作流看板用于观察任务从输入、分析、计划、工具调用到验证总结的运行链路。它适合：

• 监控正在运行的任务。
• 排查任务卡住的位置。
• 复盘高频失败原因。
• 向团队演示 Agent 执行过程。

注意：工作流看板会持续刷新，非排查或监控时不要长时间停留。

运行失败后怎么处理

定时任务失败时，先看运行历史中的失败会话，再按下面顺序排查：

1. 上一次成功运行是否使用了相同配置。
2. MCP 或外部系统是否不可用。
3. 环境变量、登录态、仓库权限是否过期。
4. 多步骤任务是否因为前一步失败导致后续步骤没有执行。
5. 输出文件是否没有生成，导致发布中心无法发布。

如果需要人工追查，建议从失败会话分叉到新任务入口，让 Poco Agent 基于失败现场继续分析。

使用技巧

• 能人工稳定执行三次的任务，才值得自动化。
• 定时任务提示词要比普通聊天更明确，因为它无人值守。
• 夜间任务一定要配置通知，失败后方便第二天处理。
• 自动发布前确认产物不包含敏感信息。
• 看板用于监控和排查，不适合作为日常长开页面。
• 任务运行失败时，可以使用分叉会话功能在新任务入口继续排查。
• 未使用复用会话时，每次运行都更接近一次全新的执行环境。
• 需要自动发布时，把入口文件名写进提示词，不要只说“生成一个报告”。