Configuración de la decisión

engine, storeInput, storeOutput, timeoutMs, fallbackAction, onEngineError y shadow — qué hace cada configuración de runtime de una decisión, su valor por defecto y sus límites — además de la configuración del workspace.

Cada decisión tiene siete configuraciones de runtime, que se editan en la tarjeta Motor y runtime del editor (o en el nodo Motor del constructor visual). Forman parte del schema, así que los clientes de la API reciben un cambio cuando lo despliegas; el Playground usa la configuración del borrador de inmediato.

"settings": {
  "storeInput": true,
  "storeOutput": true,
  "timeoutMs": 5000,
  "fallbackAction": "escalate",
  "onEngineError": "error",
  "engine": "laya",
  "shadow": { "engine": "openai", "sampleRate": 0.1 }
}
ConfiguraciónTipoPor defectoQué hace
storeInputbooleantrueGuarda el state de la solicitud en el log de ejecuciones. Los archivos se guardan como su nombre, tipo, tamaño y los primeros 4,000 caracteres de su texto — nunca el archivo en sí.
storeOutputbooleantrueGuarda result, confidence, los niveles ponderados, los compuestos y las distribuciones completas en el log de ejecuciones.
timeoutMsinteger, 500–30,0005000El plazo del motor para una llamada de esta decisión, reintentos incluidos, en milisegundos.
fallbackActioncontinue, block, escalate, fallbackescalateLa acción cuando ninguna política coincidió y el motor se negó a responder una pregunta, una choice respondió other o una pregunta quedó por debajo de su minConfidence — y, con onEngineError: "fallback", cuando el motor falla.
onEngineErrorerror, fallbackerrorLo que responde la API cuando el motor falla: el error, o un 200 con la acción de fallback.
enginejev, laya, openaiausenteEl motor que ejecuta esta decisión. Ausente = el motor por defecto del workspace. Consulta Motores y BYOK.
shadowobjeto: engine (jev, laya, openai) y sampleRate (0.01–1, por defecto 0.1)ausenteUn segundo motor que también responde una muestra de las ejecuciones de producción en segundo plano, para comparar. Ausente = desactivado. Consulta shadow.

engine

Omítelo para seguir el motor por defecto del workspace (Configuración → Motor) — así, cambiar el valor por defecto mueve todas esas decisiones a la vez. Defínelo para fijar una decisión a un motor: por ejemplo, mantener el workspace en Jev y ejecutar una decisión de triaje multilingüe en Laya. En el editor: Motor y runtime → Motor.

El motor debe estar configurado en Configuración → Motor — para Laya, un servidor Laya; para OpenAI Decisions, una clave de OpenAI —; de lo contrario, las ejecuciones responden 424 ENGINE_NOT_CONFIGURED. Vuelve a probar umbrales como minConfidence en el Playground cuando cambies de motor: cada modelo tiene su propio perfil de confianza.

storeInput y storeOutput

Estas configuraciones solo afectan lo que se registra en el log; la respuesta de la API siempre está completa.

  • Con storeInput desactivado, las ejecuciones muestran No se guarda (storeInput está desactivado) en lugar del estado, y la ejecución no se puede reproducir en el Playground. Los estados inválidos tampoco se guardan.
  • Con storeOutput desactivado, las ejecuciones conservan el estado de la ejecución, la acción, el motivo de la acción, la latencia, el modelo, los tokens y el costo estimado, pero no las respuestas, la confianza, los niveles ponderados, los compuestos ni las distribuciones.

Desactívalas en decisiones que reciben datos personales o sensibles. Consulta Seguridad y datos.

Cuando una solicitud lleva un Idempotency-Key, su respuesta — respuestas incluidas — se guarda durante 24 horas para que un reintento pueda reproducirse, diga lo que diga storeOutput. Consulta Idempotencia.

timeoutMs

El plazo del motor, de 500 ms a 30 s — 5 segundos por defecto. Cubre toda la llamada al motor, reintentos incluidos:

  • Dcision hace hasta 2 reintentos ante errores de red, 429, 503, 529 y otras respuestas 5xx del proveedor, esperando 200 ms y luego 400 ms — o el Retry-After del proveedor cuando lo envía y cabe en el plazo.
  • Un timeout no se reintenta, ni tampoco un 4xx distinto de 429.
  • Con la clave compartida del motor de Dcision, las ráfagas esperan un espacio libre dentro del mismo plazo en lugar de fallar de inmediato.

Una llamada que se queda sin tiempo falla con 504 ENGINE_TIMEOUT — o responde con la acción de fallback cuando onEngineError es fallback. Aumenta timeoutMs para estados grandes o muchas preguntas; redúcelo en rutas críticas para la latencia que tengan un fallback. Dale a tu propio cliente HTTP un timeout unos segundos mayor que timeoutMs.

fallbackAction

La acción que se aplica cuando ninguna política coincidió y el motor se negó a responder una pregunta (un rechazo, solo con OpenAI Decisions), una pregunta choice respondió la opción reservada other o la confianza de una pregunta quedó por debajo de su minConfidence. El valor por defecto, escalate, envía los casos inciertos a una persona; continue en la práctica ignora la incertidumbre. Consulta Políticas y acciones.

La acción de fallback es también lo que responde onEngineError: "fallback" cuando el motor falla.

onEngineError

