Ejecuciones de agente y uso

Cada ejecución de un agente sobre un correo, con sus tokens, coste y duración — más las dos vistas agregadas sobre los mismos datos. Cuatro tools, todas de lectura.

Ver el modelo AgentRun y el modelo Usage.

---

agent_runs_list

Lectura · scope inbox/agent_runs · permiso agent-runs.list · GET /agent-runs

Lista ejecuciones de agente con tokens, coste y duración. Paginado por cursor.

Parámetro	Tipo	Descripción
cursor	string	Cursor opaco de una página anterior.
limit	integer	Tamaño de página, por defecto 25, máximo 100.
sort	string	Claves de ordenación, prefijo - para descendente.
status	running | success | failed	Filtra por estado de la ejecución.
agent_id	string (uuid)	Solo ejecuciones de este agente.
email_id	string (uuid)	Solo ejecuciones sobre este correo.
inbox_id	string (uuid)	Solo ejecuciones de correo recibido en este inbox.
llm_model	string	Filtra por modelo, en formato provider/model.
created_at_gte / created_at_lte	string	Rango ISO 8601 sobre created_at.
finished_at_gte / finished_at_lte	string	Rango ISO 8601 sobre finished_at.

agent_runs_get

Lectura · scope inbox/agent_runs · permiso agent-runs.show · GET /agent-runs/{id}

Obtiene una ejecución de agente, incluida la versión de prompt con la que corrió y el error cuando falló.

Parámetro	Tipo	Descripción
id obligatorio	string (uuid)	Id de la ejecución.

usage_summary

Lectura · scope inbox/usage · permiso usage.show · GET /usage/summary

Uso agregado en un rango de fechas: correos procesados, ejecuciones, tokens y coste. Por defecto, los últimos 30 días.

Parámetro	Tipo	Descripción
from	string (YYYY-MM-DD)	Fecha inicial, inclusiva.
to	string (YYYY-MM-DD)	Fecha final, inclusiva.

usage_cost

Lectura · scope inbox/usage · permiso usage.show · GET /usage/cost

Coste desglosado por modelo en un rango de fechas. Por defecto, los últimos 30 días.

Parámetro	Tipo	Descripción
from	string (YYYY-MM-DD)	Fecha inicial, inclusiva.
to	string (YYYY-MM-DD)	Fecha final, inclusiva.