定时任务与自动应用

在系统应用「Agent」中，你可以管理按计划让助手只读并起草变更的「定时任务」、审阅助手生成的「草稿」、管理校验通过后自动生效的「自动应用」规则，以及只读查看和整理会话（「Session」）。助手在定时运行中只读和起草，不会直接修改业务数据，也不会直接替你创建定时任务。

谁能用复制本节链接

「Agent」是系统应用，每个组织默认开启且不能卸载。拥有 工作台 访问权限的成员均可打开。若当前环境没有 Agent 运行时，系统提示「当前环境没有 Agent 运行时，无法执行这个操作」。

具体操作权限如下：

• 普通成员：只能查看和管理属于自己的定时任务。操作非本人任务时，系统提示「只有任务的所有者能这样做」。
• 组织管理员：可以切换「任务范围」查看「全租户」的任务。非管理员切换时提示「只有管理员可以查看全租户的任务」。管理员查看他人任务时，只能执行「暂停」「恢复」或「删除」，不能编辑、不能「立即运行」、不能「补跑」。
• 审计员：只能查看定时任务，不能创建定时任务。尝试创建时提示「审计员只能查看，不能创建会起草变更的定时任务」。
• 任务所有者：创建、编辑、立即运行、补跑、重新授权仅限任务所有者本人操作。暂停、恢复与删除可由所有者或管理员操作。
• 所有者离开组织：若任务所有者已离开组织，任务无法恢复，系统提示「所有者已离开组织，无法恢复，请删除任务」。
• 草稿与自动应用：只处理本人的草稿和本人签署的自动应用规则（详见 草稿：审阅与应用）。
• Session：只能查找和整理属于你自己的会话；打开会话详情后为只读状态。

怎么打开复制本节链接

你可以通过以下途径进入：

1. 在 工作台 中点击打开「Agent」应用。应用说明为「管理定时任务；审阅、修改并应用助手起草的变更；管理自动应用；查看和整理会话」。
2. 通过对象链接进入：
   • 新建定时任务的对象链接：打开新建定时任务表单（支持携带预填参数）。
   • 指定任务的对象链接：打开该定时任务详情页。
   • 指定草稿的对象链接：打开该草稿详情页。

进入应用后，左侧导航提供 4 个页签，顺序如下：

1. 「定时任务」：应用首页，管理按计划运行的定时任务。
2. 「草稿」：集中审阅和应用助手起草的各项变更（详见 草稿：审阅与应用）。
3. 「自动应用」：管理已签署的自动生效规则。
4. 「Session」：查看和整理你与助手的历史会话。

界面一览复制本节链接

1. 定时任务复制本节链接

进入「定时任务」页签，页面包含以下区域：

• 页头与操作：标题显示「定时任务」，说明为「按计划让助手起草变更」，右侧提供「新建定时任务」按钮。
• 任务范围：管理员登录时显示「任务范围」切换项，包含「我的」和「全租户」。普通成员仅显示自己的任务。
• 列表展示：
  • 桌面端表格列包含「名称」「计划」「下次运行」「状态」「最近一次」；全租户视图下额外增加「所有者」列；操作列读屏标签为「操作」。
  • 窄屏模式下自动转为卡片展示。若授权角色发生变化，任务名称下方标注「角色已变化」。
  • 行内快捷操作提供「暂停」/「恢复」按钮；在「我的」任务视图下还提供「立即运行」按钮（全租户视图不提供「立即运行」）。
  • 空状态：无任务时显示「还没有定时任务」和「按计划让助手起草变更；保存后才会开始运行。」，并提供「新建定时任务」按钮。
  • 自动刷新：页面处于可见状态时，约 30 秒自动刷新一次。
