Agents
Create and interact with AI agents that can use tools and corpora to perform complex queries.
Create agent
Creates an agent. An agent is defined by three things: the **instructions** it follows, the **steps** it executes when it receives an input, and the **tools** it can call. Instructions are attached to each step and determine the agent's behavior on that step.
List agents
Lists all agents available to the authenticated user. Results are paginated.
Get agent
Returns the complete configuration of an agent, including its tools, instructions, model parameters, and metadata.
Update agent
Updates part of an agent's configuration, including its tools, instructions, model parameters, and metadata.
Replace agent
Replaces the complete configuration of an existing agent, including its steps, instructions, tool configurations, and model. Unlike Update agent, which changes only the fields in the request, this operation replaces the whole agent definition.
Delete agent
Deletes an agent and its configuration. Deletion is permanent. If active sessions or other constraints block the deletion, the request returns an error instead.