ai-agents
agents
execute

Executar agente

Changed on

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

  • Base URL: https://api.olie.ai
  • URL: https://api.olie.ai/api/management/ai/agents/{agentId}/execute
  • Auth: HTTP bearer

Request body

promptstring required

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

modelstring

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

providerstring

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

  • fbae0c094507Revision changes
    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

  • d71b18b1685dRevision changes
    • breaking

      the request property became required

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response's property type changed from integer to number for status

    • warning

      added the new anthropic enum value to the / response property for the response status

    • warning

      added the new disabled enum value to the response property for the response status

    • warning

      added the new failed enum value to the response property for the response status

    • warning

      added the new google enum value to the / response property for the response status

    • warning

      added the new openai enum value to the / response property for the response status

    • warning

      added the new openrouter enum value to the / response property for the response status

    • info

      added the new optional request property

    • info

      added the new optional request property