• 字段展示格式：
  • 「计划」：采用通俗语言展示执行周期，例如「每天 09:00」「工作日 09:00」「每周一、周三 09:00」「每月 5 号 09:00」「每 30 分钟」「每 6 小时」；非默认时区带有时区标注（如「（Asia/Shanghai）」）；若无法解析则显示「自定义：……」。
  • 「下次运行」：正常运行时显示具体时间（如「今天 09:00」「明天 09:00」）；暂停时在此处显示暂停原因，包含「已手动暂停」「因连续失败暂停」「所有者已离开」「已暂停」。
  • 「状态」：显示「已启用」「已暂停」「因连续失败暂停」「所有者已离开」。
  • 「最近一次」：显示最近一次的运行结果，包含「还没运行过」「运行中」「失败」「跳过」，以及「成功·产出」加份数「份草稿」（产出 0 份草稿时显示为「成功·产出 0 份草稿」）。

1. 1页标题「定时任务」
2. 2「新建定时任务」
3. 3管理员「任务范围」：「我的」/「全租户」
4. 4列「名称」「计划」「下次运行」「状态」「最近一次」
5. 5「我的」视图行内「立即运行」

2. 新建定时任务复制本节链接

点击「新建定时任务」进入表单页面：

• 页头导航：标题显示「新建定时任务」，左上角提供返回按钮「← 定时任务」。
• 预填横幅：通过外部或助手链接预填进入时，页面顶部显示横幅「这是从别处带来的设置，确认后保存」。
• 配置字段：

  字段	必填	说明
  「名称」	是	填写任务名称，长度为 1–80 个字。
  「提示词」	是	填写交给助手的执行指令，长度为 1–8000 个字，下方实时显示当前字数。
  「计划」	是	选择执行周期类型，包含「每天」「工作日」「每周」「每月」「每隔」「自定义 cron」。
  「时间」	条件必填	计划类型为每天、工作日、每周、每月时选择具体运行时间。
  「星期几」	条件必填	计划类型为每周时选择对应星期。
  「几号」/「每月几号」	条件必填	计划类型为每月时选择，选项带「 号」。
  「每隔」与「单位」	条件必填	计划类型为每隔时填写数值并选择单位（「分钟」「小时」）。间隔最短 5 分钟，最长 90 天。
  「Cron 表达式」	条件必填	计划类型为自定义 cron 时填写，提示「五个字段：分 时 日 月 周」。
  「时区」	是	计划依据的时区，默认值为 Asia/Shanghai。
  「接下来 5 次运行」	-	填写有效计划后自动显示未来 5 次的运行时间预览；未填写计划时显示「填写计划后会显示预览」。
  「关联页面」	否	作为任务上下文的页面引用。输入对象链接并点击「添加」按钮添加，最多关联 10 条引用，单条最多 200 个字。提示由「最多」、条数、「条 k3:// 引用，会作为任务的上下文。」拼成；重复添加提示「已经加过这一条」。
  「通知方式」	否	运行完成后的通知偏好，可选「有草稿时」（默认）、「每次运行」、「不通知」。附带旁注提示「运行失败时总会通知你」。

• 授权说明：表单底部常驻展开授权说明，文案为：「任务以你的身份、按你现在的角色在无人值守时运行，只读和起草，不会直接修改数据；起草的变更会出现在『Agent 草稿』里等你审阅。暂停或删除任务即收回授权。」。
• 角色状态：若检测到你的组织角色已发生变化，提示「你的角色已变化，任务仍按授权时的角色运行」，并提供「按我现在的角色重新授权」按钮。
• 未保存保护：若有未保存的改动，离开页面时工作台或浏览器会弹出确认拦截；在应用内点击链接时提示「放弃未保存的修改？」，正文说明「有未保存的修改，离开后会丢失。」，点击「离开」按钮确认退出。
• 模型说明：表单不显示模型选择项。

1. 1页标题「新建定时任务」
2. 2「名称」必填，1–80 个字
3. 3「提示词」必填，交给助手的指令

3. 任务详情复制本节链接

在列表中点击任务名称进入详情页面：

