Disparadores de destinos

Cuándo se dispara un destino — condiciones sobre respuestas, confianza, niveles ponderados y compuestos, acciones finales, una confianza mínima por ruta, niveles de score, umbrales de probabilidad — y en qué orden.

Cada destino tiene un objeto when. Se dispara cuando la acción final de la decisión es una de when.actions (si defines alguna) y se cumple cada condición de when.conditions:

{
  "conditions": [
    { "field": "route", "on": "output", "operator": "eq", "value": "sales" },
    { "field": "route", "on": "confidence", "operator": "gte", "value": 0.8 }
  ],
  "actions": ["continue"]
}
PropiedadTipoPor defectoDescripción
conditionsarray[]Hasta 5 condiciones, que deben cumplirse todas. Misma forma que una condición de política: field, on (output, confidence o score), operator y value.
actionsarray—Se dispara solo cuando la acción final es una de estas: continue, block, escalate, fallback.

Un when vacío se dispara después de cada decisión.

Por opción

El disparador más común, y el que crea el selector Destino de una opción: la respuesta de la pregunta es igual a la opción.

{ "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] }

Usa neq para "todas las rutas excepto spam". La opción reservada other es una respuesta como cualquier otra: un destino sobre route = other se dispara cuando ninguna opción encaja — mientras que la acción de fallback de la decisión (escalate por defecto) le dice a tu código que una persona debería revisarlo.

Confianza mínima por ruta

El campo Confianza mínima de un destino agrega una condición confidence ≥ sobre la misma pregunta, de modo que la ruta solo se dispara cuando el motor está lo bastante seguro:

{
  "conditions": [
    { "field": "route", "on": "output", "operator": "eq", "value": "sales" },
    { "field": "route", "on": "confidence", "operator": "gte", "value": 0.8 }
  ]
}

Es independiente del minConfidence propio de la pregunta, que cambia la acción: una respuesta de baja confianza recibe la acción de fallback y action_reason.type = "low_confidence", sean cuales sean los destinos. Combina ambos, o dale a cada ruta su propio umbral — una ruta de reembolso puede exigir 0.9 mientras que una ruta de "enviar un artículo" acepta 0.6. Consulta enrutamiento filtrado por confianza.

Por nivel de score

Los selectores de una pregunta score crean una condición sobre el nivel más probable:

{ "conditions": [{ "field": "priority", "on": "output", "operator": "eq", "value": "critical" }] }

Los niveles también se pueden comparar por número (1 = el primer nivel) con cualquier operador — "operator": "gte", "value": 3 es high o critical en una escala de cuatro niveles — o por nivel ponderado con "on": "score", que puede caer entre niveles: "on": "score", "operator": "gte", "value": 3.5.

Umbrales de probabilidad

Destino cuando … ≥ … en una pregunta probability crea un umbral sobre la probabilidad de yes, 0.8 por defecto:

{ "conditions": [{ "field": "purchase_intent", "on": "output", "operator": "gte", "value": 0.8 }] }

Compuestos y otras respuestas

Una condición puede usar cualquier pregunta o compuesto de la decisión, así que un destino no tiene que seguir la pregunta a cuyo panel pertenece: lead_score ≥ 0.75 envía los leads calientes a un workflow sea cual sea la ruta.

{
  "conditions": [
    { "field": "lead_score", "on": "output", "operator": "gte", "value": 0.75 },
    { "field": "route", "on": "output", "operator": "neq", "value": "spam" }
  ]
}

Acciones finales

actions vincula un destino al veredicto en lugar de a una respuesta — cada escalate publica en Slack, cada block abre un ticket de moderación:

{ "actions": ["escalate"] }

Con conditions y actions a la vez, deben cumplirse ambas.

Validación

Las condiciones siguen las reglas de las condiciones de política, y se verifican cuando guardas o publicas — 422 INVALID_SCHEMA en caso contrario:

  • el field debe ser una pregunta o un compuesto de la decisión;
  • las respuestas choice solo admiten eq y neq, y el valor debe ser una de las opciones;
  • las probabilidades y la confianza son números de 0 a 1 — 0.7, no 70;
  • los niveles de score van de 1 al número de niveles, o usan la etiqueta de un nivel;
  • los compuestos van de −1 a 1 (de 0 a 1 con pesos positivos).

Evaluación

Después de elegir la acción, Dcision recorre los destinos en el orden del schema:

  1. Un destino desactivado ("enabled": false) se ignora.
  2. Se verifican sus actions y conditions. Los destinos que no coinciden no dejan ninguna entrada.
  3. Se resuelven sus params. Cuando un param marcado como required no tiene valor, el destino no se dispara: su entrada dice "status": "skipped", "reason": "missing_param" e indica el param.
  4. Como máximo se disparan 10 destinos por ejecución, y como máximo 3 de ellos pueden hacer esperar a quien llama — respuestas LLM y agentes en modo sync. Más allá de eso, la entrada dice "status": "skipped", "reason": "limit".
  5. El resto se ejecuta: las respuestas fijas y las funciones se devuelven, las llamadas a LLM y a agentes sync se esperan en paralelo, y las entregas en segundo plano se ponen en cola.

Cuando el motor falla

Con onEngineError: "fallback", una falla del motor responde 200 con la acción de fallback y sin respuestas. Entonces:

  • los destinos con condiciones no se disparan — no hay respuesta con la que comparar;
  • los destinos sin condiciones sí, filtrados por actions cuando está definido — el lugar indicado para una alerta como escalate → avisar a la persona de guardia;
  • las variables result.*, confidence.*, scores.* y composites.* son null.

Las respuestas de fallback se reintentan de verdad

Los fallbacks por error del motor no se guardan para idempotencia: reintentar la llamada con la misma Idempotency-Key ejecuta la decisión de nuevo, y sus destinos se vuelven a disparar con nuevos IDs de entrega. Deduplica esas alertas de tu lado — por ejemplo, con tu propio ID de registro.

Reproducciones

Una reproducción idempotente devuelve la respuesta guardada — incluidas sus entradas de destinations y sus IDs de entrega — y no vuelve a disparar nada. Los SDKs, sin embargo, vuelven a despachar las funciones de una respuesta reproducida, así que haz que los handlers de funciones sean idempotentes.

En esta página