Funciones

Deja que tu propio código actúe sobre un resultado — la respuesta nombra la función y sus params, y los SDKs de TypeScript y Python llaman al handler que registraste, en orden y una vez por llamada.

Un destino de función no ejecuta nada del lado de Dcision. La respuesta nombra una función y los params con los que llamarla, y tu código —normalmente a través de los SDKs— llama al handler correspondiente. Úsalo cuando el siguiente paso vive en el proceso que llamó a la decisión: asignar un responsable, escribir en tu base de datos, llamar a un servicio interno.

Configúralo

{
  "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 es un identificador válido: letras, dígitos, _ y $, hasta 64 caracteres, sin empezar por un dígito. El editor muestra el handler que necesitas registrar.

En la respuesta

{ "key": "assign_owner", "type": "function", "function": "assignToSales", "params": { "email": "ana@acme.com", "route": "sales" } }

Una entrada de función no tiene status cuando se disparó. Cuando falta un param obligatorio o se alcanza el límite, la entrada tiene "status": "skipped" en su lugar, y no debe llamarse.

Con los SDKs

Pasa tus handlers a decide: el SDK los llama después de la decisión, con los params y la decisión en sí.

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: … }]

Cómo despachan los SDKs:

  • Los handlers se ejecutan en el orden de destinations, uno a la vez: un handler async se espera antes de que empiece el siguiente. Solo se llaman las entradas de función sin status.
  • Primero se busca cada handler. Si falta uno, la llamada falla con FUNCTION_NOT_REGISTERED y no se ejecuta ningún handler; o pasa onMissingFunction: "ignore" (on_missing_function="ignore" en Python) para omitirlo.
  • Un handler que lanza una excepción detiene el despacho: la llamada falla con FUNCTION_FAILED, con el error como cause, la decision y los resultados de los handlers que terminaron. La decisión ya se ejecutó, y se facturó.
  • El cliente de Python es síncrono: un handler async def falla con FUNCTION_FAILED.

Despachar más tarde

Despacha en otro lugar —un worker, un consumidor de cola— a partir de la respuesta 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" });

Haz que los handlers sean idempotentes

Los SDKs despachan una vez por llamada a decide, después de la respuesta final: sus reintentos internos nunca despachan dos veces. Pero llamar de nuevo a decide con la misma Idempotency-Key devuelve la respuesta guardada, y sus funciones se despachan otra vez. Asocia el trabajo a decision.execution_id, o al ID de tu propio registro, para que una segunda llamada sea inofensiva.

Sin un SDK

Recorre las entradas tú mismo:

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);
}

En esta página