Preguntas frecuentes
Respuestas a preguntas comunes sobre Dcision — facturación, cuotas y créditos, claves, modelos y latencia, retención de datos, deploys e integración.
General
¿Dcision es un LLM?
No. Dcision es una capa de decisión: defines preguntas estructuradas y políticas, y cada llamada devuelve respuestas tipadas, confianza y una acción. Las respuestas vienen de un motor de decisión — Jev (el System One de TypeSafe, el predeterminado), OpenAI Decisions o Laya —, un modelo que devuelve distribuciones de probabilidad en lugar de texto generado. Usa Dcision para decidir si enviar trabajo y a dónde; deja que tu LLM, tu agente o tu equipo haga el trabajo.
¿Qué modelo responde mis decisiones?
El motor de la decisión, o el predeterminado del workspace — Jev, salvo que un admin lo haya cambiado. Con la clave de motor de Dcision, Jev se ejecuta en TypeSafe con el modelo elegido en Configuración → Motor — jev-1.13.0 (fijado, el predeterminado), jev-latest o jev-preview. OpenAI Decisions ejecuta gpt-6-luna con tu clave de OpenAI, y Laya se ejecuta en tu servidor. Con tu propia clave, el proveedor y el modelo que elegiste. metrics.model siempre informa la versión exacta que respondió. Consulta Motores y BYOK.
¿Qué lenguajes y SDKs son compatibles?
Cualquier lenguaje que pueda enviar una solicitud HTTPS con JSON — la API es un único POST; consulta los ejemplos en cURL, JavaScript y Python en Ejecutar una decisión. Los SDKs oficiales para TypeScript y Python agregan reintentos que nunca ejecutan una decisión dos veces, destinos de función y verificación de webhooks; todavía no están en npm ni en PyPI, así que compílalos desde el código fuente. La CLI cubre la terminal y la CI.
¿Una decisión puede llamar a mis sistemas o responder a mis usuarios?
Sí, con los destinos: para cada opción, nivel, umbral o acción final, devuelve una respuesta fija o una respuesta de LLM, delega a tu agente, dispara un workflow, envía un webhook firmado, llama a cualquier API con tus secretos o dile a tu código qué función ejecutar. Las entregas se reintentan durante unas 7 horas, y desde el Playground no se envía nada hasta que actives Ejecutar los destinos de verdad.
¿Puedo llamar a la API desde un navegador o una app móvil?
No. Las claves de API son secretas: llama a Dcision desde tu backend, un worker o el runtime de tu agente, y envía el resultado al cliente si lo necesita.
¿Qué tan rápida es una decisión?
Cada respuesta informa metrics.latency_ms, y Uso muestra la latencia promedio y p95 de tus decisiones. Todas las preguntas de una decisión se responden en una sola llamada al motor, en paralelo, así que las preguntas adicionales agregan poca latencia. La llamada al motor tiene un plazo de 5 segundos por defecto, reintentos incluidos — defínelo por decisión con timeoutMs; una llamada que lo supera falla con 504 ENGINE_TIMEOUT.
¿Una decisión puede responder algo cuando el motor está caído?
Sí, si lo activas: con onEngineError: "fallback", una falla del motor responde 200 con la acción de fallback de la decisión y action_reason.type = "engine_error". Esas respuestas no se facturan. Consulta Configuración de la decisión.
Facturación y cuotas
¿Qué cuenta como una decisión facturable?
Una llamada exitosa (200) a POST /v1/decisions/{slug}, una vez por llamada sin importar cuántas preguntas tenga. Las ejecuciones del Playground, los errores, las repeticiones idempotentes, los fallbacks por error del motor y las lecturas (GET /v1/me, GET /v1/executions) son gratis. Las llamadas con claves de prueba y con tu propia clave de proveedor cuentan como cualquier otra. Consulta Qué se factura.
¿Cómo consulto mi uso desde el código?
GET /v1/me devuelve las decisiones facturables usadas en el período actual, el volumen incluido y las fechas del período, con cualquier clave de API del workspace. Consulta Obtener cuenta y uso.
¿Qué pasa después de las decisiones incluidas — también en Genesis?
Todos los planes siguen funcionando con créditos prepagos, al precio del plan por 1M de decisiones: US$12 en Genesis y Developer, US$9 en Growth (R$60 y R$45 en Brasil). Genesis no necesita una suscripción para eso. Sin créditos, las llamadas a la API devuelven 402 CREDITS_EXHAUSTED hasta que agregues créditos, se reinicie el período o cambies a un plan superior. El Playground sigue funcionando. Consulta Créditos.
¿Cómo obtengo créditos?
El Owner los agrega en la página Facturación: agregar una tarjeta da US$20 (R$100) en créditos promocionales válidos por 90 días — una vez por workspace y una vez por tarjeta — y se pueden comprar créditos con tarjeta de US$10 a US$1,000 (R$50 a R$5,000). Los créditos pagados nunca vencen. Los cupones también agregan créditos promocionales.
¿Los créditos pueden recargarse solos — y puedo limitar el gasto?
Sí, ambas cosas son opcionales. La recarga automática cobra a la tarjeta guardada un monto elegido cada vez que el crédito disponible baja de un umbral, después de que el Owner la autoriza; se puede desactivar en cualquier momento. Un tope de gasto por ciclo de facturación detiene las llamadas que exceden el volumen incluido con 402 SPEND_CAP_REACHED una vez que el gasto de créditos del ciclo lo alcanza.
¿Usar mi propia clave de proveedor hace que las decisiones sean gratis?
No. Con tu propia clave, el proveedor factura la llamada al motor, y la llamada exitosa a la API igual cuenta para tu plan de Dcision.
¿Qué significa metrics.estimated_cost_usd?
Una estimación del costo del motor de la llamada — metrics.input_tokens por el precio del modelo (Jev: US$0.042 por 1M de tokens de entrada; OpenAI Decisions: US$0.10; Laya: 0 — los tokens de salida son gratis) — para comparar decisiones. No es lo que Dcision te cobra.
Decisiones
¿Qué es la opción other que no agregué?
Toda pregunta choice recibe una opción reservada other para que el motor pueda decir "ninguna de estas" en lugar de forzar una respuesta equivocada. Cuando se elige, la decisión aplica su acción de fallback. Consulta Preguntas.
¿Por qué mi llamada devolvió escalate si ninguna política lo indica?
Mira action_reason: other_option significa que una pregunta choice respondió other; low_confidence significa que una respuesta quedó por debajo de su minConfidence; engine_error significa que el motor falló en una decisión con onEngineError: "fallback". Los tres aplican la acción de fallback de la decisión, escalate por defecto. Consulta Políticas y acciones.
¿Por qué la confianza de mi pregunta probability es menor que la probabilidad?
Porque la confianza mide la certeza en cualquiera de las dos direcciones, en la misma escala que las preguntas choice y score: para una probabilidad p es |2p − 1|. Una probabilidad de 0.9 — o 0.1 — tiene confianza 0.8; 0.5 tiene confianza 0. Define minConfidence teniendo esto en cuenta: 0.6 marca todo p entre 0.2 y 0.8. Consulta Confianza y probabilidades.
¿Qué son scores y composites en la respuesta?
scores contiene el nivel ponderado de cada pregunta score — el promedio de sus niveles ponderado por probabilidad, contados desde 1, así que 2.4 queda entre el segundo y el tercer nivel. composites contiene las combinaciones ponderadas de respuestas de la decisión, como un score de leads. Ambos pueden alimentar políticas. Consulta Preguntas y Compuestos.
¿Cuántas preguntas debería hacer una decisión?
Tantas como necesite el flujo, hasta 64: se responden en una sola llamada, y la llamada se factura una vez. Haz también las especulativas — las respuestas que no necesitas simplemente se ignoran. Mantén cada pregunta atómica, y el state dentro del presupuesto de tokens. Consulta Fan-out especulativo y Escribir buenas preguntas.
¿block rechaza mi solicitud?
No. Las acciones son etiquetas para tu código. La respuesta es 200 OK con "action": "block", y tu aplicación decide qué significa bloquear.
Edité mi decisión pero la API sigue respondiendo como antes. ¿Por qué?
La API ejecuta la versión activa. Las ediciones cambian el borrador; despliégalas para crear una nueva versión. Consulta Versiones y deploy.
¿Puedo cambiar el slug?
Hasta el primer deploy. Después, el slug queda bloqueado, porque los clientes lo llaman.
¿Cómo vuelvo a una versión anterior?
Las versiones son inmutables y aparecen en el Historial de versiones. Devuelve el borrador al schema anterior y despliégalo — esto crea una nueva versión con la lógica antigua.
¿Por qué mi state se rechaza con 422 INVALID_STATE?
El mensaje indica el problema: un campo obligatorio que falta, un tipo equivocado ("500" no es un number), una decisión de texto que recibió un objeto, una decisión de lista que no recibió un array, o un state que supera los límites — por sí solo, o junto con las preguntas, para el presupuesto de tokens del motor. Los campos que el schema no declara no son un problema.
¿Clave live o de prueba — cuál debería usar?
Ejecutan las mismas versiones desplegadas y se facturan igual; la única diferencia es que las entregas de los destinos llevan livemode: false con las claves de prueba. Usa claves de prueba para staging, CI y desarrollo local, así puedes revocarlas sin tocar producción.
Equipo y cuenta
¿Mi equipo puede compartir un workspace?
Sí. Invita a personas por e-mail en Configuración → Miembros como Admins, Members o Viewers — la invitación es válida por 7 días y se acepta cuando inician sesión. Cada persona puede pertenecer a varios workspaces y ser dueña de hasta 10. Consulta Equipo, roles y cuenta.
¿Puedo iniciar sesión con una contraseña?
Sí, si defines una en Cuenta → Contraseña — Google y los códigos por e-mail siguen funcionando. Cambiarla cierra tus otras sesiones, y Cerrar sesión en todas partes las termina todas.
Datos
¿Dcision guarda los states que envío?
Por defecto, las ejecuciones guardan el state (storeInput) y las respuestas (storeOutput) durante la retención de logs de tu plan — 7 días en Genesis. Desactiva cualquiera de los dos por decisión. Los states guardados solo se muestran en la app: GET /v1/executions nunca los devuelve. Consulta Seguridad y datos.
¿Quién procesa mis datos?
Dcision valida el state y lo envía, con el contexto y las preguntas de la decisión, al proveedor del motor: TypeSafe, bajo la cuenta de Dcision, por defecto, o el proveedor de tu propia clave (OpenAI para OpenAI Decisions; tu propio servidor para Laya). Los archivos que necesitan OpenAI para leerse — audio, imágenes para Jev o Laya, documentos escaneados — van a OpenAI con la clave de OpenAI del workspace. Consulta A dónde va tu state.