Create Agent Instance

POST

/api/v1/ai/agents/instances

• API de Produção

Create new agent instance from template or from scratch. If template_id is provided, uses template as base. Otherwise, uses provided configuration directly.

Authorizations

• HTTPBearer

Parameters

Header Parameters

x-tenant-id

Any of:

integer

integer

null

null

Request Body ^required

AgentInstanceCreate

Schema para criar AgentInstance

object

name

required

Name

string

>= 1 characters <= 255 characters

description

Any of:

string

string

null

null

custom_config

Any of:

object

object

null

null

execution_schedule

Any of:

string

string

<= 100 characters

null

null

auto_execute

Auto Execute

boolean

context_filter

Any of:

object

object

null

null

tags

Tags

Array<string>

extra_metadata

Extra Metadata

object

template_id

Any of:

integer

integer

> 0

null

null

assigned_to

Any of:

integer

integer

null

null

status

string

Allowed values: active paused disabled

provider

Any of:

string

string

null

null

model

Any of:

string

string

null

null

system_prompt

Any of:

string

string

null

null

temperature

Any of:

number

number

null

null

max_tokens

Any of:

integer

integer

null

null

max_iterations

Any of:

integer

integer

null

null

max_execution_time

Any of:

integer

integer

null

null

enable_memory

Any of:

boolean

boolean

null

null

enable_learning

Any of:

boolean

boolean

null

null

tools

Any of:

Array<string>

Array<string>

null

null

execution_mode

Any of:

string

string

null

null

Responses

201

Successful Response

AgentInstanceResponse

Schema de resposta para AgentInstance

object

name

required

Name

string

>= 1 characters <= 255 characters

description

Any of:

string

string

null

null

custom_config

Any of:

object

object

null

null

execution_schedule

Any of:

string

string

<= 100 characters

null

null

auto_execute

Auto Execute

boolean

context_filter

Any of:

object

object

null

null

tags

Tags

Array<string>

extra_metadata

Extra Metadata

object

id

required

Id

integer

template_id

Any of:

integer

integer

null

null

template_type

Any of:

string

string

null

null

status

required

AgentStatusEnum

Status de um agente

string

Allowed values: active paused disabled

is_active

required

Is Active

boolean

created_by

required

Created By

integer

assigned_to

required

Any of:

integer

integer

null

null

total_executions

required

Total Executions

integer

successful_executions

required

Successful Executions

integer

failed_executions

required

Failed Executions

integer

last_execution_at

required

Any of:

string

string format: date-time

null

null

total_cost

required

Total Cost

object

created_at

required

Created At

string format: date-time

updated_at

required

Updated At

string format: date-time

422

Validation Error

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string