• 导航与区块：左上角提供返回按钮「← 定时任务」；主要内容区包含「提示词」、「关联页面」（未添加时显示「没有关联页面」）和「运行记录」。
• 侧栏信息：展示「通知方式」「下一次运行」；管理员查看他人任务时展示「所有者」；授权过期时「授权」显示为「角色已变化」；任务正在执行时「现在」显示为「正在运行」。
• 操作按钮：提供「立即运行」「暂停」/「恢复」「编辑」「补跑」「删除」按钮。查看他人任务时没有立即运行、编辑和补跑按钮。
• 运行记录表：包含「开始时间」「触发方式」「状态」「耗时」「产出草稿」「失败原因」列。
  • 「触发方式」：显示为「手动」「补跑」或「定时」。
  • 「状态」：显示为「进行中」「成功」「失败」或「跳过」。
  • 「产出草稿」：产出草稿时显示数字加「份」的链接，点击可打开草稿详情。
  • 空状态：无记录时显示「还没有运行记录」。
  • 刷新频率：有任务处于「进行中」时，运行记录约 10 秒自动刷新一次。

1. 1返回列表
2. 2「立即运行」（他人任务没有）
3. 3「暂停」/「恢复」
4. 4「编辑」：弹出「编辑定时任务」
5. 5「补跑」：对已经过去的时段再跑，一次最多 31 天

4. 草稿复制本节链接

页签标题为「草稿」，提供「进行中」与「全部」筛选。助手按计划起草的变更均会进入草稿箱。详细功能与界面说明请参阅 草稿：审阅与应用。

5. 自动应用复制本节链接

进入「自动应用」页签，查看和管理已签署的自动生效规则：

• 页头与说明：标题显示「自动应用」，说明为「这些规则下的变更校验通过后自动应用，可随时撤销。」。
• 规则条目展示：
  • 规则按应用分组排列。
  • 默认标题由「Agent 起草的」加上操作名再加「自动应用」组成。
  • 副行展示规则属性：格式为「操作：…… · 范围：……」或「范围：全部」，后接「……签署」，以及「……到期」或「不设期限」。
  • 范围限定说明为字段名加「为」再加取值（取值包在「」里）。
  • 右侧提供「撤销」按钮。
• 空状态：无生效规则时显示「没有生效中的自动应用」与说明「在草稿里可为某类变更开启自动应用。」。

1. 1页标题「自动应用」
2. 2页头说明
3. 3每条规则右侧「撤销」（空态则无此钮）

6. Session复制本节链接

进入「Session」页签，查看和整理你与助手的会话（打开后为只读状态）：

• 页头与说明：页签和页面标题均为「Session」，说明显示为「你和助手的会话：在这里查找和整理，打开后只能查看。」。
• 筛选与搜索：
  • 顶部标签切换「会话」与「已归档」。
  • 来源筛选下拉菜单包含「全部来源」「对话」「定时任务」「外部客户端」。
  • 搜索输入框显示「按名称查找」。
• 列表与操作栏：
  • 提供「全选」复选框，选中后显示「已选……个」，提供「取消选择」按钮；底部显示总数「……个会话」及「加载更多」按钮。
  • 批量操作按钮包含「归档」「取消归档」「删除」。
  • 单行状态徽章显示「回答中」「等待回答」「出错」，置顶会话标有「已置顶」。
  • 行菜单提供「重命名」「置顶」「取消置顶」「归档」「取消归档」「删除」。
• 会话详情（只读）：
  • 顶部标有徽章「只读」，左上角提供返回链接「← Session」。
  • 若助手正在该会话中工作，提示「助手还在这个会话里工作，这里会自动刷新；要回应它，请在左侧 Agent 栏打开这个会话。」。
  • 会话无消息时提示「这个会话还没有消息」。
  • 若会话已被删除或不存在，提示「找不到这个会话」与「它可能已被删除。」。

常用操作复制本节链接

新建定时任务复制本节链接

1. 在左侧导航点击「Agent」应用，点击「定时任务」页签。
2. 在页面右上角点击「新建定时任务」。
3. 填写任务表单：

   字段	必填	说明
   「名称」	是	输入任务名称（1–80 个字）。
   「提示词」	是	输入执行指令（1–8000 个字）。
   「计划」	是	选择执行周期（「每天」「工作日」「每周」「每月」「每隔」「自定义 cron」），并填写对应的时间、星期、日期、间隔数值与单位（分钟/小时，最短 5 分钟）或 Cron 表达式。
   「时区」	是	确认时区，默认为 Asia/Shanghai。
   「关联页面」	否	输入对象链接并点击「添加」，作为任务上下文（最多 10 条，每条最多 200 个字）。
   「通知方式」	否	选择「有草稿时」（默认）、「每次运行」或「不通知」。

