Справочник

Внешний расчётный модуль (ВРМ)

Если стандартных блоков не хватает, подключите внешний расчётный модуль (ВРМ) — небольшую программу, которой блок-условие отдаёт событие, а она возвращает, в какой выход идти дальше. ВРМ удобен для нетиповой логики, поиска или сравнения: одним блоком можно заменить сразу несколько.

Как это работает

Блок «Внешний расчётный модуль» передаёт модулю данные текущего прохода — событие, пользователя и настройки блока, — а модуль отвечает номером выхода. Модуль бывает локальным (размещается на сервере владельцем) или внешним (по адресу https). В настройках блока выбирается источник и нажимается «Подключить»: после этого подтягиваются настраиваемые поля модуля и его выходы.

Выходы

У блока есть красный выход «Ошибка» — в него проход уходит при сбое, превышении времени ожидания или если модуль не подключён. Остальные выходы — именованные, их объявляет сам модуль (например, «Найдено» / «Не найдено»). То, что модуль вернул, доступно дальше по проходу как данные блока ({b.<номер>.value} — см. «Данные прохода»).

Для разработчиков и агентов

Свой ВРМ можно написать по простому контракту и подключить. ИИ-агент умеет собрать и подключить ВРМ самостоятельно — об этом в разделе «Доступ для агентов».

Долгие расчёты (ответ позже)

Если расчёт занимает много времени (десятки секунд, минуты или дольше), внешний ВРМ может ответить не сразу, а позже. В каждом запросе модулю приходит одноразовый ключ и адрес обратного вызова; модуль сразу говорит «отвечу позже» — проход приостанавливается, и бот мгновенно продолжает обслуживать других. Когда расчёт готов, модуль сам присылает результат, и проход продолжается с нужного выхода.

На ожидание задаётся дедлайн (поле блока «Дедлайн отложенного ответа», по умолчанию 5 минут, максимум 24 часа): если модуль не пришлёт ответ за это время, проход уходит в красный выход «Ошибка» — зависших проходов не бывает. Возможность доступна только для внешних ВРМ (локальный модуль, размещённый на сервере, перезвонить не может). Как это написать на стороне модуля — в разделе «Доступ для агентов» и в контракте ВРМ (describe_capabilities → available.vrm.deferred).