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 registra | Notas |
|---|---|
| Decisión y versión | v3, o draft para ejecuciones del Playground |
| Origen | API o Playground |
| Estado y error | Éxito o Error, con el código y el mensaje de error |
| Acción y motivo de la acción | en ejecuciones exitosas |
| Latencia, modelo, tokens de entrada y de salida, costo estimado | el modelo es la versión exacta que respondió |
| ID de solicitud | el 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, distribuciones | solo cuando storeOutput está activado |
| Destinos | las 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):
| Plan | Retención de logs |
|---|---|
| Genesis | 7 días |
| Developer | 14 días |
| Growth | 30 días |
| Enterprise | 365 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.
Playground
Prueba borradores — incluidos los cambios sin guardar — con payloads reales, lee la confianza y las distribuciones, previsualiza destinos, compara ejecuciones y motores, y reproduce entradas de ejecuciones pasadas.
Resumen de los patrones
Los cuatro patrones arquitectónicos de TypeSafe —fan-out especulativo, enrutamiento filtrado por confianza, puntuación compuesta y enrutamiento por intención— y cómo se corresponden con funciones y plantillas de Dcision.