Visión general de los destinos
Qué pasa tras una decisión — por opción, nivel de puntaje, umbral de probabilidad o acción final — respuestas fijas o de LLM, salida estructurada, tu agente, workflows, webhooks firmados, llamadas HTTP y funciones.
Una decisión responde qué: result, confidence y la action. Los destinos dicen qué pasa después con cada resultado — como las rutas de un menú telefónico. Asocia uno o más destinos a una opción (route = sales), un nivel de puntaje (priority = critical), un umbral de probabilidad (purchase_intent ≥ 0.8) o una acción final (escalate), y cada llamada que llega ahí responde a quien llama, delega el caso o le dice a tu código qué ejecutar.
Los destinos forman parte del schema de la decisión: se editan en el borrador, se prueban en el Playground y llegan a producción cuando haces deploy, igual que las preguntas y las políticas.
state ──▶ answers ──▶ composites ──▶ policies ──▶ action ──▶ destinations
├─ answer the caller: fixed reply · structured output · LLM · agent
├─ hand off: workflow · webhook · API request
└─ your code: functionTipos de destino
| Tipo | En la app | Quién lo ejecuta | Qué pasa |
|---|---|---|---|
reply | Respuesta fija | Dcision lo renderiza | Devuelve un mensaje listo — texto y botones — en la respuesta. Sin llamar a un modelo. |
json | Salida estructurada (JSON) | Dcision — a partir de una plantilla, o un LLM con tu clave | Devuelve un objeto JSON verificado con tus campos, en el output de la respuesta. Consulta Salida estructurada. |
llm | LLM | Dcision llama a OpenRouter o Vercel AI Gateway con tu clave | Un modelo responde con el prompt de la ruta; su texto vuelve en la respuesta. |
agent | Agente | Dcision llama al endpoint de tu agente | sync: la respuesta del agente vuelve en la respuesta. async: una delegación, entregada en segundo plano. |
workflow | Workflow | Dcision, en segundo plano | Dispara n8n, Make, Zapier, Pipedream o cualquier URL de workflow con las variables de la ruta. |
webhook | Webhook | Dcision, en segundo plano | Envía por POST el resultado firmado de la decisión a tu URL. |
http | Solicitud de API | Dcision, en segundo plano | Llama a cualquier API: método, URL, headers y un body JSON con variables y secretos. |
function | Función | Tu código | La respuesta indica una función y sus params; los SDKs llaman a tu handler. |
El editor los agrupa de la misma forma: Responder a quien llama (respuesta fija, salida estructurada, LLM, agente), Delegar (workflow, webhook, solicitud de API) y Tu código (función).
Cuál usar
- Responder de inmediato a un usuario final con un texto conocido — una confirmación, un enlace, botones de respuesta rápida: una respuesta fija. No cuesta nada y no agrega latencia.
- Responder con texto generado, específico de la ruta — "eres el equipo de facturación…": una respuesta de LLM, con tu clave de OpenRouter o Vercel AI Gateway.
- Dejar que tu propio agente tome el control, con sus herramientas y su memoria: un agente —
syncpara devolver su respuesta ahora,asyncpara delegar. - Iniciar una automatización no-code en n8n, Make, Zapier o Pipedream: un workflow.
- Notificar a tu backend con un evento firmado: un webhook.
- Llamar directamente a una API de terceros — crear un lead en el CRM, abrir un ticket, publicar en Slack — con un token guardado en los secretos del workspace: una solicitud de API.
- Ejecutar código en el proceso que llamó a la decisión: una función, despachada por los SDKs.
Una decisión puede combinarlos: route = sales puede devolver una respuesta fija y disparar un workflow del CRM y decirle a tu código que asigne un responsable.
Qué devuelve una llamada
Los destinos se seleccionan después de elegir la acción. La respuesta recibe un array destinations con una entrada por cada destino que se disparó, en el orden del schema:
- Las respuestas fijas y las funciones se devuelven de inmediato.
- Las respuestas de LLM y los agentes en modo
syncse llaman mientras quien llama espera — en paralelo, cada uno con su propio timeout — y se devuelven sus respuestas. - Los webhooks, las solicitudes de API, los workflows y los agentes en modo
asyncse ponen en cola y se entregan en segundo plano, con reintentos: la respuesta devuelve sudelivery_id.
{
"decision_id": "dec_3fKq9ZtW1mXcV7bN2pLa",
"execution_id": "exec_8HsT2kQw9ZyR4vMn1cXe",
"schema": "lead-qualification",
"version": 4,
"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" },
"destinations": [
{
"key": "sales_reply",
"type": "reply",
"text": "Thanks! Someone from our sales team will contact you today.",
"buttons": ["Book a demo", "See pricing"]
},
{ "key": "sales_crm", "type": "workflow", "status": "queued", "delivery_id": "dlv_8kJx2mQp4LzN7vR1tY6w" },
{
"key": "hot_lead",
"type": "function",
"function": "assignToSales",
"params": { "message": "We need pricing for 500 users and want to start next month." }
}
],
"metrics": {
"latency_ms": 418,
"engine": "jev",
"model": "jev-1.13.0",
"estimated_cost_usd": 0.00001575,
"input_tokens": 375,
"output_tokens": 36
}
}destinations está presente siempre que la decisión tiene destinos — [] cuando ninguno se disparó — y ausente en caso contrario. Cada entrada se describe en Ejecutar una decisión.
Los destinos nunca hacen fallar la decisión
Un destino que no puede ejecutarse — un param faltante, un LLM sin clave, un agente inalcanzable, una cola llena — aparece en su propia entrada (skipped o failed). La decisión igual responde 200 con su resultado y su acción, y se factura como cualquier otra.
Configúralos en el editor
Elige la respuesta
En la tarjeta Preguntas del editor, cada opción de una pregunta choice tiene un selector de Destino en su propia fila. Muestra el tipo del destino ya asociado (con +1, +2… cuando hay más); en la opción reservada other dice Fallback · escalate — la acción de fallback de la decisión — hasta que asocies uno.
- Las preguntas score tienen una fila Destino por nivel: un selector por nivel.
- Las preguntas probability tienen Destino cuando … ≥ …: un umbral sobre la probabilidad de sí, 0.8 por defecto.
Elige el tipo
Haz clic en el selector para abrir el panel Cuando route = sales. Lista los destinos de esa respuesta, editables en el mismo lugar; Agregar destino muestra los ocho tipos como tarjetas, agrupados en Responder a quien llama, Delegar y Tu código.
Configúralo
Cada destino tiene una clave (snake_case, única en la decisión), un interruptor Activo y:
- Cuándo — las condiciones que lo disparan. El panel ya contiene
route = sales; define una Confianza mínima para esta ruta en porcentaje, agrega más condiciones o exige una acción final. Consulta Disparadores. - La configuración del tipo — el texto de la respuesta, el modelo y el prompt, el endpoint del agente, la URL…
- Params — las variables que usa, desde un campo o un valor fijo. Consulta Params y plantillas.
Prueba y despliega
Ejecuta el borrador en el Playground: los destinos se previsualizan — no se envía nada — hasta que actives Ejecutar los destinos de verdad. Luego despliega: las llamadas a la API disparan los destinos de la nueva versión.
La tarjeta Destinos, después de Políticas en el editor, lista todos los destinos de la decisión (hasta 20) y agrega los que no están ligados a una sola respuesta — por ejemplo cada decisión, o la acción es escalate.
En el editor visual
La paleta del editor visual tiene un grupo Destinos con los ocho tipos. Los destinos aparecen como nodos después del nodo Salida, conectados por una arista etiquetada con el disparador (route = sales · route confidence ≥ 0.8) — punteada cuando el destino está desactivado. Las opciones de las preguntas choice muestran un pequeño contador de los destinos asociados a ellas. Selecciona un nodo para editarlo en el inspector.
La paleta, cada uno de sus grupos y el inspector se pueden contraer; el diseño se recuerda en tu navegador, y seleccionar un nodo vuelve a abrir un inspector contraído.
En el schema
{
"destinations": [
{
"key": "sales_reply",
"type": "reply",
"when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] },
"reply": { "text": "Thanks! Someone from our sales team will contact you today.", "buttons": ["Book a demo", "See pricing"] }
},
{
"key": "sales_crm",
"type": "workflow",
"when": {
"conditions": [
{ "field": "route", "on": "output", "operator": "eq", "value": "sales" },
{ "field": "route", "on": "confidence", "operator": "gte", "value": 0.8 }
]
},
"params": {
"message": { "from": "state.message", "required": true },
"company_size": { "from": "state.company_size" },
"lead_score": { "from": "composites.lead_score" }
},
"workflow": { "platform": "n8n", "url": "{{secrets.N8N_LEADS_WEBHOOK}}", "name": "New sales lead" }
},
{
"key": "hot_lead",
"type": "function",
"when": { "conditions": [{ "field": "purchase_intent", "on": "output", "operator": "gte", "value": 0.8 }] },
"params": { "message": { "from": "state.message" } },
"function": { "name": "assignToSales" }
},
{
"key": "escalation_alert",
"type": "http",
"when": { "actions": ["escalate"] },
"http": {
"method": "POST",
"url": "{{secrets.SLACK_WEBHOOK}}",
"body": "{\"text\": \"A lead needs a person: {{decision.slug}} execution {{execution.id}}\"}"
}
}
]
}| Campo | Tipo | Predeterminado | Descripción |
|---|---|---|---|
key | string | — | Única entre los destinos de la decisión; snake_case, hasta 48 caracteres. Identifica la entrada en las respuestas, las entregas y el Resumen. |
description | string | — | Opcional, hasta 2,000 caracteres. |
enabled | boolean | true | Los destinos desactivados nunca se disparan. |
when | object | cada decisión | conditions (AND) y actions — consulta Disparadores. |
type | string | — | reply, json, llm, agent, workflow, webhook, http o function. |
params | object | {} | Hasta 30 variables — consulta Params y plantillas. |
reply, json, llm, agent, workflow, webhook, http, function | object | — | La configuración del tipo: exactamente el bloque indicado en type. |
Guardar o desplegar un schema con un destino inválido falla con 422 INVALID_SCHEMA y una ruta como destinations.1.workflow.url — el editor la enlaza con Ir al error.
Roles
| Acción | Quién |
|---|---|
| Agregar, editar y quitar destinos (forman parte de la decisión), desplegarlos | Members, Admins y el Owner |
| Reenviar una entrega fallida | Members, Admins y el Owner |
| Ver las entregas y su estado | Todos en el workspace, incluidos los Viewers |
| Ver los nombres de los secretos del workspace | Members, Admins y el Owner |
| Agregar, reemplazar o eliminar secretos; revelar o rotar el secreto de firma | Admins y el Owner |
Consulta Equipo, roles y cuenta.
Próximos pasos
Enrutamiento por intención
Clasifica cada solicitud en una llamada rápida y envíala al manejador capaz más barato — código, un LLM especializado o una persona. Basado en la plantilla Enrutador de atención al cliente.
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.