- 定时任务:属于某个项目的一条指令,到点后 Agent 在云主机上、这个项目里执行,每次运行生成一个会话(也可以接在同一个会话里)。在「定时任务」看板新建,或由 Agent 在会话里起草、你确认后生效。
- 会话定时:绑定在某个会话上的定时,到点后在这个会话里发一条触发消息,Agent 接着干活。Agent 可以在会话里直接创建(不需要你确认),你也可以在会话顶栏的定时面板里新建。周期会话定时 7 天后到期,可以续期。
入口
- 桌面客户端左侧图标栏「定时任务」;网页版侧栏底部「定时任务」。
- 命令菜单(
⇧⌘P,Windows 为Ctrl+Shift+P)搜索「前往 · 定时任务」。 - 站内通知(定时任务完成、失败、已暂停)点击后打开对应的定时任务。
- 会话定时另有入口:会话顶栏的定时图标,或顶栏「…」→「会话定时」。
看板
左侧列表按「即将运行」「已暂停」「已结束」分组,每行显示下次运行时间和计划;会话定时还会显示所在会话和到期时间。点一行在右侧打开详情。 详情里可以:
详情里还显示计划、下次运行、项目、模型、通知、创建方式(从会话里创建的可点击回到该会话)、指令和运行记录。
运行记录每次运行一行,显示时间和结果(进行中、已完成、失败 · 原因、已跳过 · 原因、已停止)。点有会话的记录会打开那次运行的会话。
新建定时任务
- 在看板点「新建任务」,打开「新建定时任务」。没有 Plus 时会先打开订阅弹窗,开通后自动回到这里。
- 在文本框写下要定时做什么。
- 选择「项目」:默认是你最近使用的项目。还没有项目时需要先创建并发布一个项目。
- 选择「重复」,再按重复方式填写时间(见下表)。
- (可选)展开「高级」调整其他设置。
- 点「创建」,提示「已创建定时任务 · 下次运行 X」。
- 「时间」以半小时为单位,按你的本地时间。
- 指令不能超过 16 KiB。每次运行最长 1 小时,超时记为「运行超时」。
- 只运行一次的任务运行完后进入「已结束」。
高级设置
定时任务没有「权限」设置:云端定时任务一律以完全访问运行。
编辑定时任务
在详情点铅笔图标打开「编辑定时任务」,字段同新建。可以把任务改到你的另一个项目;从会话里创建的任务不能改项目。在会话里由 Agent 起草
在任意会话里用自然语言提出定时需求,例如「每个工作日早上 9 点检查依赖更新」。Agent 会起草一个定时任务,会话里出现一张确认卡。确认卡里的定时任务在你点「创建」之前不会运行。- 「创建」:立即生效,卡片变为「已创建 · 下次运行 X」,带「在定时任务中查看」。
- 「编辑」:打开「编辑定时任务」修改,保存后再点「创建」。
- 「不用了」:不创建。
会话定时
会话定时绑定在一个会话上:到点后在这个会话里发一条触发消息,Agent 接着在这个会话里工作。适合「30 分钟后再检查一次部署」「每小时看一下队列」这类跟当前会话上下文相关的事。- Agent 创建:Agent 可以直接创建、修改、删除本会话的定时,不需要你确认;每次变化都会在时间线里留一行记录。
- 定时面板:会话有定时时,顶栏标题旁出现定时图标;没有时从顶栏「…」→「会话定时」打开。面板里可以对每条定时「立即触发」「停用」/「启用」「续期」「删除」。
- 新建:在面板点「新建定时」,填「提示词」和「名称(可选)」,选「N 分钟后」(最长 7 天)或「周期(cron)」(5 段 cron 表达式,最小间隔 5 分钟),点「创建」。
- 停止会话只停当前这一轮,会话定时继续有效。
到点触发
- 到点后,会话里出现一条「定时触发 · 名称」消息,Agent 开始这一轮。
- 会话正忙时按定时的「会话忙时」设置处理:「跳过本次」或「排队等待」。
- 一次性定时触发后自动停用。
到期与续期
- 周期会话定时创建后有效期 7 天。到期前 24 小时内,面板标「即将到期」,时间线出现提醒和「续期」按钮,点了再延 7 天。
- 已到期的定时会停用,需要先「续期」再启用。
- 续期保持原来的启用状态:你自己停用的续期后仍是停用;因到期停用的续期后恢复启用。
运行规则
连续失败自动暂停
定时任务连续 3 次运行失败后会自动暂停,看板显示「连续失败,已暂停」,你也会收到通知。查看运行记录里的失败原因,处理后点「恢复」。删除
点详情里的删除图标并确认。定时不会再运行,运行记录会被删除;已经生成的会话和会话里的消息会保留。注意与限制
- 定时任务的固定间隔最短 15 分钟;会话定时的周期最小间隔 5 分钟。
- 定时任务表单不支持自定义 cron 表达式;会话定时可以填 cron。
- 周期会话定时 7 天到期,需要续期。
- 每次运行都消耗模型用量(Plus 模型或你选的订阅 / BYOK)。
- 未开通 Plus 时可以浏览看板,新建会先引导开通,见未开通 Plus 时。