文档自动化与工作台
文档目录

定时任务

定时任务按设定时间让 Agent 自动执行,结果保存在会话里;入口在左侧栏,任务列表按启用中、已暂停、已完成分组,频率与次数上限在表单右侧配置。

更新于 2026年11月10日

左侧栏「定时任务」把左栏换成任务列表,主区默认显示一页说明;选中某次运行会话后,主区就是那个会话。

任务列表

顶部分成三组,顺序固定:

  • 启用中:按下次运行时间从近到远排。
  • 已暂停:手动暂停,或连续失败被自动暂停。
  • 已完成:只运行一次的任务完成后,或者达到次数上限。

任务行显示名称、状态与频率:

  • 启用中的状态是「下次 11/11 09:00」,暂停和已完成直接写状态。
  • 第二行是调度频率,例如「每 20 分钟 · 工作日 · 10:00–12:00 · 限 5 次」;设了不打扰的提醒策略时还会标「静默运行」「仅失败提醒」。
  • 有未看过的执行结果时,任务名后面标「N 待查看」。

点任务行展开它的运行会话,默认先列出 5 条,可以继续展开;右上排序菜单切换「最近活动 / 创建时间」。点击某条运行记录进入那次会话。

行尾「更多操作」:编辑任务、暂停或启用、立即运行、删除任务(删除时提示会一并清理已结束且未被接管的历史会话)。顶部搜索框按名称和任务描述过滤,「创建定时任务」是新建入口。

创建

表单分左右两栏:左侧写任务描述,右侧是配置。名称默认是「定时任务 N」,点铅笔可改。

创建也有对话入口:说明页上的「与 Agent 创建定时任务」会打开一个新会话并预填「帮我创建一个定时任务:」,你接着把要做的事和节奏说清楚;在任意会话里直接交代「以后每个工作日上午 9 点检查一次」也能建。

运行频率

五种类型,选中后只显示对应的字段:

  • 每隔一段时间:填间隔分钟数(最少 1,默认 10)。可以再叠加两项——
    • 仅在每日时段内运行:开关默认关闭,打开后填开始与结束时刻,默认 09:00–18:00;留空视为全天按间隔运行。
    • 运行日:每天 / 工作日(周一至周五)/ 周末 / 自定义,自定义时逐个勾选。
  • 每天定点:一个时刻,默认 09:00。
  • 每周定点:星期几 + 时刻,默认周一 09:00。
  • 每月定点:几号 + 时刻,默认 1 号 09:00。选 29、30、31 号时会提示「如当月无该日,将在当月最后一天执行」。
  • 仅运行一次:一个具体日期时间,默认一小时后;运行后自动完成。

有效窗口是「开始包含、结束不包含」:10:00–12:00 每 20 分钟,最后一轮在 11:40,不会在 12:00 再运行。改频率、时刻、窗口或运行日后,下次运行时间从当前时刻重新推算,不会立刻补跑一次。

次数上限

循环模式下才有这一项,一次性任务本身只运行一次,不显示。

  • 留空表示不限次。
  • 按实际执行次数计:成功和失败都算,被跳过的轮次不算。
  • 达到上限后任务自动完成停用,进入「已完成」组;重新启用会从零重新计。

模型与项目

两项都不缺才能启用:缺任意一项时启用开关不可用,点启用会直接打开配置以补全缺失项。

  • 选择模型:先选渠道再选模型,未指定时用渠道默认。
  • 项目:必选,决定运行时会话的工作目录与项目规则。任务绑定一个项目,改项目后下次运行会新建会话,不继承旧的工作目录上下文。

结果提醒

  • 应用内结果提醒:显示为未读(默认)/ 仅失败时显示为未读 / 静默运行。它只控制 Proma 里的未读角标与提示,不影响外部通知;静默也照样执行、照样写会话。
  • 飞书通知:打开后选一个已有飞书聊天,再选触发条件——成功或失败都通知 / 仅成功 / 仅失败。没有可用绑定时会提示先在飞书里给 Bot 发一条消息。

结果与会话

每次运行都在这个任务名下写入会话,过程和输出都在里面,可以直接追问、让它调整后续任务。

  • 同一天内的多次运行默认复用同一个会话,跨天自动新建。
  • 同一天里上下文占用接近上限时也会提前新建,不等到压缩。
  • 这些运行会话不进普通项目列表;在结果会话里手动发一条消息即接管,会话回到所属项目的会话列表,任务之后不再往它里面写。

注意

  • 任务以「完全权限」无人值守运行,可以自主读写文件、执行命令,任务描述要当成会被直接执行的指令来写。
  • 下次运行时间按上次结束时刻起算;开了每日窗口的固定间隔任务改为对齐窗口起点,避免逐次往后偏移。
  • 「仅运行一次」填了已经过去的时刻也能保存,保存后会尽快执行一次。
  • 跳过、失败、自动暂停、应用未运行时的行为见「定时任务运行与维护」。
本页内容