Agent runs y uso

Cada ejecución de un agent sobre un correo, con sus tokens, costo y duración — más dos vistas agregadas sobre los mismos datos. Todo solo lectura. Ver el modelo AgentRun y el modelo Usage.

Comando	HTTP	Descripción
agent-runs list	GET /agent-runs	Lista ejecuciones de agent con tokens, costo y duración.
agent-runs get	GET /agent-runs/{id}	Obtiene una ejecución, incluyendo la versión del prompt y el error, si lo hubo.
usage summary	GET /usage/summary	Uso agregado para un rango de fechas. Por defecto, los últimos 30 días.
usage cost	GET /usage/cost	Costo desglosado por modelo para un rango de fechas.

Ejemplos

# Listar ejecuciones de un agent
kobana inbox agent-runs list \
  --params '{"agent_id": "AGENT_ID", "status": "failed"}' \
  --fields "id,status,total_cost,duration_ms"

# Obtener una ejecución
kobana inbox agent-runs get \
  --params '{"id": "AGENT_RUN_ID"}' \
  --fields "id,status,error,input_tokens,output_tokens"

# Resumen de uso para un rango de fechas
kobana inbox usage summary \
  --params '{"from": "2026-08-01", "to": "2026-08-31"}'

# Costo por modelo
kobana inbox usage cost \
  --params '{"from": "2026-08-01", "to": "2026-08-31"}'

# Stream de todas las ejecuciones fallidas con paginación automática
kobana inbox agent-runs list \
  --params '{"status": "failed"}' \
  --page-all --fields "id,agent_id,email_id,error"

Próximos pasos

• Agents — el agent que produjo estas ejecuciones.
• Workflow runs — la cadena HTTP que disparó el workflow de una ejecución.