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

fromValor
stateO 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.
actionA ação final: continue, block, escalate ou fallback.
decision.slugO slug da decisão.
decision.versionA versão que respondeu — null no Playground, que roda o rascunho.
execution.idO 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

TipoOs params são…
webhookenviados no evento, em data.params.
workflowenviados como campos JSON de primeiro nível — o que n8n, Make e Zapier mapeiam diretamente.
httpo 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.
agentenviados no body da requisição, em params.
functionpassados ao seu handler como primeiro argumento.
reply, llmusados 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ávelValor
{{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.

OndeComo os valores são inseridosSegredos
URLs — webhook.url, http.url, agent.url, workflow.urlCodificados para URL. Um segredo é inserido como está, então pode conter uma URL inteira.Permitidos
Valores de header — http.headers, agent.headersComo texto, com quebras de linha trocadas por espaços — um valor não consegue acrescentar um header.Permitidos
http.bodyComo JSON — veja abaixo.Permitidos
Textos — reply.text, reply.buttons, llm.instructions, llm.input, agent.instructionsComo 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:

Template do body
{
  "email": {{params.email}},
  "company_size": {{state.company_size}},
  "summary": "Route {{result.route}} at {{confidence.route}} — lead score {{composites.lead_score}}",
  "lead": {{state}}
}
Body enviado
{
  "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 chamado awb, {{state.company_size}} de um campo de um estado de objeto, {{result.route}} de uma pergunta chamada route;
  • 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.

Nesta página