# 自动化任务

自动化任务把一个已发布智能体和一种触发方式组合成可重复运行的任务。你可以通过 API、计划或第三方事件启动运行，并使用历史记录 ID 查询状态、结果和事件。

## 什么时候使用

适合使用自动化任务的情况：

- 需要周期运行智能体；
- 需要向一个固定服务名称提交结构化输入；
- 需要由 GitHub、企业微信、飞书或 Slack 等第三方事件触发智能体；
- 需要保留每次运行的独立状态、结果和事件记录。

如果应用需要与智能体保持会话或补充输入，请使用[调用智能体](../../product-api/agents-a2a/index.md)。如果任务由多个确定的数据处理步骤组成，请使用[工作流](../../product-api/workflows-workitems-lineage/index.md)。

## 一次运行如何工作

1. 创建自动化任务，指定智能体、指令和触发方式。
2. 启用任务，或者在需要时保留为停用状态。
3. 通过 API、手动操作、计划或回调事件触发一次运行。
4. 保存响应中的历史记录 ID，并查询历史记录状态。
5. 历史记录进入终态后，读取文本、结构化输出、Artifact 引用或错误。
6. 需要了解运行过程时，按历史记录 ID 查询事件。

创建任务只定义运行方式，不会自动证明任务已经执行成功。第一次接入时，建议先使用低风险输入触发一次运行并检查结果。

## 从哪里开始

- [创建和管理自动化任务](manage-tasks.md)
- [运行自动化任务并读取历史记录](run-tasks.md)
- [查询自动化任务 API](api-reference.md)

```{toctree}
:hidden:
:maxdepth: 1

创建和管理自动化任务 <manage-tasks>
运行自动化任务并读取历史记录 <run-tasks>
API 参考 <api-reference>
```