Ejecuciones y transcripciones
Lee paso a paso lo que hizo un agente en una ejecución, por qué empiezan las ejecuciones, cómo cancelarlas, reintentarlas y depurarlas, y cómo obtener sus eventos desde la API.
Una ejecución es una sesión de trabajo de un agente. Registra cada paso: qué despertó al agente, qué leyó, qué herramientas llamó, qué escribió y cuánto costó. Cuando algo sale mal, la ejecución muestra dónde.
Por qué empiezan las ejecuciones
| Disparador | Ejemplo |
|---|---|
| Asignación | Se asignó una tarea al agente. |
| Mención | Alguien mencionó al agente en un comentario. |
| Respuesta | Respondiste la pregunta o la aprobación del agente. |
| Calendario o rutina | Venció una rutina. |
| Bloqueo resuelto | Terminó una tarea que esta esperaba. |
| Manual | Alguien pulsó Run now. |
Abre una ejecución
Desde una tarea, abre una ejecución desde su hilo. Desde un agente, abre Runs. Cada ejecución vive en /agents/<agent>/runs/<run>.
La página de la ejecución muestra:
- Estado: en cola, en curso, correcta, fallida o cancelada.
- Transcripción: los mensajes del agente, las llamadas a herramientas con sus entradas y resultados, y los errores.
- Coste: tokens y dinero, por modelo.
- Espacio de trabajo: dónde se ejecutó y qué cambió.
- Las tareas que tocó la ejecución.
Cancela y reintenta
Stop cancela una ejecución en curso. Retry inicia una ejecución nueva para el mismo trabajo tras un fallo. Reintentar nunca repite un paso que ya tuvo éxito fuera de Veyra, como un correo enviado; el agente ve lo que pasó antes.
Depuración
Para un problema difícil, activa Capture raw provider traces en los ajustes Advanced del agente. Las ejecuciones siguientes guardan el intercambio exacto con el proveedor, con los datos sensibles ocultos, para que puedas inspeccionarlo. Desactívalo cuando termines; las trazas se pueden borrar.
Desde la API
# A run and its events
curl "https://intelligence-api.veyra.so/api/heartbeat-runs/$RUN_ID" -H "Authorization: Bearer $VEYRA_API_KEY"
curl "https://intelligence-api.veyra.so/api/heartbeat-runs/$RUN_ID/events" -H "Authorization: Bearer $VEYRA_API_KEY"
# Cancel it
curl -X POST "https://intelligence-api.veyra.so/api/heartbeat-runs/$RUN_ID/cancel" -H "Authorization: Bearer $VEYRA_API_KEY"Consulta Get a run, Get events for a run, Cancel a run y Ejecuciones.