Motores y BYOK

Las decisiones se ejecutan en Jev, Laya u OpenAI Decisions. Usa la clave de Dcision en TypeSafe, tu clave de OpenRouter, TypeSafe, Vercel AI Gateway u OpenAI, o Laya en tu servidor — más costo, límites y errores.

Motores

Dcision ejecuta las decisiones en tres motores. Los tres son modelos de decisión — devuelven decisiones y probabilidades en lugar de texto generado — y los tres responden los mismos tres tipos de pregunta: choice, score y probability, cada uno con una distribución de probabilidad, que Dcision convierte en respuestas tipadas, confianza y niveles ponderados. Jev y Laya hablan el mismo contrato System One; OpenAI Decisions tiene el suyo propio, y Dcision lo traduce.

Motormetrics.engineQué esDónde se ejecuta
Jev (predeterminado)"jev"El modelo de decisión System One de TypeSafe.TypeSafe, OpenRouter o Vercel AI Gateway — con la clave de Dcision o la tuya.
Laya"laya"Modelo de decisión de código abierto (Apache 2.0) de Convai Innovations, de 322M–421M parámetros.Un servidor Laya: el tuyo, o el de Dcision cuando esté disponible. Consulta Laya.
OpenAI Decisions"openai"La API Decisions de OpenAI (gpt-6-luna, beta pública).OpenAI, con tu clave de OpenAI — o la de Dcision cuando esté disponible. Consulta OpenAI Decisions.

Las respuestas informan el motor en metrics.engine y el modelo exacto que respondió en metrics.model.

El esquema de decisión no depende del motor: Dcision lo compila en una representación neutral respecto al motor y solo el adaptador del motor habla con el modelo. El estado, el contexto de la decisión y las preguntas — texto o JSON estructurado — se envían en los formatos nativos del motor, y todas las preguntas de una decisión van en una sola solicitud.

Qué motor ejecuta una decisión

Configuración → Motor define el motor predeterminado del workspace — Jev hasta que lo cambies. Una decisión puede elegir el suyo en Motor y runtime → Motor (settings.engine); si no lo hace, sigue el predeterminado. Cada motor conserva su propia credencial y su propio modelo, así que un workspace puede ejecutar la mayoría de las decisiones en Jev, una en Laya y otra en OpenAI Decisions.

Jev: quién hace la llamada al motor

Elígelo en Configuración → Motor (Administradores y el Propietario). La elección se aplica de inmediato a todas las decisiones de Jev del workspace — en el Playground y en la API.

OpciónQué pasa
Clave del motor de Dcision (predeterminada)Dcision llama a TypeSafe (Jev directo) con su propia clave, incluida en tu plan. Elige el modelo: jev-1.13.0 de forma predeterminada. No hay nada más que configurar.
Mi propia clave del proveedor (BYOK)Dcision llama al motor con tu clave en el proveedor y el modelo que elijas. El proveedor factura directamente a tu cuenta.

Modelos con la clave de Dcision

ModeloQué es
jev-1.13.0Fijado (predeterminado, recomendado). Una versión fija: las respuestas — y la confianza — no cambian sin que lo sepas.
jev-latestLa última versión estable. Cambia cuando TypeSafe lanza una nueva versión.
jev-previewVersiones preliminares, por delante de jev-latest cuando hay una disponible.

Los alias cambian cuando TypeSafe lanza una nueva versión, así que las respuestas detrás de ellos pueden cambiar sin ningún cambio de tu lado. metrics.model y el log de ejecuciones siempre registran la versión exacta que respondió — jev-1.13.0 incluso cuando seleccionaste jev-latest.

Fija una versión del modelo

Los umbrales como minConfidence se ajustan para un modelo. Usa el jev-1.13.0 fijado para las decisiones de producción, y pasa a una nueva versión a tu propio ritmo, después de volver a probar en el Playground.

Proveedores

Los tres exponen el mismo contrato System One:

ProveedorEndpointModelosDónde obtener una clave
OpenRouterhttps://openrouter.ai/api/v1/systemonetypesafe/jev-1.13openrouter.ai/keys
TypeSafe (Jev directo)https://api.typesafe.ai/v1/systemonejev-1.13.0 (predeterminado), jev-latest, jev-previewdocs.typesafe.ai
Vercel AI Gatewayhttps://ai-gateway.vercel.sh/typesafe/v1/systemonetypesafe-ai/jevvercel.com/docs/ai-gateway

