> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.alephant.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server.

# 定时任务

> 创建、运行和管理一次性或周期性智能体任务，并追踪历史结果。

定时任务让用户把已经配置好的智能体安排为一次性或周期性自动执行。它适合日报、周报、客户线索汇总、知识库巡检、运营监控、竞品观察、工单复盘和重复分析场景。

定时任务不是“绕过权限的自动化”。每次运行都会创建独立的私有智能体会话，使用任务创建者可访问的智能体配置、模型、知识和已授权操作，并把结果写入任务历史与选定投递渠道。

上图展示了定时任务的完整执行链路：用户创建任务后，AIvis 在可信控制平面校验身份、工作区、智能体和投递配置；调度服务只负责按计划触发，真正执行时会创建新的私有智能体会话；知识检索、操作调用、模型请求和结果投递分别经过授权、审批和失败记录。

## 可用性

定时任务入口通常位于 AIvis 应用侧边栏的“定时任务”，也可以从智能体相关入口创建。只有当部署已启用该能力时，页面和接口才会开放；未启用时，用户不会进入可创建任务的流程。

启用前请确认：

* 后台调度服务和任务执行服务处于运行状态。
* 至少存在一个当前用户可访问的智能体。
* 该智能体所需模型、知识库、连接器和操作已经配置完成。
* 如需邮件投递，管理员已配置邮件服务；Webhook 投递仅接受 HTTPS 地址。

## 任务包含什么

| 配置项  | 说明                                                  |
| ---- | --------------------------------------------------- |
| 任务名称 | 用于在列表和历史中识别任务，建议写清业务目标和频率。                          |
| 智能体  | 只能选择当前用户有权使用的智能体；每次运行使用该智能体的最新配置。                   |
| 执行指令 | 作为每次运行的新会话起始指令，建议明确输入范围、输出格式和失败处理方式。                |
| 调度方式 | 支持一次性运行，也支持周期运行。周期运行可使用常用的每日/每周配置，也可使用五段式 Cron 表达式。 |
| 时区   | 一次性任务使用浏览器时区确认精确 UTC 偏移；周期任务需要明确 IANA 时区。           |
| 初始状态 | 可创建为“启用”或“暂停”。暂停状态不会按计划触发，但配置会保留。                   |
| 结果投递 | 支持站内通知、邮件和 Webhook。至少需要选择一个投递渠道。                    |

## 任务生命周期

| 阶段    | 行为                                            |
| ----- | --------------------------------------------- |
| 创建    | 填写名称、智能体、指令、投递渠道和调度方式后保存。                     |
| 触发    | 到达计划时间后进入队列；也可以在详情页手动“立即运行”。                  |
| 执行    | 每次运行都会创建新的私有会话，状态会从排队、运行中进入投递或最终状态。           |
| 暂停/恢复 | 暂停后不再按计划触发；恢复后继续按配置计算下一次运行时间。                 |
| 编辑    | 可修改名称、指令、智能体、调度、状态和投递渠道。编辑时会校验任务是否已被其他人或流程更新。 |
| 完成    | 一次性任务运行后会进入完成态；如果重新调整调度，可重新变为可运行状态。           |
| 删除    | 删除任务会停止后续触发；历史可见性取决于部署的数据保留策略。                |

## 安全边界

定时任务面向无人值守场景，因此需要比普通会话更明确的安全边界：

* 任务不会授予新的模型、知识库、连接器或操作权限。
* 只能选择当前用户有权访问的智能体；不可访问的智能体不会出现在可选列表中。
* 如果智能体被删除、停用或不可访问，任务会显示不可用原因，并阻止继续运行。
* 每次运行只继承必要上下文，不会自动读取不在授权范围内的文档、密钥或外部系统。
* 高影响操作仍应通过操作权限、连接器授权和审批策略控制；未满足条件的运行会失败、跳过或等待用户处理。
* Webhook 投递要求 HTTPS，且不能在 URL 中携带用户名或密码。

