Skip to main content
POST

Ejemplos de Código

Encabezados

integer
requerido
ID del workspace. Obligatorio a partir del 01/09/2026. Hasta entonces, si se omite, se usa el workspace seleccionado del usuario (deprecated). Después de la fecha, ausencia → 422.

Parámetros de Ruta

Cuerpo de la Solicitud

Cómo usar memorias en una ejecuciónPara inyectar contexto de memoria en un agente, pasa los IDs de las Colecciones de Memoria en el campo memory_collections. El flujo completo es:
  1. Crear una ColecciónPOST /api/memory-collections — y guarda el id retornado.
  2. Crear MemoriasPOST /api/memories — pasando collection_id y el texto de la memoria en el campo memory.
  3. Ejecutar el Agente — incluye "memory_collections": [id_coleccion] en el cuerpo de la solicitud.
El agente utilizará automáticamente las memorias relevantes para contextualizar la respuesta.Consulta la guía completa en Memorias.

Roles de Mensajes (Plantillas de Tipo Chat)

Para plantillas de tipo chat, el array messages admite los siguientes roles: 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:
Ejemplo sin mensaje developer:
Obtenga más detalles sobre qué opciones acepta este Agente solicitando este endpoint: Obtener Agente

Respuesta

Autorizaciones

Authorization
string
header
requerido

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

Encabezados

x-workspace-id
integer
requerido

Workspace ID. Required as of 2026-09-01. Until then, if omitted, the user's selected workspace is used (deprecated). After the cutoff, a missing header returns 422.

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).