4. 在表单底部仔细阅读授权说明。
5. 点击底部的「保存」按钮。保存完成后，任务才会按照计划开始计时运行。

立即运行任务复制本节链接

1. 在「定时任务」列表中找到属于你的任务，或进入任务详情页。
2. 点击行内或顶部的「立即运行」按钮。
3. 任务立即触发执行，详情页「运行记录」新增一条触发方式为「手动」、状态为「进行中」的记录。

暂停与恢复任务复制本节链接

1. 在「定时任务」列表行内或任务详情页中找到目标任务。
2. 若任务处于「已启用」状态，点击「暂停」按钮。任务计划随即停止，状态变更为「已暂停」。
3. 若任务已被暂停，点击「恢复」按钮。任务重新按计划进入倒计时，状态恢复为「已启用」。

编辑定时任务复制本节链接

1. 在「定时任务」列表中点击属于你的任务名称，进入任务详情页。
2. 在页面右上角点击「编辑」按钮。系统弹出标题为「编辑定时任务」的对话框。
3. 修改任务的名称、提示词、计划、关联页面或通知方式。
4. 点击对话框底部的「保存」按钮。修改即时保存生效。

补跑历史时段复制本节链接

1. 在属于你的定时任务详情页中，点击顶部的「补跑」按钮。系统弹出「补跑」对话框，说明对已经过去的一段时间再跑一遍，一次最多 31 天。
2. 在「开始日期」与「结束日期」中分别选择过去的时间段。
3. 点击「开始补跑」按钮。系统随即生成触发方式为「补跑」的运行记录并开始执行。

重新授权任务复制本节链接

1. 当你的组织角色发生变动后，在定时任务列表或详情页查看「角色已变化」提示。
2. 进入任务详情页，查看横幅提示「你的角色已变化，任务仍按授权时的角色运行」。
3. 点击「按我现在的角色重新授权」按钮。任务更新为你当前的最新角色继续执行。

删除定时任务复制本节链接

1. 在定时任务详情页中，点击顶部的「删除」按钮。系统弹出确认对话框「删除这个定时任务？」，提示「删除后计划停止，授权收回，已经产出的草稿还在。此操作不能撤销。」。
2. 点击对话框中的「删除」确认按钮。任务随即被删除。

开启自动应用规则复制本节链接

1. 打开一份仍有可预签待处理项的草稿详情页（详见 草稿：审阅与应用）。
2. 在草稿详情页底部的「自动应用」区域，选择有效期（指定日期到期或「不设期限」）。
3. 点击「开启自动应用」按钮。系统显示签署内容「将签署：」，完成签署后规则在「自动应用」页签中生效。

撤销自动应用规则复制本节链接

1. 在「Agent」应用中点击「自动应用」页签。
2. 找到需要撤销的规则条目，点击右侧的「撤销」按钮。系统弹出确认对话框「撤销自动应用？」，提示「撤销后这类变更需重新逐条审阅，已应用的不受影响。」。
3. 点击确认撤销。撤销后，此类变更需重新在草稿中逐条人工审阅并应用。

查找与筛选会话复制本节链接

1. 在「Agent」应用中点击「Session」页签。
2. 在「按名称查找」输入框中输入关键字搜索会话。若无匹配结果，提示「没有符合条件的会话」与「换个名称或来源试试。」。
3. 在来源下拉框中选择「全部来源」「对话」「定时任务」或「外部客户端」。
4. 点击顶部切换「会话」与「已归档」标签页。若已归档列表为空，提示「没有归档的会话」与「归档的会话不在左侧列表里显示，会留在这里。」。全新无会话时提示「还没有会话」与「在左侧 Agent 栏和助手对话后，会话会出现在这里。」。