Laya

Laya es un modelo System One de código abierto: sin precio por token, y se ejecuta donde tú lo ejecutes — tus datos nunca salen de tu servidor. Su servidor laya-serve expone el mismo contrato /v1/systemone que Jev, así que Dcision lo llama con las mismas preguntas.

ModeloQué es
autoPredeterminado. El enrutador de Laya elige el checkpoint según el idioma de la entrada. metrics.model informa el que respondió, p. ej. laya/multilingual.
englishCheckpoint en inglés (ModernBERT-large, 421M). Lee hasta 512 tokens.
multilingualMás de 100 idiomas (mmBERT, 322M), el más rápido. Lee hasta 1,024 tokens.
typed-decisionsAjustado para observabilidad de agentes y workflows de atención al cliente. Lee hasta 1,024 tokens.

Ejecuta tu servidor Laya

Ejecuta laya-serve (Python 3.10+) en un host al que Dcision pueda llegar por HTTPS público, detrás de tu reverse proxy:

pip install "laya[serve]"
LAYA_API_KEY=<a long random secret> LAYA_PRELOAD=1 laya-serve   # listens on :8000

El proyecto también incluye un Dockerfile y archivos compose para CPU y CUDA. Una GPU responde en ~35 ms; una CPU, en unos cientos de ms por decisión.

