Pular para o conteúdo principal
POST /agents/{id}/execute Execute a specific chat agent by ID.

Code Examples

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âmetroTipoObrigatórioDescrição
x-workspace-idintegerNãoID 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âmetroTipoObrigatórioDescrição
idintegerSimO ID do agente

Corpo da Solicitação

ParâmetroTipoObrigatórioDescrição
streambooleanNãoTransmite a saída usando o formato Server-Sent Events. Padrão: false
answersobjectSimAs respostas do agente
messagesarrayApenas para Agente de ChatAs mensagens do agente
file_idsarrayNãoArray 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}