重命名会话复制本节链接

1. 在「Session」列表中找到目标会话，点击行操作菜单或在详情页中点击「重命名」。系统弹出「重命名会话」对话框，提示「新名称也会显示在左侧的会话列表里。」。
2. 在「会话名称」输入框中输入 1–120 个字（不能为空，否则提示「名称不能为空」）。
3. 点击保存按钮完成重命名。

置顶与取消置顶会话复制本节链接

1. 在「Session」列表中找到目标会话，点击行操作菜单中的「置顶」。会话固定在列表顶部并显示「已置顶」徽章。
2. 在已置顶会话的操作菜单中点击「取消置顶」。会话恢复默认排序。

归档与取消归档会话复制本节链接

1. 单条操作：在目标会话行操作菜单中点击「归档」，会话从左侧对话列表移出并归入「已归档」标签页；在「已归档」列表中点击「取消归档」可移回常规会话列表。
2. 批量操作：勾选多个会话前面的复选框，页面上方显示「已选……个」，点击顶部的「归档」或「取消归档」按钮。完成后提示「已归档……个会话」或「已取消归档……个会话」。若有部分处理失败，提示「……个会话没有处理成功，请重试」。

删除会话复制本节链接

1. 单条删除：在目标会话行操作菜单或详情页中点击「删除」。系统弹窗提示「删除这个会话？」，并说明该会话标题加「的全部消息和附件都会删除，无法恢复。」，点击确认删除。
2. 批量删除：勾选多条会话前面的复选框（可点击「全选」），点击顶部的「删除」按钮。系统弹窗提示「删除……个会话？」及「它们的全部消息和附件都会删除，无法恢复。」，确认后提示「已删除……个会话」。

状态说明复制本节链接

定时任务状态复制本节链接

已启用 ⇄ 已暂停（包含：已手动暂停 / 因连续失败暂停 / 所有者已离开）

运行记录状态流转复制本节链接

触发（定时 / 手动 / 补跑） → 进行中 → 成功 / 失败 / 跳过

会话状态徽章复制本节链接

在「Session」列表中，会话具有以下状态标识：

• 「回答中」：助手正在会话中生成回复。
• 「等待回答」：等待助手响应中。
• 「出错」：会话处理遇到错误。
• 「已置顶」：手动置顶的会话。

让助手帮你做复制本节链接

在与助手的对话中，你可以要求助手根据业务场景提供定时监控或巡检任务的建议。由于助手没有「Agent」应用本身的写操作权限，助手不能直接替你创建或保存定时任务，但助手可以通过预填的新建任务对象链接为你准备好任务名称、提示词与计划，由你打开链接确认后点击「保存」。

你可以对助手说：

"帮我制定一个每天 09:00 检查待审批工单的定时任务。" "我想在每个工作日 18:00 汇总当天的销售数据，帮我写个定时任务提示词并生成预填链接。" "针对这个分析看板，生成一个每周一 09:00 关注核心指标变动的定时计划。"

设置复制本节链接

「Agent」应用内没有独立的「设置」页面：

• 自动应用规则：作为变更的预签名规则，统一在「自动应用」页签中查看和撤销。
• 组织模型与助手：助手的模型配置、显示名称与 Skill 等属于组织级配置，统一在组织管理后台的 模型 等页面中进行设置。

注意事项复制本节链接

