# 创建和维护智能体

创建智能体、维护其版本并确定默认版本。本页不配置模型、工具或知识库绑定；这些资源由相邻任务页管理。

## 前提条件

准备可访问目标工作区的凭据。有关服务地址、认证和通用请求格式，请参阅 [首次调用 AI Studio API](../../../quickstart/index.md)。

更新、设为默认版本、停用或删除前，先从智能体列表、详情或版本列表中获取目标智能体和版本标识。

## 调用顺序

1. 先[查询智能体列表](../../../../reference/api/ai-studio/agents/agents/list-agents.md)，确认是维护已有智能体还是创建新的智能体。
2. 创建后保留智能体标识；需要修改时先查询详情，再提交更新。
3. 需要调整版本时，查询版本列表，选择目标版本后设为默认版本或停用版本。
4. 删除智能体或版本前，先确认要删除的对象及动作页中的条件和影响。

## API 操作

### 创建和查看智能体

| 任务 | 何时使用 |
| --- | --- |
| [创建智能体](../../../../reference/api/ai-studio/agents/agents/create-agent.md) | 需要新建智能体时使用。 |
| [查询智能体列表](../../../../reference/api/ai-studio/agents/agents/list-agents.md) | 选择目标智能体或确认创建结果时使用。 |
| [查询智能体详情](../../../../reference/api/ai-studio/agents/agents/get-agent.md) | 更新、删除或绑定资源前确认目标智能体时使用。 |
| [更新智能体](../../../../reference/api/ai-studio/agents/agents/update-agent.md) | 已取得智能体标识，需要更新其信息时使用。 |

### 管理智能体版本

| 任务 | 何时使用 |
| --- | --- |
| [查询智能体版本](../../../../reference/api/ai-studio/agents/agents/list-agent-versions.md) | 选择或确认目标版本时使用。 |
| [设置智能体默认版本](../../../../reference/api/ai-studio/agents/agents/set-default-agent-version.md) | 需要调整默认版本时使用。 |
| [停用智能体版本](../../../../reference/api/ai-studio/agents/agents/disable-agent-version.md) | 停用前先在动作页确认条件和结果。 |
| [删除智能体版本](../../../../reference/api/ai-studio/agents/agents/delete-agent-version.md) | 删除前先在动作页确认影响和条件。 |

### 删除智能体

| 任务 | 何时使用 |
| --- | --- |
| [删除智能体](../../../../reference/api/ai-studio/agents/agents/delete-agent.md) | 删除前先在动作页确认影响和条件。 |

## 结果确认

创建或更新后，使用[查询智能体详情](../../../../reference/api/ai-studio/agents/agents/get-agent.md)确认当前信息；版本调整后使用[查询智能体版本](../../../../reference/api/ai-studio/agents/agents/list-agent-versions.md)确认目标版本。删除后通过详情或列表确认对象是否仍可查询。

## 限制和注意事项

停用和删除会改变智能体或版本的可用状态。执行前请在对应动作页确认影响和条件。

## 下一步

- [配置模型、运行环境和策略](model-runtime-policies.md)
- [连接工具、技能和通道](tools-skills-channels.md)
- [调用智能体和管理会话](agent-invocation-sessions.md)
