函数

让你自己的代码根据结果行动——响应中指明函数及其参数,TypeScript 和 Python SDK 会按顺序、每次调用一次地调用你注册的处理函数。

函数目的地不会在 Dcision 这边运行任何东西。响应中指明一个函数以及调用它所用的参数,由你的代码——通常通过 SDK——调用对应的处理函数。当下一步发生在调用决策的那个进程中时使用它:分配负责人、写入你的数据库、调用内部服务。

配置

{
  "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 是一个有效的标识符:字母、数字、_ 和 $,最多 64 个字符,不能以数字开头。编辑器会打印出你需要注册的处理函数。

在响应中

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

函数条目在触发时没有 status。当缺少必需的 param 或达到上限时,该条目会变为 "status": "skipped"——此时不得调用它。

配合 SDK 使用

把你的处理函数传给 decide:SDK 会在决策之后调用它们,并传入 params 和决策本身。

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

SDK 的分派方式:

  • 处理函数按 destinations 的顺序逐个运行:异步处理函数会被 await,完成后下一个才开始。只有没有 status 的函数条目会被调用。
  • 先查找每一个处理函数。如果缺少某个,调用会以 FUNCTION_NOT_REGISTERED 失败且不会运行任何处理函数——或者传入 onMissingFunction: "ignore"(Python 中为 on_missing_function="ignore")来跳过它。
  • 抛出异常的处理函数会停止分派:调用以 FUNCTION_FAILED 失败,并以 cause 携带该错误,同时附带 decision 和已完成处理函数的结果。决策已经运行——并已计费。
  • Python 客户端是同步的:async def 处理函数会以 FUNCTION_FAILED 失败。

稍后分派

从存储的响应出发,在别处——worker、队列消费者——进行分派:

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

让处理函数幂等

SDK 在最终回答之后对每次 decide 调用分派一次——其内部重试绝不会分派两次。但用相同的 Idempotency-Key 再次调用 decide 会返回存储的回答,其函数会再次被分派。请以 decision.execution_id 或你自己的记录 ID 作为工作的键,使第二次调用无害。

不使用 SDK

自己遍历这些条目:

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

本页内容