Qué pasa cuando el motor falla — un timeout, un proveedor sobrecargado o inalcanzable, una clave rechazada, una respuesta fuera del contrato — después de los reintentos:

ValorLa API responde
error (por defecto)El error, como 504 ENGINE_TIMEOUT o 503 ENGINE_UNAVAILABLE. Tu código decide qué significa.
fallback200 OK con action = la fallbackAction de la decisión, action_reason = { "type": "engine_error", "code": "<engine error code>" }, result y confidence vacíos, y cero tokens y costo.
200 OK con onEngineError: fallback
{
  "decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
  "execution_id": "exec_Vn4Kp8Wd2Lq6Tz1Xc9Bs",
  "schema": "lead-qualification",
  "version": 3,
  "result": {},
  "confidence": {},
  "action": "escalate",
  "action_reason": { "type": "engine_error", "code": "ENGINE_TIMEOUT" },
  "metrics": {
    "latency_ms": 5004,
    "engine": "jev",
    "model": "jev-1.13.0",
    "estimated_cost_usd": 0,
    "input_tokens": 0,
    "output_tokens": 0
  }
}
  • Estas respuestas no se facturan y no se guardan para idempotencia: reintentar con el mismo Idempotency-Key vuelve a llegar al motor.
  • La ejecución se registra con estado Error y el código de error del motor.
  • Solo cubre fallos del motor (los códigos ENGINE_* excepto ENGINE_NOT_CONFIGURED). Los estados inválidos, la cuota, los rate limits y una clave de motor faltante siguen respondiendo con sus errores.

Elige fallback para rutas que siempre deben responder — un chat o un asistente de voz, un checkout — y elige una fallbackAction que sea segura sin respuestas, normalmente escalate. En el editor: Motor y runtime → Si el motor falla → Responder con la acción de fallback.

shadow

El modo sombra prueba otro motor con tráfico real sin cambiar lo que reciben quienes llaman. Con settings.shadow, una parte de las ejecuciones de producción — sampleRate, 10% por defecto, de 1% a 100% — también se ejecuta en el motor sombra, en segundo plano, una vez lista la respuesta:

"settings": {
  "engine": "jev",
  "shadow": { "engine": "openai", "sampleRate": 0.2 }
}
  • Solo ejecuciones de producción: la API, las URLs de webhook y el servidor MCP, sobre la versión desplegada. Las ejecuciones del Playground y las respuestas de GPT-Live nunca tienen ejecución sombra, y no se ejecuta nada cuando el motor sombra es el mismo motor que respondió.
  • Misma entrada. El motor sombra recibe exactamente lo que recibió el motor principal: el mismo estado, con sus archivos ya leídos, y las mismas preguntas.
  • La respuesta nunca cambia. result, action y los destinos vienen del motor principal; la llamada sombra no tiene destinos y no hace esperar a la solicitud.
  • Sin créditos de Dcision. Las ejecuciones sombra no cuentan para tus decisiones incluidas ni consumen créditos. Con tu propia clave del proveedor o de OpenAI, el proveedor factura la llamada en tu cuenta.
  • Guardada en la ejecución: el modelo, las respuestas, la confianza, la latencia y los tokens de entrada del motor sombra — o su código de error cuando la llamada sombra falló. Una llamada sombra fallida nunca hace fallar la ejecución.

El motor sombra debe estar configurado en Configuración → Motor, como cualquier motor; de lo contrario sus llamadas fallan con ENGINE_NOT_CONFIGURED y aparecen como fallidas. El Resumen de la decisión muestra entonces con qué frecuencia coinciden ambos motores — consulta Resumen y calibración y Comparar motores y modo sombra. En el editor: Motor y runtime → Motor sombra y Muestra de la sombra (%). Como toda configuración, llega a producción cuando despliegas.

Configuración del workspace

Configuración, en la app, reúne lo que se aplica a todas las decisiones del workspace. Todos en el workspace pueden abrirla; los administradores y el propietario la cambian, y la Zona de peligro pertenece solo al propietario — consulta Equipo, roles y cuenta.

ConfiguraciónQuién la cambiaDescripción
NombreAdministradores y el propietarioEl nombre del workspace, de 2 a 80 caracteres. El slug del workspace es fijo.
Retención del log de ejecucionesAdministradores y el propietario7, 14, 30, 90, 180 o 365 días. Tu plan la limita: los logs se guardan durante el menor entre este valor y la retención del plan — consulta Ejecuciones y uso.
MotorAdministradores y el propietarioEl motor por defecto — Jev, Laya u OpenAI Decisions — y cómo se llama a cada uno: la clave o el servidor de Dcision, o tu propia clave de proveedor, clave de OpenAI o servidor Laya, con el modelo. Consulta Motores y BYOK. Se aplica de inmediato a las nuevas ejecuciones, para toda decisión que no elija su propio motor.
OrganizaciónAdministradores y el propietarioRazón social, ID fiscal, e-mail de facturación, país, dirección y sitio web — impresos en las facturas.
MiembrosAdministradores para Miembros y Lectores; el propietario para AdministradoresQuién está en el workspace y su rol — Propietario, Administrador, Miembro o Lector — además de las invitaciones. Consulta Equipo, roles y cuenta.
DestinosAdministradores y el propietarioEl secreto de firma de las entregas y los secretos del workspace que usan los destinos.
Zona de peligroEl propietarioEliminar el workspace.

En esta página