Funções
Deixe o seu próprio código agir sobre um resultado — a resposta indica a função e seus params, e os SDKs TypeScript e Python chamam o handler que você registrou, em ordem e uma vez por chamada.
Um destino de função não executa nada do lado da Dcision. A resposta indica uma função e os params com que chamá-la, e o seu código — normalmente pelos SDKs — chama o handler correspondente. Use-o quando o próximo passo vive no processo que chamou a decisão: atribuir um responsável, gravar no seu banco de dados, chamar um serviço interno.
Configure-o
{
"key": "assign_owner",
"type": "function",
"when": { "conditions": [{ "field": "route", "on": "output", "operator": "eq", "value": "sales" }] },
"params": {
"email": { "from": "state.email", "required": true },
"route": { "from": "result.route" }
},
"function": { "name": "assignToSales" }
}function.name é um identificador válido: letras, dígitos, _ e $, até 64 caracteres, sem começar por dígito. O editor mostra o handler que você precisa registrar.
Na resposta
{ "key": "assign_owner", "type": "function", "function": "assignToSales", "params": { "email": "ana@acme.com", "route": "sales" } }Uma entrada de função não tem status quando disparou. Quando falta um param obrigatório ou o limite é atingido, a entrada fica com "status": "skipped" — e não deve ser chamada.
Com os SDKs
Passe os seus handlers para decide: o SDK os chama depois da decisão, com os params e a própria decisão.
import { Dcision } from "@dcision/sdk";
const dcision = new Dcision(); // reads DCISION_API_KEY
const decision = await dcision.decide("lead-qualification", { message, email, company_size: 500 }, {
idempotencyKey: `lead-${lead.id}`,
functions: {
assignToSales: async (params, decision) => crm.assign(String(params.email), decision.execution_id),
},
});
decision.functionResults; // [{ key: "assign_owner", function: "assignToSales", result: … }]Como os SDKs despacham:
- Os handlers rodam na ordem de
destinations, um de cada vez: um handler assíncrono é aguardado antes de o próximo começar. Só as entradas de função semstatussão chamadas. - Todos os handlers são procurados primeiro. Se algum estiver faltando, a chamada falha com
FUNCTION_NOT_REGISTEREDe nenhum handler roda — ou passeonMissingFunction: "ignore"(on_missing_function="ignore"em Python) para pulá-lo. - Um handler que lança erro interrompe o despacho: a chamada falha com
FUNCTION_FAILED, levando o erro comocause, adecisione os resultados dos handlers que terminaram. A decisão já rodou — e foi cobrada. - O cliente Python é síncrono: um handler
async deffalha comFUNCTION_FAILED.
Despachar depois
Despache em outro lugar — um worker, um consumidor de fila — a partir da resposta guardada:
import { Decision } from "@dcision/sdk";
const decision = await dcision.decide("lead-qualification", state); // no functions: nothing is called
await queue.push(JSON.stringify(decision));
// in the worker
const results = await new Decision(JSON.parse(job.payload)).dispatch(handlers, { onMissingFunction: "ignore" });Torne os handlers idempotentes
Os SDKs despacham uma vez por chamada a decide, depois da resposta final — as novas tentativas internas deles nunca despacham duas vezes. Mas chamar decide de novo com o mesmo Idempotency-Key devolve a resposta guardada, e as funções dela são despachadas de novo. Amarre o trabalho a decision.execution_id, ou ao ID do seu próprio registro, para que uma segunda chamada seja inofensiva.
Sem um SDK
Percorra as entradas você mesmo:
for (const destination of decision.destinations ?? []) {
if (destination.type !== "function" || destination.status) continue; // skipped entries carry a status
await handlers[destination.function](destination.params, decision);
}Requisições HTTP
Chame qualquer API depois de uma decisão — método, URL, headers e um body JSON montado com variáveis e secrets do workspace — entregue com retries, um Idempotency-Key e uma assinatura.
Segredos do workspace
Mantenha tokens e URLs secretas fora das decisões — segredos do workspace referenciados como {{secrets.NAME}}, quem pode gerenciá-los, como são guardados e mascarados, e quando as mudanças valem.