Ejecuciones y uso

Cada ejecución se registra con su versión, motivo de la acción, confianza y, si lo permites, entrada y salida. Encuentra ejecuciones, consulta el uso y conoce cuánto tiempo se guardan los logs.

Ejecuciones

Cada ejecución —desde la API o el Playground, exitosa o no— se registra como una ejecución. Su ID es el execution_id de la respuesta.

Se registraNotas
Decisión y versiónv3, o draft para ejecuciones del Playground
OrigenAPI o Playground
Estado y errorÉxito o Error, con el código y el mensaje de error
Acción y motivo de la acciónen ejecuciones exitosas
Latencia, modelo, tokens de entrada y de salida, costo estimadoel modelo es la versión exacta que respondió
ID de solicitudel X-Request-ID de la llamada: el tuyo o el que generó Dcision
Entrada (state)solo cuando storeInput de la decisión está activado
Salida, confianza, niveles ponderados, compuestos, distribucionessolo cuando storeOutput está activado
Destinoslas entradas de destinos de la ejecución —respuestas, respuestas de LLM y de agentes, funciones con sus params, entregas encoladas—, digan lo que digan storeInput y storeOutput

Las llamadas fallidas también se registran —incluidos los estados no válidos (INVALID_STATE, presupuesto de tokens incluido) y los errores del motor— para que veas lo que envía tu integración. Una llamada respondida con el fallback por error del motor se registra como Error con el código del motor, aunque la API haya devuelto 200. Las solicitudes rechazadas antes de que se ejecute la decisión —una clave o un cuerpo no válidos, una decisión desconocida, desactivada o sin publicar, un rate limit, un bloqueo por cuota, una repetición idempotente— no se registran.

Encuentra una ejecución

Ejecuciones lista primero las ejecuciones más recientes, de 50 en 50 (Cargar anteriores para ver más). Filtra por estado, origen y decisión, o busca por el comienzo de un ID de ejecución o por el nombre o el slug de una decisión. Al seleccionar una ejecución se abren sus detalles: acción y motivo, error, latencia, modelo, costo estimado, ID de solicitud, entrada, salida y la distribución de cada pregunta, sus destinos con el estado en vivo de sus entregas, además de Volver a ejecutar esta entrada en el Playground.

Registra los IDs

Guarda execution_id junto al registro sobre el que actuó tu aplicación, y envía tu propio X-Request-ID para correlacionar las ejecuciones de Dcision con tus logs.

Lee ejecuciones desde el código

GET /v1/executions lista las mismas ejecuciones con una clave de API —respuestas, acción, motivo, estado, código de error y métricas—, filtradas por decisión y estado, las más recientes primero. Nunca devuelve la entrada: los estados guardados se quedan en la app, para los miembros del workspace.

Uso

Uso resume hoy, los últimos 7 días o los últimos 30 días:

  • llamadas a la API y ejecuciones del Playground;
  • decisiones exitosas y la tasa de error;
  • latencia media de todas las ejecuciones, y latencia p50 y p95 de las exitosas;
  • costo estimado del motor y tokens de entrada;
  • un gráfico de volumen —por hora para hoy, por día en los demás casos— con los errores como línea discontinua;
  • un desglose por decisión: llamadas, errores, latencia media, costo estimado y participación.

La tarjeta superior muestra las decisiones facturables del período de facturación actual frente al volumen incluido en tu plan; también disponible desde el código con GET /v1/me. El Panel repite las cifras clave (decisiones ejecutadas, latencia p95, tasa de éxito, costo estimado del motor) junto con tus decisiones activas, las ejecuciones recientes y la lista de primeros pasos.

Por decisión: el Resumen

La primera pestaña de cada decisión, Resumen, sintetiza sus ejecuciones de 7, 30 o 90 días —tasa de éxito, latencia, costo, acciones y sus motivos, estadísticas por pregunta, destinos— y sugiere qué calibrar. Consulta Resumen y calibración.

Retención

Un proceso diario elimina las ejecuciones más antiguas que el menor entre la retención de tu plan y el ajuste del workspace (Configuración → Retención del log de ejecuciones):

PlanRetención de logs
Genesis7 días
Developer14 días
Growth30 días
Enterprise365 días

Por ejemplo, un workspace Growth configurado en 7 días conserva 7 días; un workspace Genesis configurado en 90 días conserva 7.

  • Los gráficos y tablas de uso se calculan a partir de las ejecuciones, así que solo cubren las ejecuciones que siguen retenidas.
  • La facturación no depende de los logs. Las decisiones facturables se cuentan por separado, por hora, y esos contadores se conservan unos 400 días: la retención nunca devuelve cuota ni cambia lo que pagas.
  • Eliminar una decisión elimina sus ejecuciones de inmediato.
  • Las entregas de destinos siguen su propia retención: se eliminan 30 días después de crearse; consulta Entrega y reintentos.

Alertas de cuota

Los propietarios del workspace reciben un e-mail cuando las decisiones facturables del período alcanzan el 80% y el 100% del volumen incluido, una vez por nivel y por período. Consulta Planes, cuotas y facturación.

En esta página