函数
让你自己的代码根据结果行动——响应中指明函数及其参数,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);
}