Saltar al contenido principal
POST /agents/{id}/execute Ejecuta un agente de chat específico por ID.

​
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 utilizará el espacio de trabajo seleccionado del usuario.
Nota: Este campo será requerido en una futura versión de la API. Se recomienda encarecidamente configurarlo ahora para asegurar la compatibilidad con futuras actualizaciones.

​
Parámetros de Ruta

ParámetroTipoRequeridoDescripción
idintegerSíEl ID del agente

​
Cuerpo de la Solicitud

ParámetroTipoRequeridoDescripción
streambooleanNoTransmite la salida usando el formato Server-Sent Events. Predeterminado: false
answersobjectSíLas respuestas del agente
messagesarraySolo para Agente de ChatLos mensajes del agente
file_idsarrayNoArray de IDs de archivos para adjuntar a la ejecución.

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