Params e templates
Mapeie valores para um destino — params de um campo ou de um valor fixo, params obrigatórios, variáveis {{…}} em URLs, headers, bodies e textos, e como cada lugar os codifica por você.
Os destinos trabalham com duas ferramentas: params, os valores nomeados que um destino carrega, e templates, as variáveis {{…}} que você escreve nas URLs, nos headers, nos bodies e nos textos dele.
Params
{
"params": {
"message": { "from": "state.message", "required": true },
"route": { "from": "result.route" },
"lead_score": { "from": "composites.lead_score" },
"team": { "value": "inbound" }
}
}Um param recebe o seu valor de um campo da execução (from) ou é um valor fixo (value): uma string de até 500 caracteres, um número, true, false ou null. Um destino tem até 30 params, nomeados com letras, dígitos e _ — até 48 caracteres, sem começar com um dígito.
Origens
from | Valor |
|---|---|
state | O estado inteiro: um objeto, uma string ou um array. |
state.<field> | Um campo declarado num state schema de objeto. |
result.<question> | A resposta: uma opção, o rótulo de um nível ou uma probabilidade. |
confidence.<question> | A confiança da resposta, de 0 a 1. |
scores.<question> | O nível ponderado de uma pergunta de score. |
composites.<key> | O valor de um composite. |
action | A ação final: continue, block, escalate ou fallback. |
decision.slug | O slug da decisão. |
decision.version | A versão que respondeu — null no Playground, que roda o rascunho. |
execution.id | O ID exec_… da execução. |
Os valores mantêm o tipo JSON: confidence.route é um número, state um objeto. Um valor que não existe — um campo opcional que quem chamou não enviou, qualquer resposta depois de um fallback por erro de engine — é null.
Params obrigatórios
Marque um param como required quando o destino não faz sentido sem ele — um lead de CRM sem e-mail. Quando ele resolve para null ou uma string vazia, o destino não dispara e a resposta diz por quê:
{ "key": "create_lead", "type": "http", "status": "skipped", "reason": "missing_param", "param": "email" }Para onde vão os params
| Tipo | Os params são… |
|---|---|
webhook | enviados no evento, em data.params. |
workflow | enviados como campos JSON de primeiro nível — o que n8n, Make e Zapier mapeiam diretamente. |
http | o body JSON de requisições POST, PUT e PATCH sem template de body, e a query string de requisições GET e DELETE cuja URL não os usa. |
agent | enviados no body da requisição, em params. |
function | passados ao seu handler como primeiro argumento. |
reply, llm | usados só por meio de {{params.…}} nos textos deles. |
Use params para tudo o que chega a um terceiro: um webhook ou um workflow nunca recebe o estado em si, só os params que você mapeia — envie o que o receptor precisa e nada mais.
Templates
Escreva {{ e }} em volta de uma variável — espaços dentro são permitidos: {{ params.awb }}.
| Variável | Valor |
|---|---|
{{params.<name>}} | Um param deste destino. |
{{state}}, {{state.<field>}} | O estado, ou um campo declarado de um estado de objeto. |
{{result.<question>}}, {{confidence.<question>}}, {{scores.<question>}} | Uma resposta, a confiança dela, um nível ponderado. |
{{composites.<key>}} | O valor de um composite. |
{{action}}, {{decision.slug}}, {{decision.version}}, {{execution.id}} | A execução. |
{{delivery.id}} | O ID dlv_… desta entrega — o mesmo em toda tentativa. |
{{secrets.<NAME>}} | Um segredo do workspace. |
O menu Inserir… do editor, ao lado de cada campo, lista as variáveis que você pode usar ali.
A codificação é automática
Você nunca escapa nada à mão: a Dcision codifica cada valor para o lugar aonde ele vai.
| Onde | Como os valores são inseridos | Segredos |
|---|---|---|
URLs — webhook.url, http.url, agent.url, workflow.url | Codificados para URL. Um segredo é inserido como está, então pode conter uma URL inteira. | Permitidos |
Valores de header — http.headers, agent.headers | Como texto, com quebras de linha trocadas por espaços — um valor não consegue acrescentar um header. | Permitidos |
http.body | Como JSON — veja abaixo. | Permitidos |
Textos — reply.text, reply.buttons, llm.instructions, llm.input, agent.instructions | Como texto, mantendo as quebras de linha. | Não permitidos: o texto é devolvido a quem chamou ou enviado a um modelo. |
Como texto, strings são inseridas como estão, números e booleanos são impressos, objetos e arrays viram JSON e null vira uma string vazia.
Bodies JSON
Um template de body http é JSON com variáveis, e o lugar de uma variável decide como ela é escrita:
- Fora de aspas, ela vira um valor JSON — uma string com as aspas, um número,
true,null, um objeto. - Dentro de aspas, ela vira texto dentro dessa string, escapado conforme necessário.
Para uma decisão cujo estado de objeto tem os campos email e company_size, com um param email tirado de state.email:
{
"email": {{params.email}},
"company_size": {{state.company_size}},
"summary": "Route {{result.route}} at {{confidence.route}} — lead score {{composites.lead_score}}",
"lead": {{state}}
}{
"email": "ana@acme.com",
"company_size": 500,
"summary": "Route sales at 0.85 — lead score 0.8414",
"lead": { "message": "We need pricing for 500 users.", "email": "ana@acme.com", "company_size": 500 }
}Então escreva {{state.company_size}} — e não "{{state.company_size}}" — para enviar o número 500 em vez do texto "500". {{params.email}} também não precisa de aspas: o valor dele é uma string, então é escrito com as aspas.
O body precisa ser JSON válido depois que as variáveis são preenchidas: o editor o confere com valores de exemplo quando você salva, e um template inválido é recusado com "The body must be JSON once variables are filled in…". Um body tem até 10.000 caracteres. Deixe-o vazio em POST, PUT e PATCH para enviar os params como um objeto JSON; requisições GET e DELETE não têm body.
Checagens de template
Os templates são validados quando você salva ou publica:
- toda variável precisa existir:
{{params.awb}}precisa de um param chamadoawb,{{state.company_size}}de um campo de um estado de objeto,{{result.route}}de uma pergunta chamadaroute; - os nomes de segredos são UPPER_SNAKE_CASE, como
{{secrets.CRM_TOKEN}}; - todo
{{precisa do seu}}, com uma variável dentro; - segredos não podem ser usados em textos.
Um segredo ausente não é um erro de schema — os segredos mudam sem deploy —, mas uma entrega que referencia um segredo falha até ele ser definido. Veja Segredos do workspace.
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.
Respostas fixas
Devolva uma mensagem pronta — texto e botões opcionais, com variáveis — na resposta da API para um determinado resultado, na hora e sem chamar nenhum modelo.