Agentes
Ejecutar Agente
Ejecuta un agente específico por ID.
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:- Crear una Colección —
POST /api/memory-collections— y guarda elidretornado. - Crear Memorias —
POST /api/memories— pasandocollection_idy el texto de la memoria en el campomemory. - Ejecutar el Agente — incluye
"memory_collections": [id_coleccion]en el cuerpo de la solicitud.
Roles de Mensajes (Plantillas de Tipo Chat)
Para plantillas de tipo chat, el arraymessages admite los siguientes roles:
Reglas importantes:
- Los mensajes deben alternar entre los roles
useryassistant(después del mensaje opcionaldeveloper). - El rol
developersolo 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
systemno está soportado y causará un error.
Respuesta
Autorizaciones
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Encabezados
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
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).