Enrutamiento filtrado por confianza
Usa la confianza como segundo eje — la respuesta dice qué, la confianza dice si actuar — con una confianza mínima por pregunta y reglas AND por acción. Basado en la plantilla Voice Banking.
Usa la confianza como un segundo eje: la respuesta te dice qué, la confianza te dice si actuar en consecuencia. Algunas acciones son más arriesgadas que otras, así que necesitan más certeza antes de que tu sistema actúe por su cuenta.
Beneficios: fiabilidad y seguridad. Guía de TypeSafe: Confidence-gated routing.
Por qué funciona
Jev está entrenado para devolver probabilidades calibradas: entre muchas respuestas, las que se dan con alrededor del 80% deberían acertar alrededor del 80% de las veces. Cada respuesta lleva una confianza entre 0 y 1 derivada de esa distribución — 1 cuando toda la probabilidad está en una respuesta, 0 cuando se reparte por igual. "No estoy seguro" se convierte en un número sobre el que tu sistema puede enrutar, en lugar de una respuesta equivocada dicha con seguridad.
Un buen punto de partida son tres caminos:
| Confianza | Comportamiento |
|---|---|
| Alta | Actuar automáticamente. |
| Media | Avanzar con cautela: pedir al usuario que confirme, marcar para revisión o reunir más información. |
| Baja | No actuar: enrutar a una persona, pedir una aclaración o recurrir a otro sistema. |
Dónde están los límites depende de lo que está en juego: los umbrales crecen con el riesgo. Consultar un saldo con un 60% de confianza está bien — en el peor caso se muestra una pantalla equivocada. Aprobar una transferencia, no.
Cuándo usarlo
Cualquier acción con consecuencias: pagos, cambios de cuenta, eliminaciones, mensajes enviados en nombre de alguien, moderación que elimina contenido. Combínalo con el enrutamiento por intención: la intención elige el manejador, la confianza decide si el manejador puede actuar solo.
Cómo se traduce a Dcision
| En la guía de TypeSafe | En Dcision |
|---|---|
if action.confidence < 0.6: route_to_support_agent() | minConfidence: 0.6 en la pregunta — por debajo, la decisión devuelve su acción de fallback (escalate) con action_reason.type = "low_confidence" |
elif choice == "approve_transfer" and confidence > 0.85: approve() | Una regla por acción arriesgada: intent = approve_transfer AND confianza de intent por debajo de 0.9 → escalate |
else: ask_user_to_confirm() | Tu código traduce el escalate de esa regla a "pedir al usuario que confirme" |
| Una opción comodín | La opción reservada other, que también devuelve la acción de fallback |
Primero se ejecutan las reglas, luego la comprobación de other y después minConfidence — consulta Cómo se calcula la acción.
Constrúyelo
En la app
Abre Plantillas y elige Comandos bancarios por voz (filtrado por confianza). Nombra la decisión Voice Banking para que su slug sea voice-banking y luego haz clic en Crear decisión.
El State es de tipo Texto: la transcripción de voz a texto del comando.
La única pregunta, intent, es un choice: check_balance (solo lectura), transfer_money, approve_transfer, block_card y la reservada other. Su Confianza mínima está activada, en 60% — el piso para cualquier acción.
En Políticas, una regla por acción arriesgada, usando la confianza de la pregunta como segunda condición:
- IF
intent· respuesta · = ·approve_transfer, + ANDintent· confianza · < · 0.9 — THENescalate. - IF
intent· respuesta · = ·transfer_money, + ANDintent· confianza · < · 0.8 — THENescalate.
En Motor y runtime, deja la Acción de fallback en escalate. Para un canal de voz que siempre debe responder, considera Si el motor falla → Responder con la acción de fallback (consulta Configuración de la decisión). Prueba y luego haz clic en Publicar v1.
El esquema de decisión
{
"stateSchema": { "kind": "text" },
"questions": [
{
"key": "intent",
"type": "choice",
"instructions": "What does the customer want to do with their account?",
"minConfidence": 0.6,
"options": [
{ "value": "check_balance", "description": "hear the balance or recent transactions (read-only)" },
{ "value": "transfer_money", "description": "start a new transfer to someone" },
{ "value": "approve_transfer", "description": "confirm a transfer that is waiting for approval" },
{ "value": "block_card", "description": "block or freeze a card" }
]
}
],
"policies": [
{
"field": "intent",
"on": "output",
"operator": "eq",
"value": "approve_transfer",
"and": [{ "field": "intent", "on": "confidence", "operator": "lt", "value": 0.9 }],
"action": "escalate"
},
{
"field": "intent",
"on": "output",
"operator": "eq",
"value": "transfer_money",
"and": [{ "field": "intent", "on": "confidence", "operator": "lt", "value": 0.8 }],
"action": "escalate"
}
],
"settings": { "fallbackAction": "escalate" }
}Llámalo
El estado es la transcripción, como string:
curl -X POST https://api.dcision.io/v1/decisions/voice-banking \
-H "Authorization: Bearer $DCISION_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "state": "Yeah, go ahead and approve that payment to my landlord." }'{
"decision_id": "dec_Wb3Kq9Tz1Lm7Xv5Rn2Hd",
"execution_id": "exec_Pz8Nc4Wq1Ht6Ks3Lm9Vb",
"schema": "voice-banking",
"version": 1,
"result": { "intent": "approve_transfer" },
"confidence": { "intent": 0.8125 },
"action": "escalate",
"action_reason": { "type": "policy", "rule": 0 },
"metrics": {
"latency_ms": 248,
"engine": "jev",
"model": "jev-1.13.0",
"estimated_cost_usd": 0.00001008,
"input_tokens": 240,
"output_tokens": 14
}
}La intención es lo bastante clara para superar el piso del 60%, pero aprobar una transferencia necesita un 90%: la regla 0 escala. La misma decisión con otros comandos:
| Comando | result.intent | confidence.intent | action | action_reason |
|---|---|---|---|---|
| "Yeah, go ahead and approve that payment to my landlord." | approve_transfer | 0.8125 | escalate | { "type": "policy", "rule": 0 } |
| "What's my balance?" | check_balance | 0.95 | continue | { "type": "default" } |
| "Uh, the thing from before, with the money" | check_balance | 0.4 | escalate | { "type": "low_confidence", "question": "intent", "confidence": 0.4, "minConfidence": 0.6 } |
| "Change my mailing address" | other | 0.9 | escalate | { "type": "other_option", "question": "intent" } |
Actúa en consecuencia
action_reason distingue los dos tipos de escalate: se disparó una regla porque una acción arriesgada no era lo bastante segura — confírmala — o la decisión no entendió — pasa el control:
const decision = await response.json();
const { action, action_reason: reason, result } = decision;
if (action === "continue") return perform(result.intent, account);
if (reason.type === "policy") {
// A risky intent below its threshold: verify instead of acting.
return voice.ask(`Just to confirm: you want to ${describe(result.intent)}, is that right?`);
}
return transferToAgent(call, { reason }); // low_confidence, other_option or engine_errorAjústalo
- Empieza de forma conservadora y luego mide. Obtén las ejecuciones recientes con
GET /v1/executionso la pantalla Ejecuciones, comparaconfidencecon lo que realmente pasó y mueve cada umbral por separado. - Una regla por nivel de riesgo. Una decisión tiene hasta 50 reglas con hasta 5 condiciones
andcada una — suficiente para un umbral por acción, por nivel de cliente o por franja de importe calculada en tu código. - Vuelve a revisar los umbrales cuando cambian las opciones. La confianza de un choice mide cuánto se aleja la opción principal de un reparto uniforme entre todas las opciones,
otherincluida: agregar o quitar opciones mueve la escala. - Las preguntas probability tienen otra confianza. Para una probability de sí/no, la confianza es
|2p − 1|: unminConfidencede 0.6 marca todopentre 0.2 y 0.8 — consulta Confianza y probabilidades. - Mantén los errores en el mismo camino. Con
onEngineError: "fallback", una caída del motor respondeescalateconaction_reason.type = "engine_error"en lugar de un error HTTP — lo que maneja la última línea de arriba.
Relacionado: Manejar baja confianza y other · Enrutamiento por intención
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.
Puntuación compuesta
Divide un juicio en puntajes atómicos y combínalos con pesos que tú controlas — compuestos calculados por Dcision y utilizables en políticas. Basado en la plantilla Resume Screening.