En Configuración → Motor → Servidor Laya, ingresa la URL del servidor (https://laya.example.com — Dcision llama a /v1/systemone en ella) y la LAYA_API_KEY si definiste una. Haz clic en Guardar servidor y luego en Probar.

Selecciona Laya como motor predeterminado — o elígelo en la configuración de una decisión —, elige el modelo y haz clic en Guardar configuración del motor.

Protege tu servidor Laya

laya-serve no tiene autenticación a menos que se defina LAYA_API_KEY. Defínela antes de exponer el servidor y pégala en Configuración → Motor. Dcision solo llama a direcciones https:// públicas — nunca a direcciones privadas, de loopback ni de metadatos de la nube — y no sigue redirecciones.

Contexto más corto que Jev. Laya lee hasta 512 tokens (english) o 1,024 (multilingual, typed-decisions) de estado y pregunta; el servidor trunca las entradas más largas. Para estados largos, prefiere multilingual o mantén Jev. Vuelve a probar los umbrales (minConfidence, rangos de las políticas) en el Playground al pasar una decisión a Laya: cada modelo tiene su propio perfil de confianza.

OpenAI Decisions

OpenAI Decisions es la API de OpenAI para respuestas tipadas sobre una entrada (POST /v1/decisions). Responde los mismos tres tipos de pregunta que Jev, así que una decisión se ejecuta en ella sin cambios: Dcision traduce las preguntas y normaliza las respuestas a las mismas escalas.

ModeloQué es
gpt-6-lunaPredeterminado y, por ahora, el único modelo de la API Decisions (beta pública). metrics.model registra el id exacto que respondió.
DcisionOpenAI DecisionsNotas
probabilitypredicateLos criterios yes/no se agregan a las instrucciones. result es la probabilidad; la confianza es `
choicechoiceLas opciones se convierten en choices con sus descripciones, en orden; la opción reservada other queda al final. La confianza es la de OpenAI.
scorescoreLos niveles se convierten en levels (la rúbrica de un nivel estructurado es su descripción). result es el nivel más probable y scores el nivel ponderado, contado desde 1.
estadoinputEl texto tal cual; objetos y listas como texto JSON. El context de la decisión viaja dentro, como en Jev.

Usa tu clave de OpenAI

En Configuración → Motor → Clave de OpenAI, pega una clave de platform.openai.com/api-keys — una clave de proyecto es suficiente — y haz clic en Guardar clave y luego en Probar.

Selecciona OpenAI Decisions como motor predeterminado — o elígelo en la configuración de una decisión — con Mi clave de OpenAI, y haz clic en Guardar configuración del motor. Dcision llama a https://api.openai.com/v1/decisions; OpenAI factura a tu cuenta.

Rechazos. OpenAI puede negarse a responder una pregunta. La ejecución igualmente responde 200: la pregunta rechazada no tiene entrada en result, las demás preguntas conservan sus respuestas y la decisión toma su acción de fallback con action_reason: { "type": "refusal", "question": … } — diga lo que diga onEngineError, ya que el motor sí respondió.

Se aplican los controles de tu cuenta de OpenAI. Los rate limits, Zero Data Retention, HIPAA y la residencia de datos son los del proyecto de OpenAI detrás de la clave. Vuelve a probar los umbrales (minConfidence, rangos de las políticas) en el Playground al pasar una decisión a OpenAI: cada modelo tiene su propio perfil de confianza.

GPT-Live

GPT-Live, la voz en tiempo real de OpenAI, puede delegar decisiones tipadas a OpenAI Decisions mientras el usuario habla. Dcision exporta las preguntas de una decisión desplegada como esa delegación — GET /v1/decisions/{slug}/openai-live — y ejecuta las políticas, los destinos y el log de ejecuciones de la decisión sobre las respuestas de la sesión — POST /v1/decisions/{slug}/openai-live/answers. Esas llamadas se facturan como ejecuciones, con metrics.engine: "openai" y sin costo de motor: OpenAI factura la sesión Live. Consulta la guía de GPT-Live.

Comparar motores y modo sombra

Cada motor tiene sus propias respuestas y su perfil de confianza. Dos herramientas muestran cómo responde otro motor a tu decisión antes de cambiar:

HerramientaEjecutaCosto
Comparar motores en el PlaygroundEl estado del editor, en Jev, Laya y OpenAI Decisions a la vez.Tres ejecuciones del Playground.
Modo sombra — settings.shadowUna muestra de las ejecuciones reales de producción, también en un segundo motor, en segundo plano.Sin créditos de Dcision.

Comparar motores en el Playground

Comparar motores, junto a Ejecutar decisión, ejecuta el mismo estado y el mismo borrador en los tres motores a la vez. Son tres ejecuciones del Playground, registradas en Ejecuciones; los destinos nunca se entregan. Una tabla muestra los motores lado a lado: la respuesta de cada pregunta con su confianza, la acción, la latencia, el costo estimado y, cuando un motor falló, su código de error — ENGINE_NOT_CONFIGURED para un motor que el workspace no configuró. Las filas en las que los motores no coinciden se resaltan.

Modo sombra en producción

Define settings.shadow — en el editor, Motor y runtime → Motor sombra y Muestra de la sombra (%) — y despliega. Una parte de las ejecuciones de la decisión por API, webhook y MCP, el 10% por defecto, también se ejecuta en el motor sombra con exactamente la misma entrada. Quien llama siempre recibe la respuesta del motor principal; la respuesta sombra se guarda en la ejecución y nunca dispara destinos.

Las ejecuciones sombra no cuentan para tus decisiones incluidas ni consumen créditos. Con tu propia clave del proveedor o de OpenAI, el proveedor las factura en tu cuenta.

El Resumen de la decisión muestra una tarjeta Modo sombra: con qué frecuencia coinciden ambos motores, en general y por pregunta, el número de ejecuciones sombra y de fallos, y la latencia mediana del motor sombra — consulta Resumen y calibración. Cuando la concordancia es alta en las preguntas que mueven tus políticas, cambia settings.engine y vuelve a revisar umbrales como minConfidence.

Trae tu propia clave

En Configuración → Motor → Claves de proveedores, pega la clave junto al proveedor y haz clic en Guardar clave.

Haz clic en Probar. Dcision ejecuta una pequeña decisión de prueba (la plantilla Detección de spam sobre un mensaje de una línea) con tu clave y muestra el modelo y la latencia, o el error del proveedor. La prueba no se registra como ejecución, pero tu proveedor puede facturarla.

Selecciona Mi propia clave del proveedor, el proveedor y el modelo, y luego Guardar configuración del motor. Las nuevas ejecuciones los usan de inmediato.

Si seleccionas Mi propia clave del proveedor sin guardar una clave para ese proveedor, todas las ejecuciones fallan con 424 ENGINE_NOT_CONFIGURED.

Cómo se protegen las claves

  • Cifradas en reposo con AES-256-GCM; la API nunca las devuelve — solo se muestran los últimos 4 caracteres.
  • Nunca se escriben en logs ni se envían a ningún sitio que no sea el endpoint del proveedor.
  • Solo los Administradores y el Propietario pueden agregarlas, reemplazarlas, probarlas o quitarlas; los demás miembros del workspace ven qué proveedores tienen una clave, con sus últimos 4 caracteres.
  • Quitar una clave la elimina. Guarda una clave nueva para rotarla.

Claves para destinos de LLM

Las claves de OpenRouter y Vercel AI Gateway guardadas aquí también alimentan los destinos de LLM — las respuestas que una decisión puede generar para una ruta. Se usan para esas respuestas incluso cuando el motor se ejecuta con la clave de Dcision, y el proveedor factura sus tokens a tu cuenta. La clave del motor de Dcision nunca ejecuta destinos de LLM.

Límites del motor

  • Presupuesto de tokens. Jev lee el estado una vez y evalúa cada pregunta contra él: unos 32,000 tokens para el estado más la pregunta más larga y 64,000 para el estado más todas las preguntas. Dcision comprueba ambos antes de la llamada y responde 422 INVALID_STATE cuando un estado no cabe — consulta Límites.
  • Rendimiento. TypeSafe limita cada cuenta en solicitudes y tokens por segundo. Con la clave de Dcision, el límite lo comparten todos los workspaces, así que Dcision suaviza los picos: una llamada espera un hueco libre dentro de su plazo en lugar de fallar de inmediato. Con tu propia clave se aplican los límites de tu cuenta del proveedor — en OpenAI, los de tu proyecto de OpenAI.
  • Imágenes, audio y documentos. Los tres motores leen texto y JSON. Dcision convierte los documentos en texto, transcribe el audio y — como Jev y Laya no ven imágenes — describe las imágenes como texto para ellos; OpenAI Decisions recibe las imágenes como imágenes. Consulta Entradas.

Costo

En Laya, el costo del motor es el servidor que ejecutas: Dcision estima estimated_cost_usd: 0 para las llamadas a Laya. Una ejecución exitosa por la API sigue contando como una decisión facturable.

En OpenAI Decisions, el precio es de US$0.10 por 1M de tokens de entrada (sin cargos por salida ni por caché): una decisión de 375 tokens de entrada se estima en 0.0000375.

En Jev, cada respuesta incluye metrics.input_tokens, metrics.output_tokens y metrics.estimated_cost_usd: los tokens de entrada de la llamada por el precio del modelo. Jev cuesta US$0.042 por 1M de tokens de entrada y no factura tokens de salida — se informan solo para observabilidad —, así que una decisión de 375 tokens de entrada se estima en 0.00001575. Es una estimación del costo del motor — útil para comparar decisiones —, no tu factura de Dcision.

Todas las preguntas de una decisión comparten una llamada, así que agregar una pregunta suma sus propios tokens a la llamada, no otra solicitud.

Con tu propia clave, el proveedor factura la llamada al motor. La llamada sigue contando como una decisión facturable en tu plan de Dcision cuando tiene éxito a través de la API.

Errores del motor

CódigoEstadoCausa
ENGINE_NOT_CONFIGURED424No hay clave guardada para el proveedor seleccionado, no hay servidor Laya para una decisión de Laya, no hay clave de OpenAI para una decisión de OpenAI, o la clave del motor de Dcision no está disponible.
ENGINE_AUTH_FAILED502El proveedor rechazó la clave (401/403) o la cuenta no tiene créditos (402, 429 insufficient_quota de OpenAI). Revísala en Configuración → Motor.
ENGINE_RATE_LIMITED503El proveedor está sobrecargado o limitado (429/503/529), o la clave compartida de Dcision no tuvo un hueco libre antes del plazo.
ENGINE_UNAVAILABLE503El proveedor falló (5xx) o no se pudo contactar.
ENGINE_TIMEOUT504Sin respuesta dentro del timeoutMs de la decisión.
ENGINE_INVALID_REQUEST502El proveedor rechazó la solicitud; el mensaje incluye su motivo. También una URL de servidor Laya que resuelve a una dirección privada o reservada.
ENGINE_ERROR502El motor respondió fuera del contrato (por ejemplo, una opción desconocida).

Dentro del timeoutMs de la decisión, Dcision hace hasta 2 reintentos ante errores de red, 429/503/529 y otras respuestas 5xx, respetando el Retry-After del proveedor — consulta timeoutMs. Las ejecuciones fallidas se registran como ejecuciones con estado Error y no se facturan. Con onEngineError: "fallback", todos los errores de esta tabla excepto ENGINE_NOT_CONFIGURED se convierten en un 200 con la acción de fallback de la decisión. Consulta Errores.

En esta página