Skip to main content
POST
Executar agente

Authorizations

Authorization
string
header
required

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

Path Parameters

agentId
string
required

ID (UUID) do agente de IA a ser executado.

Body

application/json

Entrada da execução do agente.

prompt
string
required

Instrução enviada ao agente. Passa pelo motor de templates antes de chegar ao modelo.

model
string

Modelo a usar apenas nesta execução; quando ausente ou nulo vale o modelo padrão do agente.

provider
enum<string>

Provedor a usar apenas nesta execução; quando ausente ou nulo vale o provedor padrão do agente.

Available options:
openrouter,
google,
openai,
anthropic,
null

Response

Sucesso

Execução criada e enfileirada.

response
boolean

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

execution
object

Execução recém-enfileirada, ainda sem resultado.