# 自动化任务、回调和任务模板

创建和运行自动化任务，维护回调规则，并管理可复用的智能体任务模板。本页不负责观察运行时任务；运行观测请转到相邻任务页。

## 前提条件

准备可访问目标工作区的凭据，以及自动化任务、回调规则或模板所需的来源资源标识。有关服务地址、认证和通用请求格式，请参阅 [调用前准备](../../api-call-basics.md)。

启动自动化任务前先确认目标任务；需要接收回调时先管理相应回调规则。

## 调用顺序

1. 创建任务模板或查询已有模板，确定可复用的任务定义。
2. 创建自动化任务后保留任务标识；需要调整时先查询详情，再更新任务。
3. 启动任务运行后，使用运行详情、事件和结果动作分别查看可观察的运行信息。
4. 管理回调规则时，先查询目标规则，再创建、更新或删除；归档任务前先确认其影响。

## API 操作

### 管理自动化任务和运行

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 创建自动化任务 | [创建自动化任务](../../../../reference/api/ai-studio/agents/automation-tasks/create-task.md) | 需要新建自动化任务时使用。 |
| 查询自动化任务列表 | [查询自动化任务列表](../../../../reference/api/ai-studio/agents/automation-tasks/list-tasks.md) | 选择或确认目标任务时使用。 |
| 查询自动化任务详情 | [查询自动化任务详情](../../../../reference/api/ai-studio/agents/automation-tasks/get-task.md) | 更新、启动或归档前确认目标任务时使用。 |
| 更新自动化任务 | [更新自动化任务](../../../../reference/api/ai-studio/agents/automation-tasks/update-task.md) | 已取得任务标识，需要修改时使用。 |
| 启动自动化任务运行 | [启动自动化任务运行](../../../../reference/api/ai-studio/agents/automation-tasks/start-task-run.md) | 已确认任务，需要提交一次运行时使用。 |
| 查询自动化任务运行详情 | [查询自动化任务运行详情](../../../../reference/api/ai-studio/agents/automation-tasks/get-run.md) | 已取得运行标识，需要查看运行信息时使用。 |
| 查询自动化任务运行事件 | [查询自动化任务运行事件](../../../../reference/api/ai-studio/agents/automation-tasks/list-run-events.md) | 查看目标运行的事件时使用。 |
| 查询自动化任务运行结果 | [查询自动化任务运行结果](../../../../reference/api/ai-studio/agents/automation-tasks/get-run-result.md) | 查看目标运行的结果时使用。 |
| 归档自动化任务 | [归档自动化任务](../../../../reference/api/ai-studio/agents/automation-tasks/archive-task.md) | 归档前先在动作页确认影响和条件。 |

### 管理回调规则

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 创建回调规则 | [创建回调规则](../../../../reference/api/ai-studio/agents/callback-rules/create-callback-rule.md) | 需要为任务设置回调规则时使用。 |
| 查询回调规则列表 | [查询回调规则列表](../../../../reference/api/ai-studio/agents/callback-rules/list-callback-rules.md) | 选择或确认目标规则时使用。 |
| 查询回调规则详情 | [查询回调规则详情](../../../../reference/api/ai-studio/agents/callback-rules/get-callback-rule.md) | 更新或删除前确认目标规则时使用。 |
| 更新回调规则 | [更新回调规则](../../../../reference/api/ai-studio/agents/callback-rules/update-callback-rule.md) | 已取得规则标识，需要修改时使用。 |
| 删除回调规则 | [删除回调规则](../../../../reference/api/ai-studio/agents/callback-rules/delete-callback-rule.md) | 删除前先在动作页确认影响和条件。 |

### 管理智能体任务模板

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 创建智能体任务模板 | [创建智能体任务模板](../../../../reference/api/ai-studio/agents/task-templates/create-task-template.md) | 需要创建可复用模板时使用。 |
| 查询智能体任务模板列表 | [查询智能体任务模板列表](../../../../reference/api/ai-studio/agents/task-templates/list-task-templates.md) | 选择或确认模板时使用。 |
| 查询智能体任务模板详情 | [查询智能体任务模板详情](../../../../reference/api/ai-studio/agents/task-templates/get-task-template.md) | 更新前确认目标模板时使用。 |
| 更新智能体任务模板 | [更新智能体任务模板](../../../../reference/api/ai-studio/agents/task-templates/update-task-template.md) | 已取得模板标识，需要修改时使用。 |

## 结果确认

启动运行后，使用[查询自动化任务运行详情](../../../../reference/api/ai-studio/agents/automation-tasks/get-run.md)、[查询自动化任务运行事件](../../../../reference/api/ai-studio/agents/automation-tasks/list-run-events.md)和[查询自动化任务运行结果](../../../../reference/api/ai-studio/agents/automation-tasks/get-run-result.md)确认结果。任务、回调规则和模板的变更分别通过其详情或列表动作确认。

## 限制和注意事项

归档任务和删除回调规则会影响目标对象。执行前请在对应动作页确认条件和结果。

## 下一步

- [监测运行与处理反馈](runtime-observability-feedback.md)
- [调用智能体和管理会话](agent-invocation-sessions.md)