Функции
Пусть по результату действует ваш собственный код — ответ называет функцию и её параметры, а SDK для TypeScript и Python вызывают зарегистрированный вами обработчик, по порядку и один раз за вызов.
Назначение функция ничего не выполняет на стороне 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. Если обязательный параметр отсутствует или достигнут лимит, запись вместо этого получает "status": "skipped" — и её вызывать нельзя.
С SDK
Передайте свои обработчики в decide: SDK вызывает их после решения, с параметрами и самим решением.
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, по одному: асинхронный обработчик дожидается завершения, прежде чем начнётся следующий. Вызываются только записи функций безstatus. - Сначала ищется каждый обработчик. Если какого-то нет, вызов завершается ошибкой
FUNCTION_NOT_REGISTERED, и ни один обработчик не выполняется, — или передайтеonMissingFunction: "ignore"(on_missing_function="ignore"в Python), чтобы пропустить его. - Обработчик, выбросивший исключение, останавливает вызовы: вызов завершается ошибкой
FUNCTION_FAILEDс ошибкой вcause,decisionи результатами завершившихся обработчиков. Решение уже выполнено — и тарифицировано. - Клиент Python синхронный: обработчик
async defзавершается ошибкойFUNCTION_FAILED.
Вызов позже
Вызывайте обработчики в другом месте — в воркере, в потребителе очереди — по сохранённому ответу:
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, после итогового ответа, — их внутренние повторы никогда не вызывают их дважды. Но повторный вызов decide с тем же Idempotency-Key возвращает сохранённый ответ, и его функции вызываются снова. Привязывайте работу к 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);
}HTTP-запросы
Вызывайте любой API после решения — метод, URL, заголовки и тело JSON из переменных и секретов рабочего пространства — с повторными попытками, Idempotency-Key и подписью.
Секреты рабочего пространства
Держите токены и секретные URL вне решений — секреты рабочего пространства через {{secrets.NAME}}, кто может ими управлять, как они хранятся и маскируются и когда применяются изменения.