Pular para o conteúdo principal
POST /agents/{id}/execute Executar um agente específico por ID.

​
Exemplos de Código

curl --request POST \
  --url 'https://api.tess.im/agents/{id}/execute' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "temperature": "1",
    "model": "tess-5",
    "messages": [
        { "role": "user", "content": "Hello, how can you help me today?" }
    ],
    "tools": "no-tools",
    "wait_execution": false,
    "file_ids": [123, 321]
  }'

​
Cabeçalhos

ParâmetroTipoObrigatórioDescrição
x-workspace-idintegerNãoID do workspace. Se não fornecido, o workspace selecionado pelo usuário será usado.
Nota: Este campo será obrigatório em uma versão futura da API. É altamente recomendado defini-lo agora para garantir compatibilidade com atualizações futuras.

​
Parâmetros de Caminho

ParâmetroTipoObrigatórioDescrição
idintegerSimO ID do agente

​
Corpo da Requisição

ParâmetroTipoObrigatórioDescrição
answersobjectSimAs respostas do agente
messagesarrayApenas para Agente ChatAs mensagens do agente
wait_executionbooleanNãoIndica se a execução deve aguardar até a conclusão. O timeout é de 100 segundos. Para execuções mais longas, use wait_execution=false em combinação com o endpoint Obter Resposta do Agente com uma estratégia de polling (padrão: false).
file_idsarrayNãoArray de IDs de arquivo para anexar à execução.

​
Funções das Mensagens (Modelos do Tipo Chat)

Para modelos do tipo chat, o array messages suporta as seguintes funções:
FunçãoObrigatórioDescrição
userSimMensagens do usuário. Devem ser emparelhadas com mensagens assistant.
assistantSimMensagens do assistente. Devem ser emparelhadas com mensagens user.
developerNãoMensagem opcional do desenvolvedor. Permitida apenas como a primeira mensagem no array.
systemNãoNão suportado. Usar esta função causará um erro.
Regras importantes:
  • As mensagens devem alternar entre as funções user e assistant (após a mensagem opcional developer).
  • A função developer só pode aparecer como a primeira mensagem no array e será extraída antes do processamento do restante.
  • Se duas mensagens consecutivas tiverem a mesma função (por exemplo, duas mensagens user), a API retornará um erro de validação: “Chat messages must be a pair of user/assistant”.
  • A função system não é suportada e causará um erro.
Exemplo com mensagem developer: 
{
  "messages": [
    { "role": "developer", "content": "Você é um assistente prestativo." },
    { "role": "user", "content": "Olá!" },
    { "role": "assistant", "content": "Oi! Como posso ajudá-lo?" },
    { "role": "user", "content": "Como está o tempo?" }
  ]
}
Exemplo sem mensagem developer: 
{
  "messages": [
    { "role": "user", "content": "Olá!" },
    { "role": "assistant", "content": "Oi! Como posso ajudá-lo?" },
    { "role": "user", "content": "Como está o tempo?" }
  ]
}
Obter mais detalhes sobre quais opções são aceitas por este Agente solicitando este endpoint: Obter Agente

​
Resposta

{
"template_id": "8794",
"responses": [
  {
    "id": 4773337,
    "status": "starting",
    "input": "hello",
    "output": "",
    "credits": 0.000337,
    "root_id": 4773337,
    "created_at": "2025-01-05T19:35:21.000000Z",
    "updated_at": "2025-01-05T19:35:21.000000Z",
    "template_id": 8794
  }
]
}