# 搭建智能体

为已有智能体生成、重新生成、确认或取消候选方案，并查看搭建过程中可用的资源。本页不负责智能体的常规创建和版本管理。

## 前提条件

准备可访问目标工作区的凭据和要搭建的智能体标识。有关服务地址、认证和通用请求格式，请参阅 [调用前准备](../../api-call-basics.md)。

候选方案的输入和后续可用操作以各动作页为准；提交候选方案不等于已成为当前配置，需通过确认动作完成提交。

## 调用顺序

1. 先[查询当前智能体配置](../../../../reference/api/ai-studio/agents/agent-builder/get-current-agent.md)，确认当前配置和目标智能体。
2. 查询可用于搭建的资源，再生成候选方案。
3. 需要调整候选内容时重新生成；确定采用时确认候选方案，不再采用时取消。
4. 完成后再次查询当前智能体配置，确认当前配置结果。

## API 操作

### 查看配置和可用资源

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询当前智能体配置 | [查询当前智能体配置](../../../../reference/api/ai-studio/agents/agent-builder/get-current-agent.md) | 开始搭建前或确认提交结果时使用。 |
| 查询智能体搭建可用资源 | [查询智能体搭建可用资源](../../../../reference/api/ai-studio/agents/agent-builder/list-authoring-resources.md) | 生成候选方案前了解可用资源时使用。 |

### 生成和处理候选方案

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 生成智能体候选方案 | [生成智能体候选方案](../../../../reference/api/ai-studio/agents/agent-builder/propose-candidate.md) | 基于当前目标生成候选方案时使用。 |
| 重新生成智能体候选方案 | [重新生成智能体候选方案](../../../../reference/api/ai-studio/agents/agent-builder/repropose-candidate.md) | 需要调整候选方案时使用。 |
| 确认智能体候选方案 | [确认智能体候选方案](../../../../reference/api/ai-studio/agents/agent-builder/commit-candidate.md) | 已确定采用候选方案时使用。 |
| 取消智能体候选方案 | [取消智能体候选方案](../../../../reference/api/ai-studio/agents/agent-builder/cancel-candidate.md) | 不再采用候选方案时使用。 |

## 结果确认

确认候选方案后，使用[查询当前智能体配置](../../../../reference/api/ai-studio/agents/agent-builder/get-current-agent.md)查看当前配置。候选状态和提交条件以对应动作页为准。

## 下一步

- [创建和维护智能体](agents.md)
- [连接工具、技能和通道](tools-skills-channels.md)