• 数量限制：每个组织最多创建 50 个定时任务。达到上限时提示「这个组织的定时任务已满（最多 50 个）」。
• 运行周期限制：计划间隔最短不能短于 5 分钟（提示「计划间隔不能短于 5 分钟」），最长不超过 90 天（提示「间隔最长 90 天」）。间隔数值需按指定格式书写（提示「间隔请写成 30m、6h 这样的形式」）。自定义 Cron 表达式必须包含 5 个字段（提示「cron 需要 5 个字段：分 时 日 月 周」）。遇到无效时区提示「不认识这个时区」。
• 引用与字数限制：每个任务最多关联 10 个页面（提示「最多关联 10 个页面」），引用必须是对象链接（提示「关联页面必须是 k3:// 引用」），且单条引用最多 200 个字（提示「一条引用最多 200 个字」）。任务名称限制 1–80 个字（提示「名称需要 1 到 80 个字」），提示词限制 1–8000 个字（提示「提示词需要 1 到 8000 个字」），会话名称限制 1–120 个字（为空时提示「名称不能为空」）。通知方式若不合规会提示「通知方式只能是：有草稿时、每次运行、不通知」。若找不到任务提示「找不到这个任务」，若创建计划失败提示「计划没能创建，请稍后重试」，若模型不可用提示「这个模型现在不可用」。
• 补跑限制：补跑只能覆盖已经过去的历史时段（提示「补跑只能覆盖已经过去的时段」），且单次补跑跨度最多 31 天（提示「补跑一次最多 31 天」）。
• 授权与执行机制：
  • 任务以你的身份在无人值守时执行，按你授权时的组织角色运行。任务只读和起草，不会直接修改业务数据。
  • 角色变化后任务不会自动更新权限，仍按最初授权时的角色运行；如需同步，需手动点击「按我现在的角色重新授权」。
  • 暂停或删除任务即视为立即收回授权。
  • 若所有者离开组织，任务自动停用且无法恢复，系统提示「所有者已离开组织，无法恢复，请删除任务」，只能删除。
• 自动应用范围与限制：
  • 仅支持低风险的新建和修改操作，且该操作不得要求确认、选择、填写、再验身份，也未显式禁止预签。
  • 高风险操作、删除操作、动作类操作，以及包含交互确认的操作一律不支持自动应用。
  • 自动应用执行时依然会执行严格校验；若存在警告、待选择或无效项，仍须人工在草稿中处理。
• 不可撤销操作：
  • 删除定时任务后，计划停止且授权收回，此操作不可撤销（已产出的草稿依然保留）。
  • 删除会话后，会话全部消息和附件均会被永久物理删除，无法恢复。

目前不支持复制本节链接

• 在应用内选择模型：新建与编辑定时任务表单中不提供模型选择项，定时任务统一运行在组织配置的模型上。

常见问题复制本节链接

定时任务运行完成后，为什么没有直接更新业务系统里的数据？复制本节链接

定时任务是以你的身份在无人值守状态下执行。出于数据安全考量，助手仅拥有只读和起草权限，绝不会直接修改业务数据。任务运行后产出的所有变更都会存入「草稿」中（详见 草稿：审阅与应用），需由你人工审阅后确认应用；只有当你预先为该类变更开启了「自动应用」规则且预检全部通过时，系统才会自动应用。

管理员可以修改或代跑组织内其他成员创建的定时任务吗？复制本节链接

不能。组织管理员切换至「全租户」视图后，可以查看组织内所有成员的任务，并拥有暂停、恢复与删除的治理权限。但出于身份授权边界与安全审计要求，管理员不能编辑他人任务，也不能点击「立即运行」或「补跑」。

为什么任务状态会变成「因连续失败暂停」或「所有者已离开」？复制本节链接

当定时任务连续多次执行失败时，系统会自动将其置为「因连续失败暂停」，以避免持续消耗资源；若创建任务的成员已离开组织，任务会被置为「所有者已离开」，此时任务无法恢复运行，系统提示「所有者已离开组织，无法恢复，请删除任务」，只能由管理员将其删除。

提示「你的角色已变化」会影响任务运行吗？该如何处理？复制本节链接

任务仍会按最初授权时的角色权限继续运行。若你的组织角色发生了调整，且任务需要使用你的最新权限，请进入任务详情页点击「按我现在的角色重新授权」按钮，任务即可按你当前的最新角色继续执行。

为什么在「自动应用」页面中找不到新建规则的按钮？复制本节链接

自动应用规则不支持在规则列表页中直接新建。只有在打开一份包含可预签条目的草稿详情页时，在页面底部选择有效期并点击「开启自动应用」后，系统才会生成一条自动应用规则并展示在「自动应用」列表中。