Appearance
定时任务
定时任务用于让 AI 在指定时间自动执行一段任务指令。它可以直接使用普通智能体，也可以选择一个已启用的专家作为执行主体，适合周期性检查、报告生成、资料整理和提醒通知等无人值守场景。
这里的定时任务是团队级 AI 资源，统一在工作台「定时任务」中管理，不是某个应用设计器内部的普通自动化步骤。
谁能管理和运行定时任务
定时任务是团队级资源，不是每个能使用智能体的成员都可以创建。管理员需要先在「团队设置 → 角色权限」的「基础信息」中，为对应角色授予「定时任务管理」。
这一项权限统一控制以下操作：
- 查看团队的定时任务列表和任务详情；
- 创建、编辑和删除定时任务；
- 启用或停用定时任务；
- 点击「运行一次」手动执行任务；
- 查看任务运行历史和关联会话。
定时任务没有单独的「全部 / 仅指定 / 禁用」使用范围。没有「定时任务管理」的成员不能通过定时任务页面查看、创建、修改、手动运行或删除团队任务；仅仅拥有「允许使用 AI 智能体」并不足以管理定时任务。
如果任务要选择专家，配置人员还需要满足以下条件：
- 已被允许使用 AI 智能体；
- 角色的「可使用专家」为「全部」，或在「仅指定」中包含目标专家；
- 目标专家属于当前团队并且已经启用；
- 专家所需技能和知识库也在实际执行账号的可用范围内。
权限应按实际职责拆分。例如，可以只让少数运营管理员拥有「定时任务管理」，由他们审核周期、指令和风险；普通业务成员只使用已经授权的专家、技能和知识库，不参与无人值守任务管理。
创建人和手动运行人不是同一概念
按计划自动触发时，系统使用任务创建账号执行；点击「运行一次」时，系统使用当前点击账号执行。任务权限模式只会进一步收紧权限，不会给执行账号增加原本没有的专家、技能、知识库、数据或管理权限。因此，创建人离职、账号停用、角色调整或资源授权变化后，后续计划执行可能失败，管理员需要重新检查和验证任务。
完整的角色配置方式和界面截图，请参见AI 资源的管理权限与使用范围。
运行原理
任务到达执行时间后，系统会：
- 按任务的执行身份创建一次 AI 会话；
- 装载所选专家的职责、技能和知识库；
- 应用任务配置的权限模式；
- 把任务指令发送给智能体；
- 等待执行完成并记录会话；
- 计算下一次执行时间。
如果没有选择专家，系统会按普通智能体任务处理；如果选择了专家，则在该专家的职责和资源边界内执行。
适用场景
- 每天生成销售日报、项目风险清单或客户反馈巡检表；
- 每隔一段时间查询数据或外部服务，发现异常时发送通知；
- 每周固定时间汇总知识库资料；
- 预约一次性执行的分析、整理或提醒任务；
- 用专家定期完成结构稳定、允许无人值守的工作。
以下任务不建议直接无人值守：
- 删除、批量覆盖或不可逆修改大量数据；
- 发布应用、调整成员权限或团队管理；
- 涉及付款、合同承诺、退款赔偿等高风险决定；
- 依赖大量临时上下文、每次都需要人工追问的任务；
- 结果没有明确成功标准、无法验证的开放式任务。
示例：每日客户反馈巡检
前面已经创建了分诊技能和处理规范。本章为了让无人值守任务保持单一职责，使用一个已经准备好的“客户反馈分诊专家”；它只负责标准化分诊与巡检，不承担“客户服务专家”的持续接待、追问、回复起草等完整职责。
本例使用的资源包括：
- 技能：客户反馈分诊；
- 知识库：客户反馈处理规范；
- 专家：客户反馈分诊专家。
现在创建“每日客户反馈巡检”任务，让专家在每个工作日 09:00 生成 P0、P1 人工巡检清单。
第一步：新建任务
进入工作台，在左侧导航选择「定时任务」，点击右上角「新建定时任务」，选择手动创建。
本例配置如下：
| 配置项 | 本例 |
|---|---|
| 任务名称 | 每日客户反馈巡检 |
| 专家 | 客户反馈分诊专家 |
| 任务指令 | 从知识库提炼 P0、P1 判定标准，生成当天人工巡检清单 |
| 权限模式 | 只读模式 |
| 执行时间 | 每周一至周五 09:00 |
第二步：编写任务指令
任务指令应该描述“这一次要完成的具体工作”，而不是重复整段专家职责。
本例使用：
text
请从已绑定的客户反馈处理规范知识库中提炼 P0、P1 判定标准，
并生成一份当天的人工巡检清单。
不要调用技能或执行任何数据写入操作；
如果无法访问知识库，请明确说明原因。一个适合定时执行的指令通常包含：
- 数据或资料范围；
- 时间范围；
- 处理目标；
- 输出格式；
- 无数据、资料不足和调用失败时怎样处理；
- 是否允许写入、通知或外部操作；
- 哪些情况需要人工复核。
例如，日报任务可以写成：
text
查询昨天 00:00—23:59 的新增客户记录，按来源统计数量并列出环比变化。
输出 Markdown 表格和三条结论；没有数据时输出“昨日无新增客户”，不要生成示例数据。不建议只写“生成日报”或“检查一下数据”。这类指令缺少范围、格式和异常处理，结果难以稳定验证。
配置项说明
任务名称
任务名称用于列表、运行历史和会话标题。建议同时包含对象和动作，例如：
- 每日客户反馈巡检；
- 每周项目风险汇总；
- 每 30 分钟接口健康检查。
专家
专家是可选项：
- 不选专家：以普通智能体任务执行；
- 选择专家：使用专家职责、技能和知识库；
- 已绑定专家的启用任务，要求该专家属于当前团队并处于启用状态。
如果专家后来被停用或删除，应及时停用任务或选择替代专家。
任务指令
任务指令是每次触发时发送给 AI 的输入。不要在指令中保存密码、Token 或临时访问凭证，也不要写死只在测试环境存在的记录 ID。
权限模式
权限模式用于限定本次任务可以使用的能力，而且不会超过执行账号原本被授予的 AI 权限。
| 权限模式 | 可用能力 | 适合场景 | 风险级别 |
|---|---|---|---|
| 只读模式 | 对话、上传文件、访问外网等只读能力 | 查询、分析、报告、巡检 | 低 |
| 数据模式 | 读取和写入应用内业务数据 | 新增记录、更新状态、数据同步 | 中 |
| 设计模式 | 修改应用脚本、API、表结构等设计配置 | 受控的应用设计任务 | 高 |
| 完全访问权限 | 数据写入、发布应用、成员和团队管理等 | 严格审核的管理任务 | 很高 |
最小权限原则
默认选择只读模式。只有任务确实需要修改业务数据时才使用数据模式；设计模式和完全访问权限不建议用于常规无人值守任务。提高权限前，应先完成测试、审核、监控和回滚方案。
执行时间
系统提供三种执行方式：
| 执行方式 | 配置内容 | 适合场景 |
|---|---|---|
| 每天 | 时间点，并可选择周一至周日 | 工作日报、每周固定日巡检 |
| 按间隔 | 间隔分钟数，页面要求不能少于 10 分钟 | 状态监控、周期查询 |
| 按单次 | 指定日期和时间 | 预约提醒、一次性分析 |
“每天”模式可以只选工作日，并不一定代表七天都执行。卡片会显示实际星期和时间。
TIP
团队可创建的任务数量由部署配置决定，以页面底部提示为准。本示例环境提示每个团队最多创建 10 个定时任务。
执行身份和权限
定时任务属于团队资源，但每次执行仍然有明确账号身份：
- 按计划自动触发：使用任务创建账号作为执行账号；
- 点击“运行一次”：使用当前操作账号作为执行账号；
- 有效能力：执行账号角色权限与任务权限模式的交集；
- 专家资源：还要受到专家绑定技能、知识库和相应资源权限限制。
因此，同一个任务由不同账号点击“运行一次”，结果和可访问数据可能不同。任务创建人离职、停用或权限变化后，应由管理员检查并重新验证任务，不要假设它会永久保持原有能力。
保存、试运行和启用
保存后先停用
新任务不应直接长期运行。建议先保持停用状态，完成一次人工验证：
- 检查任务名称、专家、指令和周期；
- 点击「运行一次」；
- 等待执行完成；
- 查看运行历史和关联会话；
- 检查实际使用的权限、技能、知识库和输出；
- 确认没有不必要的数据修改或外部通知；
- 验证通过后再启用。
如果保存时已经启用，也可以立即通过卡片右上角开关停用。
运行一次
「运行一次」不会等待下一个计划时间，适合测试新建或修改后的任务。点击后需要再次确认，防止误触发真实操作。
对于写入类任务，测试环境也应使用可识别的测试数据，并检查重复运行是否会生成重复记录。
查看运行历史
点击任务卡片中的「运行历史」，可以查看该任务产生的执行记录，并点击「在会话中查看」打开对应 AI 会话。
排查时至少检查：
- 运行时间是否符合预期；
- 会话是否收到完整任务指令；
- 专家、技能和知识库是否正确装载；
- 是否出现权限不足、资源不存在或外部接口错误；
- 输出是否完整；
- 是否执行了数据修改、通知或文件生成；
- Token 消耗和运行时长是否合理。
刚触发的任务可能仍在执行。历史中已经出现记录，并不一定代表结果已经完成；应进入会话确认最终状态。
启用、停用、编辑和删除
| 操作 | 说明 |
|---|---|
| 启用 | 参与后台调度，并显示下一次执行时间 |
| 停用 | 停止后续计划触发，下一次执行时间会清空 |
| 编辑 | 修改名称、专家、指令、权限模式和周期 |
| 删除 | 永久删除任务；删除前应确认是否需要保留配置 |
修改专家、任务指令、权限模式或执行周期后，应重新「运行一次」验证。
停用任务只阻止后续计划触发，不应把它理解为撤销已经执行的数据修改、已发送通知或已创建文件。
如何设计安全的定时任务
优先把分析与写入拆开
对于高风险场景，推荐：
text
只读定时任务生成建议或待处理清单
↓
确定性规则校验 / 人工确认
↓
普通自动化或受控步骤执行写入这样可以把 AI 的判断与真实业务变更分开，便于审计、重试和回滚。
确保重复执行是安全的
定时任务可能因为人工点击、重试或调度问题被重复执行。写入类任务应做到：
- 先查询是否已经处理；
- 使用日期、业务编号等稳定条件去重；
- 更新前检查记录当前状态；
- 通知中增加唯一事件标识；
- 不要仅凭自然语言“请不要重复”保证幂等。
明确无数据和失败行为
指令中应写明：
- 没有数据时是否发送通知；
- 部分数据查询失败时是否继续；
- 外部接口不可用时怎样记录；
- 输出不符合格式时是否允许写入；
- 何时必须转人工处理。
控制频率和成本
间隔越短，模型调用、知识库检索、外部接口和 Token 消耗越高。频率应与业务时效相匹配，不要用每 10 分钟任务代替事件驱动自动化。
如果业务只在数据变化时处理，优先使用数据表自动化；如果需要固定时间汇总、判断和生成内容，再使用定时任务。
局限和注意事项
- 定时任务依赖模型、知识库、技能、网络和外部服务，任何一环异常都可能导致失败。
- 同一个任务正在运行时，系统不会再并发启动同一任务。
- 后台会话的完成等待有时间限制；特别长的任务可能超时，当前实现最长等待约 30 分钟。
- 间隔任务不适合秒级或高频实时处理，页面最低间隔为 10 分钟。
- 定时任务输出具有模型不确定性，关键结果应增加确定性校验。
- 已执行的数据修改、通知和外部操作不会因为后来停用或删除任务而自动撤销。
- 修改专家、技能、知识库或账号权限可能影响下次执行结果。
- SaaS 团队过期等部署状态可能使计划任务被跳过。
- 运行历史用于追踪 AI 会话，不应替代业务数据自身的审计日志。
上线检查清单
- [ ] 任务名称能清楚说明对象和动作；
- [ ] 任务指令包含数据范围、时间范围、输出和失败处理；
- [ ] 专家处于启用状态，职责与任务一致；
- [ ] 只绑定必要的技能和知识库；
- [ ] 使用了最低够用的权限模式；
- [ ] 已用“运行一次”验证成功和失败场景；
- [ ] 写入操作具备去重和幂等保护；
- [ ] 高风险操作存在人工确认或确定性校验；
- [ ] 已确认 Token、外部接口和运行频率成本；
- [ ] 已明确负责人和异常处理方式；
- [ ] 已检查运行历史和业务审计记录。
常见问题
列表中没有可选择的专家
确认专家属于当前团队且已经启用，再检查当前账号是否允许使用 AI，以及角色的「可使用专家」是否为「全部」或已在「仅指定」中勾选目标专家。草稿、停用或超出当前账号使用范围的专家不能作为可用执行主体。
任务已经启用，但没有按时执行
检查下一次执行时间、星期选择、团队状态和任务是否仍然启用；再查看运行历史以及专家是否可用。修改时间后至少等待页面显示新的下一次执行时间。
点击“运行一次”后，自动执行的结果不同
“运行一次”使用当前操作账号，按计划执行使用任务创建账号。检查两者角色、数据权限和 AI 权限是否一致。
运行历史有记录，但看不到最终结果
任务可能仍在运行，或者会话执行发生异常。点击「在会话中查看」，检查会话状态、错误信息和 Token 消耗，稍后刷新历史。
任务提示权限不足
检查执行账号角色权限、任务权限模式、专家资源绑定和业务数据权限。提高任务权限模式也不能超过账号本身被授予的权限。
写入类任务生成了重复数据
不要只修改提示词。应在数据写入逻辑中增加唯一条件、已处理状态或幂等键，并在再次启用前清理测试影响、补充重复运行测试。
修改任务后旧结果仍然出现
确认新的配置已经保存，并重新运行一次。历史会话保留的是当时的任务上下文，不会随着后续编辑自动改变。