POST /agents/{id}/execute
Execute a specific chat agent by ID.
Code Examples
cURL
Node.js
Python
PHP
Java
Go
.NET
Ruby
curl --request POST \
--url 'https://api.tess.im/agents/{id}/execute' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"stream": true,
"temperature": "1",
"model": "tess-5",
"messages": [
{ "role": "user", "content": "hello there!" }
],
"tools": "no-tools",
"file_ids": [123, 321]
}'
Cabeçalhos
Parâmetro Tipo Obrigatório Descrição x-workspace-id integer Não ID do espaço de trabalho. Se não fornecido, o espaço de trabalho selecionado do usuário será usado.
Nota: Este campo será obrigatório em uma versão futura da API. É altamente recomendável configurá-lo agora para garantir a compatibilidade com futuras atualizações.
Parâmetros de Rota
Parâmetro Tipo Obrigatório Descrição id integer Sim O ID do agente
Corpo da Solicitação
Parâmetro Tipo Obrigatório Descrição stream boolean Não Transmite a saída usando o formato Server-Sent Events. Padrão: false answers object Sim As respostas do agente messages array Apenas para Agente de Chat As mensagens do agente file_ids array Não Array de IDs de arquivos para anexar à execução.
Resposta
data: { "id" : 123 , "status" : "running" , "output" : "Oi!" , "error" : null , "credits" : null , "root_id" : 123 , "created_at" : "2025-01-01T10:00:00.000000Z" , "updated_at" : "2025-01-01T10:00:00.000000Z" , "template_id" : 10 }
data: { "id" : 123 , "status" : "completed" , "output" : "" , "error" : null , "credits" : 10 , "root_id" : 123 , "created_at" : "2025-01-01T10:00:00.000000Z" , "updated_at" : "2025-01-01T10:00:00.000000Z" , "template_id" : 10 }