Compuestos

Combina varias respuestas en un solo número con pesos que tú controlas — Σ(peso × valor) / Σ|peso| — devuélvelo en composites y úsalo en las políticas.

Un compuesto es una combinación ponderada de respuestas que Dcision calcula después de que responde el motor. Úsalo para clasificar (un puntaje de lead, el encaje de un currículum, un puntaje de riesgo), para aplicar un umbral sobre varias señales a la vez, o simplemente para mantener los pesos en la decisión en lugar de en un prompt.

El motor responde preguntas pequeñas y atómicas; el compuesto hace la aritmética. Esa división importa: Jev es bueno juzgando y flojo en matemáticas, así que las matemáticas se quedan en Dcision — exactas, versionadas y fáciles de ajustar. Es el patrón de puntuación compuesta integrado en el esquema.

Definir un compuesto

Los compuestos viven en el array composites del esquema. Este viene de la plantilla Calificación de leads:

{
  "key": "lead_score",
  "description": "0–1 ranking: intent counts double, priority adds, spam-like routes don't count",
  "terms": [
    { "question": "purchase_intent", "weight": 2 },
    { "question": "priority", "weight": 1 },
    { "question": "route", "option": "sales", "weight": 1 }
  ]
}
PropiedadTipoObligatorioDescripción
keystringSísnake_case, única entre las preguntas y los compuestos de la decisión. La clave en composites de la respuesta y en las políticas.
descriptionstringNoHasta 500 caracteres. Solo documentación: no se envía al motor.
termsarraySíDe 1 a 20 términos.

Cada término apunta a una pregunta:

PropiedadTipoObligatorioDescripción
questionstringSíLa clave de una pregunta de esta decisión.
optionstringSolo preguntas choiceLa opción cuya probabilidad cuenta — obligatoria para una pregunta choice, rechazada para las demás.
weightnumberSíDe −100 a 100, distinto de 0. Los pesos negativos restan.

Una decisión tiene hasta 20 compuestos. Los errores hacen que el esquema no sea válido (422 INVALID_SCHEMA) con mensajes como Unknown question "intent"., "route" has no option "buyer". o Pick the option whose probability counts.

Cómo se calcula el valor

composite = Σ(weight × term value) / Σ|weight|

Cada término aporta un valor entre 0 y 1:

Tipo de preguntaValor del término
probabilityla probabilidad de sí — la propia respuesta
scoreel nivel ponderado normalizado, (level − 1) / (levels − 1): 0 en el primer nivel, 1 en el último. El nivel ponderado es el que se devuelve en scores
choicela probabilidad de option en la distribución de la pregunta
  • Con pesos positivos, el compuesto está entre 0 y 1; con pesos negativos, entre −1 y 1.
  • Se redondea a 4 decimales.
  • Los términos sin una respuesta utilizable se omiten, y un compuesto sin ningún término utilizable queda fuera de la respuesta.

Para el lead de arriba — purchase_intent 0.9412, priority en el nivel ponderado 2.81 de una escala de 4 niveles, route = sales con probabilidad 0.88:

priority term = (2.81 − 1) / (4 − 1) = 0.6033
lead_score    = (2 × 0.9412 + 1 × 0.6033 + 1 × 0.88) / (2 + 1 + 1) = 0.8414

En la respuesta

La respuesta incluye un objeto composites, indexado por las claves de tus compuestos, siempre que la decisión defina compuestos:

{
  "result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
  "scores": { "priority": 2.81 },
  "composites": { "lead_score": 0.8414 },
  "action": "continue"
}

El Playground muestra los compuestos en su propia tarjeta, el Contrato de la API del editor los lista como números, y las ejecuciones los guardan cuando storeOutput está activado.

En las políticas

Una regla de política puede comparar un compuesto con un número, con cualquiera de los seis operadores — on sigue siendo output, el valor predeterminado:

{ "field": "lead_score", "operator": "gte", "value": 0.75, "action": "continue" }

Los compuestos se combinan con condiciones and como cualquier otro campo. La plantilla Evaluación de currículums bloquea a un candidato solo cuando ambos encajes de rol son bajos:

{
  "field": "senior_ic",
  "on": "output",
  "operator": "lt",
  "value": 0.35,
  "and": [{ "field": "eng_manager", "on": "output", "operator": "lt", "value": 0.35 }],
  "action": "block"
}

Consulta Políticas y acciones.

En el editor

En la pestaña Editor de la decisión, la tarjeta Compuestos está entre Preguntas y Políticas:

  1. Haz clic en Agregar compuesto y ponle nombre — por ejemplo lead_score — con una descripción opcional.
  2. Cada término se lee peso × pregunta: define el peso y elige la pregunta. Para una pregunta choice, elige también la opción, que se muestra como p(option); los términos de score dicen nivel normalizado y los de probability p(sí).
  3. Agregar término para cada dimensión, hasta 20.

Después, los compuestos aparecen en Compuestos en la lista de campos de cada regla de política. Renombrar un compuesto actualiza las reglas que empiezan con él; después de quitar uno, revisa la tarjeta Políticas — las condiciones que aún apuntan a él se marcan como problemas por corregir. El constructor visual todavía no muestra los compuestos — edítalos en la pestaña Editor.

Consejos

  • Una dimensión por pregunta. Un compuesto solo es tan bueno como sus términos: preguntas atómicas y literales — consulta Escribir buenas preguntas.
  • Ajusta los pesos, no la redacción. Los pesos cambian el ranking sin tocar lo que lee el motor, y cada cambio sale como una nueva versión.
  • Varias vistas de las mismas respuestas. Dos compuestos sobre las mismas preguntas — encaje como Senior IC y como Engineering Manager — no cuestan nada extra: ni una pregunta nueva ni una llamada nueva al motor.
  • Usa pesos negativos para los descalificadores, por ejemplo lead_score = 2 × purchase_intent + 1 × priority − 3 × spam.
  • Aplica umbrales, no interpoles. Los niveles ponderados sirven para decisiones de "por encima o por debajo"; no los uses para reconstruir un número exacto entre dos niveles.

En esta página