定时任务

简介

凡是“会重复发生，而且不值得每次都手动点一次”的工作，都适合先评估能否交给定时任务，例如：

• 定期拉取某个来源的新素材。
• 定时触发一次资料巡检或助手回合。
• 在固定时段把结果投递到应用内或移动渠道。

如果当前定时任务触发的是助手回合，它也可以继续发起资源库中的下载、转码和字幕任务。

前置条件

• 当前软件处于 全形态。
• 如果当前还没有完成引导页面初始化，先查看 安装、首次启动与更新 中的“欢迎使用”，完成初始化后再继续。
• 你已经想清楚，这个任务应该继续使用主会话上下文，还是放到隔离会话里运行。

功能介绍

使用流程

1. 进入 定时任务 页面，点击新建任务。
2. 在 基础信息 中填写名称与描述。
3. 在 调度配置 中选择 间隔执行、Cron 表达式 或 指定时间。
4. 在 载荷配置 中确认本次任务是系统事件还是代理运行。
5. 在 投递 中决定结果是否要播报或通过 Webhook 投递。
6. 保存并启用任务后，第一次最好先用低频或短周期方式验证结果。

运行状态

定时任务页本身就是一个运行面，通常至少要看三层信息：

• 概览：总览数量、最近执行和整体状态。
• 任务列表：所有任务的配置和当前状态。
• 执行记录：每次执行的具体结果、阶段和错误。

如果某个任务的执行状态不明确，先查看运行记录，再继续排查任务配置或运行环境。

助手回合

当载荷选择为 agentTurn，且当前助手启用了相关工具时，定时任务可以继续创建：

• 下载任务
• 转码任务
• 字幕翻译、校对与 QA 任务

这些任务的实际执行状态、输出与错误会回到资源库中统一管理。
定时任务页保留的是唤起、执行与投递记录，资源库保留的是媒体任务本身的运行记录。

使用建议

• 第一次先从低频、低风险任务开始。
• 保持输入和输出都足够明确，不要让任务目标过于模糊。
• 有外部投递时，给失败通知留好兜底路径。
• 定期检查最近错误和连续失败次数，别等到堆积成事故再处理。

配置介绍

创建定时任务时，主要需要确认下面这些配置：

触发方式

• every：按固定间隔触发。
• cron：按表达式在指定时间触发。
• at：在某个具体时间触发一次。

运行会话

• main：直接落在主会话里，适合需要延续已有上下文的任务。
• isolated：放进隔离会话，适合边界更清晰的自动任务。

载荷

• systemEvent：用于系统型动作或自动巡检。
• agentTurn：用于触发一次助手回合。

助手与工具

如果当前定时任务需要通过助手继续发起资源库任务，当前助手需要启用：

• 资源库查询
• 资源库任务

如果任务只需要提醒、投递或轻量查询，可以按需缩减工具范围。

投递

• none：不主动投递，只保留运行记录。
• announce：通过应用内或已接入渠道进行通知。
• webhook：投递到外部系统。