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:

ConfianzaComportamiento
AltaActuar automáticamente.
MediaAvanzar con cautela: pedir al usuario que confirme, marcar para revisión o reunir más información.
BajaNo 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 TypeSafeEn 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ínLa 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:

  1. IF intent · respuesta · = · approve_transfer, + AND intent · confianza · < · 0.9 — THEN escalate.
  2. IF intent · respuesta · = · transfer_money, + AND intent · confianza · < · 0.8 — THEN escalate.

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." }'
200 OK
{
  "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:

Comandoresult.intentconfidence.intentactionaction_reason
"Yeah, go ahead and approve that payment to my landlord."approve_transfer0.8125escalate{ "type": "policy", "rule": 0 }
"What's my balance?"check_balance0.95continue{ "type": "default" }
"Uh, the thing from before, with the money"check_balance0.4escalate{ "type": "low_confidence", "question": "intent", "confidence": 0.4, "minConfidence": 0.6 }
"Change my mailing address"other0.9escalate{ "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_error

Ajústalo

  • Empieza de forma conservadora y luego mide. Obtén las ejecuciones recientes con GET /v1/executions o la pantalla Ejecuciones, compara confidence con 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 and cada 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, other incluida: agregar o quitar opciones mueve la escala.
  • Las preguntas probability tienen otra confianza. Para una probability de sí/no, la confianza es |2p − 1|: un minConfidence de 0.6 marca todo p entre 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 responde escalate con action_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

En esta página