Create an Agent Config

Create an Agent Config.

Body Params

Schema for creating an agent config.

string
required
length ≥ 2

The name of the agent.

required

The description of the agent.

string
required
length ≥ 2

The prompt for the agent.

uuid
required

The ID of the LLM config associated with the agent.

null

Extra configuration for the LLM.

tool_config_ids
array of uuids
required

The IDs of the tool configs associated with the agent.

Tool Config Ids*
array | null

Explicit parameter bindings for each tool.

The order and length of this list must match tool_config_ids. Each dict maps
parameter names to their ParameterBinding specifications.

If None, default bindings are computed based on tool parameter schemas:

  • Has x-hidden-from-model with default → source="fixed", fixed_value=
  • Has x-hidden-from-model without default → source="user"
  • Otherwise → source="agent"
array | null
deprecated

DEPRECATED: Use parameter_bindings instead.

input_json_schema
object

The input schema for the agent.

WARNING: This field will be required in the future.

Specifies the inputs that the agents require conforming to the JSON schema
standard.
ref: https://json-schema.org/

Note that the actual recorded input_json_schema is a combination of this provided
schema and any parameters required by the tools based on parameter_bindings.

object | null

The output schema for the agent.

Specifies the output that the agents output conforming to the JSON schema
standard.
ref: https://json-schema.org/

If None, the agent will output a string.

mcp_server_config_ids
array of uuids

IDs of MCP server configs to assign to this agent.

MCP servers provide external tools to the agent at runtime.
The tools from these servers are fetched fresh on each agent run.

Mcp Server Config Ids
tags
array of strings

If any, the tags to add to the agent config.

Tags
Responses

Language
Credentials
URL
LoadingLoading…
Response
Choose an example:
application/json