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 sem status são chamadas.
  • Todos os handlers são procurados primeiro. Se algum estiver faltando, a chamada falha com FUNCTION_NOT_REGISTERED e nenhum handler roda — ou passe onMissingFunction: "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 como cause, a decision e os resultados dos handlers que terminaram. A decisão já rodou — e foi cobrada.
  • O cliente Python é síncrono: um handler async def falha com FUNCTION_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);
}

Nesta página