Confianza y probabilidades

Qué significa la confianza para cada tipo de pregunta en una sola escala de 0 a 1, cómo afecta a minConfidence, los niveles ponderados, las distribuciones de probabilidad completas y los casi empates.

El motor no solo elige una respuesta: devuelve una distribución de probabilidad para cada pregunta. Dcision la convierte en una confianza por pregunta — siempre — y puede devolver la distribución completa cuando la pides.

Probabilidades calibradas

Jev se entrena con RLCD — reinforcement learning for calibrated decisions — para devolver probabilidades que significan lo que dicen. A lo largo de muchas predicciones de un modelo bien calibrado, los resultados a los que se asigna una probabilidad de 0.2 ocurren aproximadamente el 20% de las veces, y los de 0.8 aproximadamente el 80%. Es una propiedad de grupos de respuestas, no una garantía sobre cada una — y eso es exactamente lo que hace funcionar los umbrales, la escalación y la auditoría.

Confianza

confidence tiene un número de 0 a 1 por pregunta, con las mismas claves que result. Sigue la definición de TypeSafe, así que todos los tipos de pregunta comparten una sola escala: 1 cuando toda la probabilidad está en una respuesta, 0 cuando está repartida de forma pareja o la respuesta es un cara o cruz.

Tipo de preguntaLa confianza es…Fórmula
choicecuánto se eleva la opción elegida por encima de un reparto parejo entre las n opciones, other incluida(p_max − 1/n) / (1 − 1/n)
scorequé tan concentrada está la distribución alrededor del nivel más probable — la probabilidad en un nivel vecino la reduce menos que la probabilidad lejana1 − spread / spread of an even distribution, con mínimo 0
probabilityla distancia a un cara o cruz|2p − 1|
  • En las preguntas choice y score, Dcision usa la confianza que informa el motor, calculada con estas fórmulas; solo las aplica por su cuenta si el motor la omite.
  • Ejemplos: una choice con cinco opciones y p_max = 0.88 tiene confianza 0.85. Una probabilidad de 0.9412 tiene confianza 0.8824; 0.03 tiene 0.94; 0.5 tiene 0.
  • En las preguntas score, spread es la distancia ponderada por probabilidad, en niveles, desde el nivel más probable. Con tres niveles, (0, 0.5, 0.5) — dudando entre vecinos — tiene confianza 0.25, mientras que (0.5, 0, 0.5) — dudando entre extremos opuestos — tiene confianza 0.

Usa la confianza en políticas ("on": "confidence") o con el minConfidence de una pregunta para enviar las respuestas inciertas a una persona — consulta Enrutamiento filtrado por confianza.

Confianza mínima en preguntas probability

Como la confianza de una probabilidad es |2p − 1|, un umbral sobre ella marca una franja de probabilidades alrededor de 0.5: una respuesta está por debajo de una confianza mínima c cuando p cae estrictamente entre (1 − c) / 2 y (1 + c) / 2.

minConfidenceMarca las probabilidades entre
0.50.25 y 0.75
0.60.2 y 0.8
0.80.1 y 0.9
0.90.05 y 0.95

Lo mismo vale para las reglas con "on": "confidence": una confianza de purchase_intent lt 0.6 coincide con todo p entre 0.2 y 0.8. El editor muestra la franja junto al control deslizante Confianza mínima de las preguntas probability.

¿Vienes de v0.1?

Hasta v0.2 (5 de octubre de 2026), la confianza de una probabilidad era max(p, 1 − p). El nuevo valor es menor para la misma respuesta — p = 0.8 tenía confianza 0.8 y ahora tiene 0.6. Para mantener el comportamiento de un umbral antiguo t, usa 2t − 1: un 0.8 antiguo pasa a ser 0.6. Las preguntas choice y score siguen usando la confianza propia del motor; cuando un proveedor la omite, Dcision ahora aplica las fórmulas de arriba en lugar de la probabilidad más alta. Revisa minConfidence y las reglas de confianza de las preguntas probability en el Playground y luego publica una nueva versión.

Niveles ponderados

Para cada pregunta score, la respuesta también incluye scores: el nivel ponderado por probabilidad, contado desde 1. Con la distribución low 0.02 · medium 0.21 · high 0.71 · critical 0.06, el nivel más probable es high (3), y el nivel ponderado es 1 × 0.02 + 2 × 0.21 + 3 × 0.71 + 4 × 0.06 = 2.81.

{
  "result": { "priority": "high" },
  "confidence": { "priority": 0.69 },
  "scores": { "priority": 2.81 }
}
  • Úsalo en reglas con "on": "score" para actuar entre niveles — priority ≥ 3.5 se dispara cuando el peso se inclina hacia critical.
  • Los compuestos lo usan, normalizado a 0–1, como el valor de un término score.
  • Úsalo para umbrales y ordenamiento, no para reconstruir una cantidad exacta: los niveles de score son categorías, no una regla graduada.

Distribuciones completas

Agrega include=probabilities al query string:

curl -X POST "https://api.dcision.io/v1/decisions/lead-qualification?include=probabilities" \
  -H "Authorization: Bearer $DCISION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "state": { "message": "We need pricing for 500 users and want to start next month.", "company_size": 500 } }'

La respuesta incluye un objeto probabilities, entre action_reason y metrics:

{
  "result": { "purchase_intent": 0.9412, "priority": "high", "route": "sales" },
  "confidence": { "purchase_intent": 0.8824, "priority": 0.69, "route": 0.85 },
  "scores": { "priority": 2.81 },
  "composites": { "lead_score": 0.8414 },
  "action": "continue",
  "action_reason": { "type": "default" },
  "probabilities": {
    "purchase_intent": { "yes": 0.9412, "no": 0.0588 },
    "priority": { "low": 0.02, "medium": 0.21, "high": 0.71, "critical": 0.06 },
    "route": { "sales": 0.88, "sdr": 0.09, "nurture": 0.02, "spam": 0, "other": 0.01 }
  }
}
Tipo de preguntaDistribución
choiceuna entrada por opción, en el orden de las opciones, other al final
scoreuna entrada por etiqueta, de la más baja a la más alta
probability{ "yes": p, "no": 1 − p }

Todos los valores se redondean a 4 decimales. include acepta una lista separada por comas; probabilities es el único valor reconocido hoy. Las distribuciones no cambian el precio de una llamada.

El Playground siempre muestra las distribuciones, y las ejecuciones las guardan cuando storeOutput está activado.

Casi empates

Dos opciones están en casi empate cuando la segunda tiene más de 20% de probabilidad y queda a menos de 15 puntos de la primera — por ejemplo { "sales": 0.46, "sdr": 0.40 }. El Playground lo señala:

Casi empate: las opciones principales están cerca. Haz más distintas las descripciones de las opciones (agrega exclusiones).

Un casi empate suele significar que dos descripciones de opción se solapan. Reescríbelas como criterios mutuamente excluyentes ("algo de intención, pero todavía sin presupuesto ni plazo") y vuelve a probar — la comparación con la ejecución anterior muestra si la respuesta cambió.

Usar las distribuciones en tu código

  • Segunda mejor opción. Cuando la acción es escalate, muestra a quien revisa las dos opciones principales con sus probabilidades.
  • Tu propia medida. La distribución es todo lo que necesitas para calcular otra estadística — la probabilidad más alta, o la razón entre las dos opciones principales — cuando se ajusta mejor a tu decisión.
  • Calibra los umbrales. Compara la confianza de ejecuciones pasadas — en Ejecuciones o mediante GET /v1/executions — con lo que realmente ocurrió antes de elegir un minConfidence.

En esta página