Skip to main content
POST
Criar agente de IA

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Dados para criar um agente de IA.

description
string
required

Descrição curta do agente. No modo de geração automática é a partir dela que o agente inteiro é redigido.

Maximum string length: 255
name
string

Nome do agente. Obrigatório quando auto_generate é falso ou ausente.

Maximum string length: 255
default_provider
enum<string>

Provedor de IA padrão do agente. Obrigatório quando auto_generate é falso ou ausente.

Available options:
openrouter,
google,
openai,
anthropic
default_model
string

Identificador do modelo padrão, conforme o id devolvido pelo catálogo de modelos disponíveis. Obrigatório quando auto_generate é falso ou ausente.

base_prompt
string

Prompt base que define o comportamento do agente.

tools
string[]

Ferramentas que o agente pode usar; nomes fora do catálogo são rejeitados.

Nome de uma ferramenta, conforme o name devolvido pelo catálogo de ferramentas disponíveis.

auto_generate
boolean

Quando verdadeiro, nome, prompt base, ferramentas e contextos iniciais são gerados a partir de description e os demais campos enviados são ignorados.

Response

Sucesso

Agente criado no modo manual.

response
boolean

Indicador de sucesso da requisição; sempre verdadeiro nesta resposta.

agent
object

Agente recém-criado, ainda sem execuções nem contadores.