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.

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.

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

Call sequence

  1. First list agents 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.

API operations

Create and view agents

What you need to do

API operation

Use it when

Create an agent

Create an agent

Create a new agent.

Query agents

List agents

Select a target agent or confirm creation.

Query agent details

Get an agent

Confirm a target agent before updating, deleting, or binding resources.

Update an agent

Update an agent

You have the agent ID and need to update its information.

Manage agent versions

What you need to do

API operation

Use it when

Query agent versions

List agent versions

Select or confirm a target version.

Set the default version

Set the default agent version

Change the default version.

Disable an agent version

Disable an agent version

Confirm conditions and results on the action page before disabling.

Delete an agent version

Delete an agent version

Confirm impact and conditions on the action page before deletion.

Delete an agent

What you need to do

API operation

Use it when

Delete an agent

Delete an agent

Confirm impact and conditions on the action page before deletion.

Confirm the result

After creation or an update, use Get an agent to confirm current information. After adjusting versions, use List agent versions to confirm the target version. After deletion, use details or the list to confirm whether the object remains available.

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.

Next steps

Last updated on