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.

Veyra Docs TeamActualizado el 1 min de lecturaVersión 2 · Historial

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

curl
# 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.

AgentesEjecucionesObservabilidad