<span id="创建和维护智能体"></span>

# Create and maintain agents

Create agents, maintain their versions, and set the default version. This page does not configure models, tools, or knowledge-base bindings; adjacent task pages manage those resources.

<span id="前提条件"></span>

## Prerequisites

Prepare credentials that can access the target workspace. For service endpoints, authentication, and general request formats, see [Call the AI Studio API for the first time](../../../quickstart/index.md).

Before updating, setting a default version, disabling, or deleting, obtain target agent and version IDs from the agent list, details, or version list.

<span id="调用顺序"></span>

## Call sequence

1. First [list agents](../../../../reference/api/ai-studio/agents/agents/list-agents.md) to determine whether to maintain an existing agent or create a new one.
2. Retain the agent ID after creation. To modify an agent, get its details before submitting an update.
3. To adjust versions, list versions, choose a target version, then set it as default or disable it.
4. Before deleting an agent or version, confirm the object to delete and the conditions and impact on the action page.

<span id="api-操作"></span>

## API operations

<span id="创建和查看智能体"></span>

### Create and view agents

| What you need to do | API operation | Use it when |
| --- | --- | --- |
| Create an agent | [Create an agent](../../../../reference/api/ai-studio/agents/agents/create-agent.md) | Create a new agent. |
| Query agents | [List agents](../../../../reference/api/ai-studio/agents/agents/list-agents.md) | Select a target agent or confirm creation. |
| Query agent details | [Get an agent](../../../../reference/api/ai-studio/agents/agents/get-agent.md) | Confirm a target agent before updating, deleting, or binding resources. |
| Update an agent | [Update an agent](../../../../reference/api/ai-studio/agents/agents/update-agent.md) | You have the agent ID and need to update its information. |

<span id="管理智能体版本"></span>

### Manage agent versions

| What you need to do | API operation | Use it when |
| --- | --- | --- |
| Query agent versions | [List agent versions](../../../../reference/api/ai-studio/agents/agents/list-agent-versions.md) | Select or confirm a target version. |
| Set the default version | [Set the default agent version](../../../../reference/api/ai-studio/agents/agents/set-default-agent-version.md) | Change the default version. |
| Disable an agent version | [Disable an agent version](../../../../reference/api/ai-studio/agents/agents/disable-agent-version.md) | Confirm conditions and results on the action page before disabling. |
| Delete an agent version | [Delete an agent version](../../../../reference/api/ai-studio/agents/agents/delete-agent-version.md) | Confirm impact and conditions on the action page before deletion. |

<span id="删除智能体"></span>

### Delete an agent

| What you need to do | API operation | Use it when |
| --- | --- | --- |
| Delete an agent | [Delete an agent](../../../../reference/api/ai-studio/agents/agents/delete-agent.md) | Confirm impact and conditions on the action page before deletion. |

<span id="结果确认"></span>

## Confirm the result

After creation or an update, use [Get an agent](../../../../reference/api/ai-studio/agents/agents/get-agent.md) to confirm current information. After adjusting versions, use [List agent versions](../../../../reference/api/ai-studio/agents/agents/list-agent-versions.md) to confirm the target version. After deletion, use details or the list to confirm whether the object remains available.

<span id="限制和注意事项"></span>

## Limitations and notes

Disabling or deleting changes the availability of an agent or version. Confirm impact and conditions on the corresponding action page before proceeding.

<span id="下一步"></span>

## Next steps

- [Configure models, runtimes, and policies](model-runtime-policies.md)
- [Connect tools, skills, and channels](tools-skills-channels.md)
- [Invoke agents and manage sessions](agent-invocation-sessions.md)
