ai-agents
agents
execute

Executar agente

Dispara uma execução do agente: o prompt passa pelo motor de templates e a execução entra na fila de processamento. A resposta devolve o registro recém-criado, ainda sem resultado — o texto gerado, os tokens, os créditos consumidos e os passos aparecem depois no detalhe da execução. model e provider são opcionais e, quando enviados, substituem os padrões do agente apenas nesta execução.

post/api/management/ai/agents/{agentId}/execute

Request body

promptstring required

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

modelstring nullable

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

provider'openrouter' | 'google' | 'openai' | 'anthropic' | 'null' nullable

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

Response

Sucesso

responseboolean

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

Changes