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

Tipos de destino

TipoNo appQuem executaO que acontece
replyResposta fixaA Dcision o renderizaDevolve uma mensagem pronta — texto e botões — na resposta. Sem chamada de modelo.
jsonSaída estruturada (JSON)A Dcision — a partir de um template, ou um LLM com a sua chaveDevolve um objeto JSON conferido com os seus campos, no output da resposta. Veja Saída estruturada.
llmLLMA Dcision chama o OpenRouter ou o Vercel AI Gateway com a sua chaveUm modelo responde com o prompt da rota; o texto dele volta na resposta.
agentAgenteA Dcision chama o endpoint do seu agentesync: a resposta do agente volta na resposta. async: um repasse, entregue em segundo plano.
workflowWorkflowA Dcision, em segundo planoDispara n8n, Make, Zapier, Pipedream ou qualquer URL de workflow com as variáveis da rota.
webhookWebhookA Dcision, em segundo planoFaz POST do resultado assinado da decisão para a sua URL.
httpRequisição de APIA Dcision, em segundo planoChama qualquer API: método, URL, headers e um body JSON com variáveis e segredos.
functionFunçãoO seu códigoA 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 — sync para devolver a resposta dele agora, async para 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 sync sã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 async entram na fila e são entregues em segundo plano, com novas tentativas: a resposta devolve o delivery_id deles.
200 OK — Lead Qualification com 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 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

decision.json (trecho)
{
  "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}}\"}"
      }
    }
  ]
}
CampoTipoPadrãoDescrição
keystring—Única entre os destinos da decisão; snake_case, até 48 caracteres. Identifica a entrada nas respostas, nas entregas e na Visão geral.
descriptionstring—Opcional, até 2.000 caracteres.
enabledbooleantrueDestinos desligados nunca disparam.
whenobjecttoda decisãoconditions (AND) e actions — veja Gatilhos.
typestring—reply, json, llm, agent, workflow, webhook, http ou function.
paramsobject{}Até 30 variáveis — veja Params e templates.
reply, json, llm, agent, workflow, webhook, http, functionobject—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çãoQuem
Adicionar, editar e remover destinos (eles fazem parte da decisão), publicá-losMembros, Admins e o Proprietário
Reenviar uma entrega com falhaMembros, Admins e o Proprietário
Ver as entregas e o status delasTodos no workspace, Leitores incluídos
Ver os nomes dos segredos do workspaceMembros, Admins e o Proprietário
Adicionar, substituir ou excluir segredos; revelar ou trocar o segredo de assinaturaAdmins e o Proprietário

Veja Time, papéis e conta.

Próximos passos

Nesta página