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 '
{
  "temperature": "1",
  "model": "tess-6",
  "messages": [
    {
      "role": "user",
      "content": "Summarize the latest ticket updates."
    }
  ],
  "tools": "no-tools",
  "waitExecution": false,
  "file_ids": [
    123,
    321
  ]
}
'

​
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",
    "waitExecution": false,
    "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
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.
waitExecutionbooleanNoSi true, espera que la ejecución termine antes de retornar (timeout: 100 s). Predeterminado: false.
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.

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

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. Known fields are supported, and you can add custom fields directly at the root (for example: department, reporting_period, include_risks).

Free-form JSON object. Send known fields and any custom agent fields directly at the root level.

Respuesta

200

Execution started (or completed if waitExecution: true).