Saltar al contenido 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.

​
Ejemplos 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 '{
    "stream": true,
    "temperature": "1",
    "model": "tess-5",
    "messages": [
        { "role": "user", "content": "hello there!" }
    ],
    "tools": "no-tools",
    "file_ids": [123, 321]
  }'

​
Encabezados

Par?metroTipoRequeridoDescripci?n
x-workspace-idintegerNoID del espacio de trabajo. Si no se proporciona, se usar? el espacio de trabajo seleccionado. Ser? requerido en una versi?n futura.

​
Par?metros de Ruta

Par?metroTipoRequeridoDescripci?n
idintegerS?El ID del agente.

​
Cuerpo de la Solicitud

Par?metroTipoRequeridoDescripci?n
streambooleanS?Debe ser true para este endpoint de streaming.
temperaturestringNoCampo de Chat Agent. Temperatura de muestreo entre 0 y 2. Valores m?s altos generan resultados m?s creativos (pred.: "1").
modelstringNoCampo de Chat Agent. Identificador del modelo a utilizar (p. ej., "tess-6").
toolsstringNoCampo de Chat Agent. Configuraci?n de herramientas del agente (p. ej., "agent", "no-tools").
root_idintegerNoCampo de Chat Agent. ID de una ejecuci?n existente para continuar un hilo de conversaci?n.
messagesarrayNoCampo de Chat Agent. Los mensajes del agente. Admite los roles user, assistant y developer.
file_idsarrayNoArray de IDs de archivos para adjuntar a la ejecuci?n.
Otros campos en la ra?zanyDepende del agenteEsto no es un nombre de campo fijo. Puede enviar otros campos requeridos por su agente directamente en la ra?z de la solicitud. Consulte qu? campos son obligatorios en Obtener Agente por ID.

​
Respuesta

data: {"id": 123, "status": "running", "output": "?Hola!", "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}

Autorizaciones

​
Authorization
string
header
requerido

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

Encabezados

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

​
id
integer
requerido

The agent ID.

Cuerpo

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.

Respuesta

200

Server-Sent Events stream.