Pular para o conteúdo principal
POST
/
agents
/
{id}
/
execute
curl --request POST \
  --url https://api.tess.im/agents/{id}/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "stream": true,
  "temperature": "1",
  "model": "tess-6",
  "messages": [
    {
      "role": "user",
      "content": "Generate a concise status update."
    }
  ],
  "tools": "no-tools",
  "file_ids": [
    123,
    321
  ]
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.tess.im/llms.txt

Use this file to discover all available pages before exploring further.

​
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 workspace. Se não fornecido, o workspace selecionado pelo usuário será usado. Será obrigatório em uma versão futura.

​
Parâmetros de Rota

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

​
Corpo da Solicitação

ParâmetroTipoObrigatórioDescrição
streambooleanSimDeve ser true para este endpoint de streaming.
temperaturestringNãoCampo de Chat Agent. Temperatura de amostragem entre 0 e 2. Valores maiores geram resultados mais criativos (padrão: "1").
modelstringNãoCampo de Chat Agent. Identificador do modelo a ser utilizado (ex.: "tess-6").
toolsstringNãoCampo de Chat Agent. Configuração de ferramentas do agente (ex.: "agent", "no-tools").
root_idintegerNãoCampo de Chat Agent. ID de uma execução existente para continuar um thread de conversa.
messagesarrayNãoCampo de Chat Agent. As mensagens do agente. Suporta os papéis user, assistant e developer.
file_idsarrayNãoArray de IDs de arquivo para anexar à execução.
Outros campos na raizanyDepende do agenteIsto não é um nome de campo fixo. Você pode enviar outros campos exigidos pelo seu agente diretamente na raiz da requisição. Consulte quais campos são obrigatórios em Obter Agente por ID.

​
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}

Autorizações

​
Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cabeçalhos

​
x-workspace-id
integer

ID of the workspace. If not provided, the user's selected workspace will be used. This field will be required in a future release.

Parâmetros de caminho

​
id
integer
obrigatório

The agent ID.

Corpo

application/json

Send a JSON object. Keep stream: true in this endpoint and add any custom fields directly at the root.

Free-form JSON object. Use stream: true and add known or custom fields at the root level.

Resposta

200

Server-Sent Events stream.