Saltar al contenido principal
POST /agents/{id}/execute Ejecuta un agente 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 '{
    "temperature": "1",
    "model": "tess-5",
    "messages": [
        { "role": "user", "content": "Hello, how can you help me today?" }
    ],
    "tools": "no-tools",
    "wait_execution": false,
    "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
answersobjectSíLas respuestas del agente
messagesarraySolo para Agente de ChatLos mensajes del agente
wait_executionbooleanNoIndica si la ejecución debe esperar hasta completarse. El tiempo de espera es de 100 segundos. Para ejecuciones más largas, use wait_execution=false en combinación con el endpoint Obtener Respuesta del Agente con una estrategia de sondeo (predeterminado: false).
file_idsarrayNoArray de IDs de archivos para adjuntar a la ejecución.

​
Roles de Mensajes (Plantillas de Tipo Chat)

Para plantillas de tipo chat, el array messages admite los siguientes roles:
RolRequeridoDescripción
userSíMensajes del usuario. Deben estar emparejados con mensajes assistant.
assistantSíMensajes del asistente. Deben estar emparejados con mensajes user.
developerNoMensaje opcional del desarrollador. Solo permitido como el primer mensaje en el array.
systemNoNo soportado. Usar este rol causará un error.
Reglas importantes:
  • Los mensajes deben alternar entre los roles user y assistant (después del mensaje opcional developer).
  • El rol developer solo puede aparecer como el primer mensaje en el array y será extraído antes de procesar el resto.
  • Si dos mensajes consecutivos tienen el mismo rol (por ejemplo, dos mensajes user), la API devolverá un error de validación: “Chat messages must be a pair of user/assistant”.
  • El rol system no está soportado y causará un error.
Ejemplo con mensaje developer: 
{
  "messages": [
    { "role": "developer", "content": "Eres un asistente útil." },
    { "role": "user", "content": "¡Hola!" },
    { "role": "assistant", "content": "¡Hola! ¿Cómo puedo ayudarte?" },
    { "role": "user", "content": "¿Cómo está el clima?" }
  ]
}
Ejemplo sin mensaje developer: 
{
  "messages": [
    { "role": "user", "content": "¡Hola!" },
    { "role": "assistant", "content": "¡Hola! ¿Cómo puedo ayudarte?" },
    { "role": "user", "content": "¿Cómo está el clima?" }
  ]
}
Obtenga más detalles sobre qué opciones acepta este Agente solicitando este endpoint: Obtener Agente

​
Respuesta

{
"template_id": "8794",
"responses": [
  {
    "id": 4773337,
    "status": "starting",
    "input": "hello",
    "output": "",
    "credits": 0.000337,
    "root_id": 4773337,
    "created_at": "2025-01-05T19:35:21.000000Z",
    "updated_at": "2025-01-05T19:35:21.000000Z",
    "template_id": 8794
  }
]
}