# 智能体构建

智能体构建 API 使用模型、工具、技能和知识库生成候选版本，并在检查通过后提交为可运行版本。它用于创建或修订智能体，不负责向已经发布的智能体发送消息。

## 构建如何工作

1. 读取当前工作区可用于构建的模型、工具、技能和知识库。
2. 提交创建或修订请求，生成候选版本。
3. 检查候选版本的状态、诊断信息和已解析资源。
4. 需要调整时，重新生成候选版本；不再使用时可以取消。
5. 提交候选版本，并保存返回的版本和摘要信息。
6. 读取当前生效的智能体配置，确认提交结果。

候选版本有效不表示已经成为可运行版本；只有提交完成并能读取到当前智能体配置后，才进入调用验证。

## 什么时候使用

- 从模型、提示词、工具、技能和知识库组合一个新智能体；
- 修改现有智能体的资源绑定或行为说明；
- 在提交前检查资源引用和诊断结果。

仅需调用现有智能体时，请使用[调用智能体](../../product-api/agents-a2a/index.md)。

## 从哪里开始

- [构建并提交智能体](build-publish-agent.md)
- [查询智能体构建 API](api-reference.md)

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

构建并提交智能体 <build-publish-agent>
API 参考 <api-reference>
```