> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeus.agentspro.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 自动化任务

> 定时调度 AI Agent 自动执行任务

## 概述

Zeus 的自动化任务功能允许你定时调度 AI Agent 自动执行提示词 — 无论是每日报告、每周代码审查，还是一次性的数据处理任务。任务完成后，Zeus 会通过邮件、飞书或站内通知将执行结果推送给你。

***

## 创建任务

进入 **设置 > 自动化任务** 即可创建新的定时任务。每个任务需要配置以下内容：

### 基本设置

| 配置项      | 说明                                          |
| -------- | ------------------------------------------- |
| **任务标题** | 为任务取一个描述性的名称                                |
| **提示词**  | Agent 将执行的指令 — 与在聊天中发送消息一样                  |
| **连接器**  | 可选 — 绑定 Browser 或 Desktop 连接器，用于需要 UI 操作的任务 |

### 调度设置

| 配置项      | 选项                 | 说明             |
| -------- | ------------------ | -------------- |
| **调度日期** | 日期选择器              | 首次（或唯一一次）执行的日期 |
| **调度时间** | 时间选择器（如 "09:00"）   | 每天执行的时间点       |
| **时区**   | 用户所在时区             | 确保任务在正确的本地时间执行 |
| **重复类型** | 不重复 / 每天 / 每周 / 每月 | 任务的循环频率        |

### 运行模式

| 模式       | 行为                            |
| -------- | ----------------------------- |
| **自动执行** | Agent 完全自主执行，无需用户干预           |
| **需确认**  | Agent 在执行敏感操作前暂停，等待你的审批（HITL） |

### 通知设置

配置任务完成后的通知方式：

| 渠道       | 说明               |
| -------- | ---------------- |
| **邮件**   | 通过邮件接收执行结果       |
| **飞书**   | 通过飞书集成接收消息       |
| **站内通知** | 在 Zeus 的通知中心查看结果 |

可以同时启用多个通知渠道。

***

## 任务生命周期

一个定时任务会经历以下状态：

```mermaid theme={null}
stateDiagram-v2
    [*] --> Pending: 创建
    Pending --> Running: 到达调度时间
    Running --> Completed: 执行成功
    Running --> Failed: 执行出错
    Pending --> Paused: 用户暂停
    Paused --> Pending: 用户恢复
    Pending --> Cancelled: 用户取消
    Completed --> Pending: 循环任务重新调度
```

| 状态            | 说明               |
| ------------- | ---------------- |
| **Pending**   | 任务已调度，等待下次执行时间   |
| **Running**   | Agent 正在执行任务     |
| **Completed** | 执行成功完成 — 可查看结果   |
| **Failed**    | 执行遇到错误 — 可查看错误详情 |
| **Paused**    | 任务临时暂停 — 恢复前不会执行 |
| **Cancelled** | 任务已被永久取消         |

对于循环任务，每次成功执行后状态会自动回到 **Pending**，并更新下次执行时间。

***

## 查看结果

任务完成后，你可以通过两种方式查看执行结果：

1. **通知** — 查看收到的通知（邮件、飞书或站内通知）获取结果摘要
2. **任务详情** — 在任务列表中点击任务，查看完整的 Agent 会话，包括所有消息、工具调用和输出

每次执行都会创建一个独立的会话，你可以查看每次运行的完整历史记录。

***

## 管理任务

在**自动化任务**页面，你可以：

* **编辑** — 更新现有任务的提示词、调度设置或通知配置
* **暂停 / 恢复** — 临时挂起任务，无需删除
* **删除** — 永久移除任务及其调度
* **查看历史** — 查看过去的执行结果、运行次数、上次/下次运行时间

***

## 使用场景

| 场景         | 示例提示词                     | 调度方式      |
| ---------- | ------------------------- | --------- |
| **每日站会摘要** | "总结团队昨天的 GitHub 提交和待审 PR" | 每天 9:00   |
| **周报生成**   | "基于本周完成的 Jira 任务生成周报"     | 每周一 10:00 |
| **数据监控**   | "检查错误率仪表板，如超过 5% 则告警"     | 每天，每 6 小时 |
| **内容发布**   | "根据内容日历撰写并发布今天的社媒帖子"      | 每天 8:00   |
| **代码审查提醒** | "列出所有超过 48 小时未审查的 PR"     | 每天 14:00  |

***

## 架构

自动化系统基于双组件架构构建：

```mermaid theme={null}
flowchart LR
    subgraph Web["Web (Next.js)"]
        UI["任务管理界面"]
        API["API 与数据库"]
    end

    subgraph Backend["AI Backend (Python)"]
        Scheduler["调度器"]
        Agent["Agent 执行"]
        Notify["通知服务"]
    end

    UI -->|"创建 / 编辑 / 删除"| API
    API -->|"同步调度"| Scheduler
    Scheduler -->|"到达时间触发"| Agent
    Agent -->|"更新结果"| API
    Agent -->|"发送通知"| Notify
```

| 组件                      | 职责                 |
| ----------------------- | ------------------ |
| **Web (Next.js)**       | 任务增删改查、用户认证、结果存储   |
| **AI Backend (Python)** | 调度管理、Agent 执行、通知发送 |

**可靠性保障**：当 AI Backend 重启时，会自动从 Web API 同步所有待执行任务，确保不遗漏任何调度任务。