Visão geral dos destinos
O que acontece depois de uma decisão — por opção, nível, limiar de probabilidade ou ação final — respostas fixas, saídas estruturadas, LLMs, seu agente, workflows, webhooks assinados, requisições HTTP e funções.
Uma decisão responde o quê: result, confidence e a action. Os destinos dizem o que acontece depois para cada resultado — como as opções de uma URA. Anexe um ou mais destinos a uma opção (route = sales), a um nível de nota (priority = critical), a um limiar de probabilidade (purchase_intent ≥ 0.8) ou a uma ação final (escalate), e toda chamada que cair ali responde a quem chamou, repassa o caso ou diz ao seu código o que executar.
Os destinos fazem parte do decision schema: são editados no rascunho, testados no Playground e chegam à produção quando você faz o deploy, como as perguntas e as 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 | No app | Quem executa | O que acontece |
|---|---|---|---|
reply | Resposta fixa | A Dcision o renderiza | Devolve uma mensagem pronta — texto e botões — na resposta. Sem chamada de modelo. |
json | Saída estruturada (JSON) | A Dcision — a partir de um template, ou um LLM com a sua chave | Devolve um objeto JSON conferido com os seus campos, no output da resposta. Veja Saída estruturada. |
llm | LLM | A Dcision chama o OpenRouter ou o Vercel AI Gateway com a sua chave | Um modelo responde com o prompt da rota; o texto dele volta na resposta. |
agent | Agente | A Dcision chama o endpoint do seu agente | sync: a resposta do agente volta na resposta. async: um repasse, entregue em segundo plano. |
workflow | Workflow | A Dcision, em segundo plano | Dispara n8n, Make, Zapier, Pipedream ou qualquer URL de workflow com as variáveis da rota. |
webhook | Webhook | A Dcision, em segundo plano | Faz POST do resultado assinado da decisão para a sua URL. |
http | Requisição de API | A Dcision, em segundo plano | Chama qualquer API: método, URL, headers e um body JSON com variáveis e segredos. |
function | Função | O seu código | A resposta indica uma função e seus params; os SDKs chamam o seu handler. |
O editor os agrupa da mesma forma: Responder a quem chamou (resposta fixa, saída estruturada, LLM, agente), Repassar (workflow, webhook, requisição de API) e Seu código (função).
Qual usar
- Responder a um usuário final na hora com um texto conhecido — uma confirmação, um link, botões de resposta rápida: uma resposta fixa. Não custa nada e não adiciona latência.
- Responder com texto gerado, específico da rota — "você é o time de cobrança…": uma resposta de LLM, com a sua chave OpenRouter ou Vercel AI Gateway.
- Deixar o seu próprio agente assumir, com as ferramentas e a memória dele: um agente —
syncpara devolver a resposta dele agora,asyncpara repassar. - Iniciar uma automação no-code no n8n, Make, Zapier ou Pipedream: um workflow.
- Notificar o seu backend com um evento assinado: um webhook.
- Chamar diretamente uma API de terceiros — criar um lead no CRM, abrir um ticket, postar no Slack — com um token guardado nos segredos do workspace: uma requisição de API.
- Executar código no processo que chamou a decisão: uma função, despachada pelos SDKs.
Uma decisão pode combiná-los: route = sales pode devolver uma resposta fixa e disparar um workflow de CRM e dizer ao seu código para atribuir um responsável.
O que uma chamada devolve
Os destinos são selecionados depois que a ação é escolhida. A resposta ganha um array destinations com uma entrada por destino que disparou, na ordem do schema:
- Respostas fixas e funções são devolvidas na hora.
- Respostas de LLM e agentes no modo
syncsão chamados enquanto quem chamou espera — em paralelo, cada um com seu próprio timeout — e as respostas deles são devolvidas. - Webhooks, requisições de API, workflows e agentes no modo
asyncentram na fila e são entregues em segundo plano, com novas tentativas: a resposta devolve odelivery_iddeles.
{
"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 sempre que a decisão tem destinos — [] quando nenhum disparou — e ausente caso contrário. Cada entrada é descrita em Executar uma decisão.
Destinos nunca derrubam a decisão
Um destino que não consegue rodar — um param faltando, um LLM sem chave, um agente inacessível, uma fila cheia — aparece na sua própria entrada (skipped ou failed). A decisão continua respondendo 200 com o resultado e a ação, e é cobrada como qualquer outra.
Configure-os no editor
Escolha a resposta
No card Perguntas do editor, cada opção de escolha tem um seletor de Destino na própria linha. Ele mostra o tipo do destino já anexado (com +1, +2… quando há mais); na opção reservada other ele mostra Fallback · escalate — a ação de fallback da decisão — até você anexar um.
- Perguntas de nota têm uma linha Destino por nível: um seletor por nível.
- Perguntas de probabilidade têm Destino quando … ≥ …: um limiar sobre a probabilidade de sim, 0.8 por padrão.
Escolha o tipo
Clique no seletor para abrir o painel Quando route = sales. Ele lista os destinos daquela resposta, editáveis no lugar; Adicionar destino mostra os oito tipos como cards, agrupados em Responder a quem chamou, Repassar e Seu código.
Configure-o
Cada destino tem uma chave (snake_case, única na decisão), um switch Ativo e:
- Quando — as condições que o fazem disparar. O painel já traz
route = sales; defina uma Confiança mínima para esta rota em porcentagem, adicione mais condições ou exija uma ação final. Veja Gatilhos. - As configurações do tipo — o texto da resposta, o modelo e o prompt, o endpoint do agente, a URL…
- Params — as variáveis que ele usa, de um campo ou de um valor fixo. Veja Params e templates.
Teste e publique
Rode o rascunho no Playground: os destinos aparecem em prévia — nada é enviado — até você ligar Executar destinos de verdade. Depois faça o deploy: as chamadas de API disparam os destinos da nova versão.
O card Destinos, depois de Políticas no editor, lista todos os destinos da decisão (até 20) e adiciona os que não estão presos a uma única resposta — por exemplo toda decisão, ou a ação é escalate.
No construtor visual
A paleta do construtor tem um grupo Destinos com os oito tipos. Os destinos aparecem como nós depois do nó Saída, ligados por uma aresta rotulada com o gatilho (route = sales · route confidence ≥ 0.8) — tracejada quando o destino está desligado. As opções de escolha mostram uma pequena contagem dos destinos anexados a elas. Selecione um nó para editá-lo no inspetor.
A paleta, cada um dos seus grupos e o inspetor são recolhíveis; o layout fica salvo no seu navegador, e selecionar um nó reabre um inspetor recolhido.
No 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 | Padrão | Descrição |
|---|---|---|---|
key | string | — | Única entre os destinos da decisão; snake_case, até 48 caracteres. Identifica a entrada nas respostas, nas entregas e na Visão geral. |
description | string | — | Opcional, até 2.000 caracteres. |
enabled | boolean | true | Destinos desligados nunca disparam. |
when | object | toda decisão | conditions (AND) e actions — veja Gatilhos. |
type | string | — | reply, json, llm, agent, workflow, webhook, http ou function. |
params | object | {} | Até 30 variáveis — veja Params e templates. |
reply, json, llm, agent, workflow, webhook, http, function | object | — | As configurações do tipo: exatamente o bloco nomeado em type. |
Salvar ou publicar um schema com um destino inválido falha com 422 INVALID_SCHEMA e um caminho como destinations.1.workflow.url — o editor o liga com Ir para o erro.
Papéis
| Ação | Quem |
|---|---|
| Adicionar, editar e remover destinos (eles fazem parte da decisão), publicá-los | Membros, Admins e o Proprietário |
| Reenviar uma entrega com falha | Membros, Admins e o Proprietário |
| Ver as entregas e o status delas | Todos no workspace, Leitores incluídos |
| Ver os nomes dos segredos do workspace | Membros, Admins e o Proprietário |
| Adicionar, substituir ou excluir segredos; revelar ou trocar o segredo de assinatura | Admins e o Proprietário |
Veja Time, papéis e conta.
Próximos passos
Roteamento por intenção
Classifique cada pedido numa chamada rápida e mande-o ao handler capaz mais barato — código, um LLM especialista ou uma pessoa. Construído sobre o template Customer Service Router.
Gatilhos de destino
Quando um destino dispara — condições sobre respostas, confiança, níveis ponderados e composites, ações finais, uma confiança mínima por rota, níveis de nota, limiares de probabilidade — e em que ordem.