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:         function

Tipos de destino

TipoEn la appQuién lo ejecutaQué pasa
replyRespuesta fijaDcision lo renderizaDevuelve un mensaje listo — texto y botones — en la respuesta. Sin llamar a un modelo.
jsonSalida estructurada (JSON)Dcision — a partir de una plantilla, o un LLM con tu claveDevuelve un objeto JSON verificado con tus campos, en el output de la respuesta. Consulta Salida estructurada.
llmLLMDcision llama a OpenRouter o Vercel AI Gateway con tu claveUn modelo responde con el prompt de la ruta; su texto vuelve en la respuesta.
agentAgenteDcision llama al endpoint de tu agentesync: la respuesta del agente vuelve en la respuesta. async: una delegación, entregada en segundo plano.
workflowWorkflowDcision, en segundo planoDispara n8n, Make, Zapier, Pipedream o cualquier URL de workflow con las variables de la ruta.
webhookWebhookDcision, en segundo planoEnvía por POST el resultado firmado de la decisión a tu URL.
httpSolicitud de APIDcision, en segundo planoLlama a cualquier API: método, URL, headers y un body JSON con variables y secretos.
functionFunciónTu códigoLa 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 — sync para devolver su respuesta ahora, async para 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 sync se 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 async se ponen en cola y se entregan en segundo plano, con reintentos: la respuesta devuelve su delivery_id.
200 OK — Calificación de leads con destinos
{
  "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

decision.json (extracto)
{
  "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}}\"}"
      }
    }
  ]
}
CampoTipoPredeterminadoDescripción
keystring—Única entre los destinos de la decisión; snake_case, hasta 48 caracteres. Identifica la entrada en las respuestas, las entregas y el Resumen.
descriptionstring—Opcional, hasta 2,000 caracteres.
enabledbooleantrueLos destinos desactivados nunca se disparan.
whenobjectcada decisiónconditions (AND) y actions — consulta Disparadores.
typestring—reply, json, llm, agent, workflow, webhook, http o function.
paramsobject{}Hasta 30 variables — consulta Params y plantillas.
reply, json, llm, agent, workflow, webhook, http, functionobject—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ónQuién
Agregar, editar y quitar destinos (forman parte de la decisión), desplegarlosMembers, Admins y el Owner
Reenviar una entrega fallidaMembers, Admins y el Owner
Ver las entregas y su estadoTodos en el workspace, incluidos los Viewers
Ver los nombres de los secretos del workspaceMembers, Admins y el Owner
Agregar, reemplazar o eliminar secretos; revelar o rotar el secreto de firmaAdmins y el Owner

Consulta Equipo, roles y cuenta.

Próximos pasos

En esta página