Функции

Пусть по результату действует ваш собственный код — ответ называет функцию и её параметры, а 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);
}

На этой странице