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.
Jev responde rápido a preguntas pequeñas y literales. Los buenos sistemas combinan muchas de ellas. TypeSafe documenta cuatro patrones arquitectónicos para hacerlo bien, y Dcision convierte cada uno en funciones de primera clase del schema de la decisión, con una plantilla que lo implementa de principio a fin.
| Patrón | Qué hace | Beneficios | En Dcision | Plantilla |
|---|---|---|---|---|
| Fan-out especulativo | Hace en una sola llamada todas las preguntas que el flujo podría necesitar y deja que las reglas decidan qué respuestas importan. | Costo, velocidad | Todas las preguntas en una decisión; las condiciones and filtran las respuestas especulativas. | ticket-triage |
| Enrutamiento filtrado por confianza | Usa la confianza como segundo eje: la respuesta dice qué, la confianza dice si actuar. | Fiabilidad, seguridad | minConfidence por pregunta y reglas on: "confidence", un umbral por acción. | voice-banking |
| Puntuación compuesta | Divide un juicio en puntajes atómicos y los combina con pesos que tú controlas. | Costo, fiabilidad, velocidad | Una pregunta por dimensión y compuestos, utilizables en reglas. | resume-screening |
| Enrutamiento por intención | Clasifica cada solicitud en una llamada rápida y la envía al gestor capaz más barato. | Costo, velocidad | Una elección para la intención (con el other reservado), reglas para lo que una persona debe ver. | customer-service-router |
Por qué patrones
Cada decisión es una llamada al motor: Jev lee el estado una vez y responde todas las preguntas en paralelo, así que agregar preguntas apenas cambia la latencia, y Dcision factura una decisión por llamada sin importar cuántas preguntas tenga. Los patrones aprovechan eso, y el hecho de que cada respuesta viene con una probabilidad calibrada:
- Pregunta más, no más seguido: el fan-out responde todo un árbol de decisión en un solo viaje de ida y vuelta.
- Actúa solo cuando haya suficiente seguridad: el enrutamiento filtrado por confianza ajusta la confianza requerida a lo que está en juego en cada acción.
- Deja las cuentas fuera del modelo: la puntuación compuesta combina respuestas atómicas con pesos guardados en la decisión.
- Usa los recursos caros al final: el enrutamiento por intención envía las consultas al código, los casos difíciles a LLMs especialistas y el resto a personas.
Los bloques de construcción
| Función | Útil para |
|---|---|
| Hasta 64 preguntas por decisión, respondidas en una sola llamada | fan-out, puntuación compuesta, enrutamiento por intención |
Reglas de política con hasta 5 condiciones and, gana la primera coincidencia | fan-out, enrutamiento filtrado por confianza, enrutamiento por intención |
minConfidence por pregunta y reglas sobre confidence | enrutamiento filtrado por confianza |
Niveles ponderados de las preguntas de puntaje (scores, reglas on: "score") | fan-out, enrutamiento por intención |
Compuestos, devueltos en composites y utilizables en reglas | puntuación compuesta |
La opción reservada other y la acción de fallback | enrutamiento por intención, enrutamiento filtrado por confianza |
onEngineError: "fallback": una acción segura cuando el motor falla | todos los patrones en un camino que siempre debe responder |
Consulta Schema de la decisión, Políticas y acciones y Configuración de la decisión.
Los patrones en la app
- Plantillas empieza con una sección Patrones: una tarjeta por patrón con qué es, cuándo usarlo, cómo construirlo en Dcision, sus beneficios, enlaces a las plantillas que lo implementan y a la guía de TypeSafe. Debajo, Todas las plantillas muestra los patrones de cada plantilla como insignias.
- Nueva decisión lista los patrones de cada plantilla junto a su número de preguntas.
- El panel Patrones del editor, debajo del schema de la decisión en la pestaña Editor, indica cuántos de los cuatro patrones usa la decisión. Cada entrada se despliega para explicar el patrón y mostrar cómo lo usa esta decisión (Aquí) o cómo adoptarlo (Prueba).
El panel detecta un patrón a partir del schema:
| Patrón | Se detecta cuando la decisión tiene… |
|---|---|
| Fan-out especulativo | 4 o más preguntas, o 3 o más con una regla cuyas condiciones usan campos distintos |
| Enrutamiento filtrado por confianza | una pregunta con una confianza mínima, o una regla sobre confidence |
| Puntuación compuesta | al menos un compuesto |
| Enrutamiento por intención | una pregunta de elección con al menos 3 opciones además de other, o una regla sobre una respuesta de elección |
Los patrones se combinan
La mayoría de las decisiones en producción usan más de un patrón. La plantilla Lead Qualification enruta el lead a un equipo (enrutamiento por intención), escala cuando purchase_intent no tiene suficiente confianza (enrutamiento filtrado por confianza) y ordena los leads con lead_score (puntuación compuesta), todo en una llamada. Plantillas lista los patrones de cada plantilla.
Escribe preguntas que el motor pueda responder
Los patrones combinan respuestas; cada respuesta tiene que ser buena igualmente. Mantén las preguntas atómicas y literales, deja las cuentas y las fechas en el código y envía solo el estado que las preguntas necesitan; consulta Escribir buenas preguntas.
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.
Fan-out especulativo
Haz en una llamada todas las preguntas que un flujo podría necesitar — Jev las responde en paralelo — y deja que las reglas AND y tu código decidan qué respuestas importan. Basado en la plantilla Support Ticket Triage.