AgentKit Studio
任务指南

自动化与调度

把 Agent 绑定到一次性、固定间隔或 Cron 触发规则上,选择本地或云端执行,并把执行结果投递到渠道会话。

自动化(automation)解决的是「到点自己跑一次」:一条提示词 + 一条触发规则 + 一个目标 Agent。 它不改变 Agent 的能力,只决定什么时候把哪句话发给它。

前置条件

  • 至少有一个 Agent。本地自动化需要应用保持运行;云端自动化需要该 Agent 已部署到云端。
  • 云端投递到渠道会话,还需要在 Channels 里绑定过这个云端 Agent,并与机器人完成过一次对话。

两种调度目标

执行位置在哪里跑关闭应用后适用
本地你这台设备的 Host 进程不会执行需要在你的工作区里改文件、跑命令
云端部署云端常驻实例仍然按计划执行定时摘要、巡检、巡检类通知

页面顶部有一个状态徽章:调度运行中 表示触发循环已经起来,调度待就绪 表示还没起来(例如 Host 刚启动或没有可用的执行器)。 本地与云端共用同一套触发规则语法,区别只在执行位置和投递能力。

操作步骤

打开自动化

运行中心 → 自动化。先在上方切 本地 或 云端部署——切换会清空当前筛选和正在编辑的表单。

两种位置分开存储

本地任务和云端任务各存一份,互不可见。切换位置后看到的列表是独立的,不要以为任务丢了。

新建一条自动化

点右上角 新建自动化,或者从「从常用任务开始」里挑一个模板预填:

模板触发规则提示词示例
每日简报 · 工作日 10:000 10 * * 1-5整理今天工作区中的变更并给出摘要
定期巡检 · 每 30 分钟固定间隔 1800 秒检查服务状态,发现异常时给出原因和处理建议
每周总结 · 周五 17:000 17 * * 5总结本周工作区中的重要进展、风险和待办

模板只预填名称、提示词和规则,不会直接创建任务。

填写三要素

字段说明
绑定 Agent目标 Agent。编辑已有任务时不可改——换目标请新建
任务名称列表里显示的名字,例如「每日工作摘要」
到期时发送给 Agent 的提示词到期时原样发给 Agent 的那句话

名称和提示词都必填,留空会提示「请选择 Agent,并填写任务名称和提示词」。

选择触发方式

触发方式参数约束
固定间隔间隔秒数最少 60 秒;填小于 60 或非数字会按 3600 处理
Cron五段表达式(时区 Asia/Shanghai)必须正好 5 个字段;支持 *、,、-、/
执行一次执行时间(本地时间)必须是未来时间,否则提示「请选择未来的执行时间」

Cron 例子:

0 9 * * 1-5      工作日 09:00
*/30 * * * *     每 30 分钟
0 17 * * 5       周五 17:00

选择结果去向(云端)

云端自动化可以只留执行记录,也可以把结果发到渠道会话:

选项行为
仅保存执行记录结果留在「执行记录」里,不发送到任何 IM
发送到渠道会话从「收件会话」下拉里选一个

收件会话只列出绑定了这个云端 Agent、且已完成过对话的 WPS 协作或飞书会话,形如 WPS · <渠道账号> · 群聊 <会话 ID>。 列表为空通常意味着还没绑定渠道或还没跟机器人说过话。

发送失败不会重跑任务

投递是执行之后的独立一步。投递失败只会在执行记录上标一个投递状态,不会重新执行 Agent。

保存

点 创建(编辑时是 保存修改)。成功提示分两种:

  • 本地:「本地自动化已创建,请保持应用运行。」
  • 云端:「云端自动化已创建,关闭应用后仍按计划执行。」

日常管理

每个任务行上有:

操作说明
详情任务 ID、执行计划、会话方式、下次执行时间、完整提示词
执行记录展开最近 8 次执行及状态
编辑打开同一个表单
执行一次立刻跑一次,不改变原有计划
删除不可撤销。云端任务只停止后续触发,已触发的执行和结果投递会继续
启用开关暂停 / 恢复。暂停的任务不能「执行一次」

看板视图按四列分组:待执行、执行中、需关注、已暂停 / 已结束。

看 DSH 原生会话自动化

本地页签下方有一个折叠区「DSH 原生会话自动化 N · 展开查看」。这些任务由对话里的 schedule_create 创建,与 Host Agent 自动化分开存储。

要创建一条,直接在新会话里说:

每天 9 点提醒我整理工作摘要

DSH 会调用 schedule_create;创建后刷新本页就能看到。这里只读,编辑和删除回到原会话。

调度语义

规则行为
检查周期每 30 秒 扫一次到期任务
错过触发默认策略 skip:跳过本次,不补跑
同一任务并发不允许。上个 occurrence 未结束时本次跳过
单实例占用一个调度器独占存储目录;第二个进程启动会得到 SCHEDULER_OWNED
进程崩溃恢复启动时把 claimed / running / accepted / admitting 状态的旧执行统一标为失败,错误码 AUTOMATION_OUTCOME_UNKNOWN,不重放原调用
会话方式每次新建会话(默认),或继续已有会话

AUTOMATION_OUTCOME_UNKNOWN 的含义是「原宿主执行中断,结果尚未确认,请通过原会话核对」——它不会自动补跑,必须人工确认。

成功后的样子

  • 任务行徽章是 已启用,meta 里显示「下次执行:<时间>」。
  • 点 执行记录 能看到最近的 occurrence,状态 succeeded,并带完成时间。
  • 云端投递的任务在执行记录里显示「渠道投递:已送达」。
  • 徽章变成 需关注 时,说明最近一次执行失败或投递失败,展开详情看 errorCode 与 detail。

常见错误

错误码原因处理
SCHEDULE_KIND_INVALIDkind 不是 once / interval / cron用界面上的三个触发方式之一
SCHEDULE_SPEC_INVALIDonce 缺 at,或 interval 缺 everySeconds补齐对应参数
SCHEDULE_TIMEZONE_INVALID时区不合法用 Asia/Shanghai
CRON_INVALIDCron 不是 5 个字段按上面的例子改成五段
TASK_ID_INVALID任务 ID 不符合 ^[a-z][a-z0-9-]{2,62}$让系统自动生成,不要手输
SCHEDULE_NOT_FOUND任务不存在刷新列表后重试
SCHEDULE_DISABLED对已暂停的任务点「执行一次」先启用再执行
SCHEDULE_RUNNING该任务上一次执行还没结束等它结束
SCHEDULER_CLOSED调度器已关闭重启应用
SCHEDULER_OWNED另一个宿主进程正占用调度器关掉另一个进程
AUTOMATION_OUTCOME_UNKNOWN原宿主执行中断,结果未确认到原会话核对;系统不会重放
AUTOMATION_RUN_FAILED运行适配器执行失败看执行记录的 detail
delivery_target_unavailable原渠道或会话已不可用检查 Channels 里的绑定
delivery_target_changed机器人或收件会话已变化重新选择收件会话
delivery_conversation_missing尚未取得会话信息先与机器人对话一次
result_text_missing_or_too_large本轮没有可发送文本,或结果超长缩短提示词要求,或改为「仅保存执行记录」
delivery_outcome_unknown发送进程未确认结果到收件会话核对;不会自动重发

相关参考

本页导航