## 投递与历史

定时任务支持多渠道投递，运行是否成功不仅取决于智能体执行，还取决于所选渠道是否接受结果：

| 渠道      | 适用场景                     | 注意事项                         |
| ------- | ------------------------ | ---------------------------- |
| 站内通知    | 默认结果提醒和产品内追踪。            | 适合所有任务，建议保留。                 |
| 邮件      | 日报、周报、监控摘要、面向业务收件人的结果推送。 | 需要管理员完成邮件服务配置；未配置时用户会看到配置提示。 |
| Webhook | 把结果发送到内部系统、告警平台或自动化流程。   | 仅支持 HTTPS 地址；接收方失败会反映在投递结果中。 |

任务详情页会展示运行历史，包括触发来源、开始/结束时间、状态、摘要、错误信息、跳过原因、投递结果以及可打开的关联会话。若运行等待审批，用户可以打开关联会话继续处理。

## 运维与治理

企业环境中建议把定时任务纳入治理流程：

* 为高频任务设置清晰的所有者、输出格式和业务用途。
* 对会产生费用的模型、长上下文检索或外部操作设置消费限额。
* 对外发邮件、调用 Webhook 或触发业务系统的任务，先使用低风险目标做测试。
* 周期任务可能长期运行，建议定期审查仍然有效的任务、收件人和 Webhook 地址。
* 对关键日报、巡检和告警类任务，监控失败、跳过、等待审批和投递失败状态。
* 如果任务结果需要作为审计材料，保留任务历史、投递记录和关联会话。

## 验证

上线或开放给团队前，建议完成以下验证：

* 创建一个一次性任务，选择站内通知并手动立即运行。
* 创建一个周期任务，确认下一次运行时间按预期时区计算。
* 暂停并恢复任务，确认暂停期间不会触发，恢复后重新计算下一次运行。
* 使用一个不可用或权限不足的智能体场景，确认任务不会越权执行。
* 配置邮件投递，确认未配置邮件服务时会给出明确提示；配置完成后结果可送达。
* 配置 HTTPS Webhook，确认接收方成功和失败都会写入投递结果。
* 查看运行历史，确认成功、失败、跳过、等待审批和错误信息可追踪。

## 常见问题排查

| 现象          | 可能原因                            | 处理方式                              |
| ----------- | ------------------------------- | --------------------------------- |
| 看不到定时任务入口   | 部署未启用定时任务能力，或当前用户没有基础访问权限。      | 联系管理员确认功能开关和用户权限。                 |
| 无法创建任务      | 没有可访问的智能体、指令为空、调度格式错误或投递渠道无效。   | 先选择可访问智能体，补全指令，检查时间、Cron、时区和投递配置。 |
| 邮件投递不可选或失败  | 邮件服务未配置，或发件域/收件人配置不符合要求。        | 让管理员配置邮件服务，并用测试任务验证。              |
| Webhook 被拒绝 | URL 不是 HTTPS，包含用户名/密码，或接收方返回错误。 | 使用不含凭据的 HTTPS 地址，并检查接收方日志。        |
| 任务被跳过       | 上一次运行仍未结束，或任务能力在运行时不可用。         | 查看运行历史中的跳过原因，必要时降低频率或排查后台服务。      |
| 运行等待审批      | 任务触发了需要用户确认的操作。                 | 打开关联会话完成审批，或调整智能体和操作策略。           |
| 运行失败但没有结果   | 模型、知识库、连接器、外部系统或投递渠道异常。         | 从运行历史查看错误详情，再按对应依赖逐项排查。           |

## 相关页面

* [智能体](/aivis/agents/agents)
* [MCP 操作](/aivis/agents/mcp-actions)
* [OpenAPI 操作](/aivis/agents/openapi-actions)
* [用量](/aivis/governance/usage)
* [消费限额](/aivis/governance/spending-limits)