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¶
First list agents to determine whether to maintain an existing agent or create a new one.
Retain the agent ID after creation. To modify an agent, get its details before submitting an update.
To adjust versions, list versions, choose a target version, then set it as default or disable it.
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 a new agent. |
|
Query agents |
Select a target agent or confirm creation. |
|
Query agent details |
Confirm a target agent before updating, deleting, or binding resources. |
|
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 |
Select or confirm a target version. |
|
Set the default version |
Change the default version. |
|
Disable an agent version |
Confirm conditions and results on the action page before disabling. |
|
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 |
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.