Synapsea BP Agent: доступ AI-агента к шаблонам бизнес-процессов

Модуль подключает к порталу AI-агента, который умеет разбираться в бизнес-процессах и править их. Не подсказывать, где нажать, а находить причину и вносить изменение.

Как это выглядит в работе

Специалист пишет в Claude Code обычным текстом:

«В процессе согласования договоров согласующий иногда не назначается, заявка просто повисает. Посмотри, в чём дело.»

Агент открывает шаблон через модуль, проходит по дереву, находит причину и объясняет её: ссылка на действие, которое кто-то удалил два года назад, поэтому исполнитель подставляется пустым. Показывает точное место в дереве, предлагает исправление и — с вашего подтверждения — записывает его обратно на портал. Перед записью сохраняется снимок, к которому можно вернуться одной командой.

Из чего состоит решение

Модуль — серверная половина: HTTP-интерфейс к шаблонам, ключи доступа, версии, журнал.

Скилл для Claude Code — клиентская половина. Это модель формата шаблонов и набор инструментов, распространяется бесплатно с открытым исходным кодом: https://github.com/ShyDamn/bitrix-bizproc-skill

Без модуля скилл работает только с файлами, выгруженными вручную. Вместе они дают агенту прямой доступ к порталу.

Зачем это нужно

Визуальный редактор хранит бизнес-процесс как дерево, сжатое zlib поверх serialize(). Процессы согласования в живых компаниях доходят до тысячи узлов. Найти в таком одну ветку через интерфейс — это десятки раскрытых блоков, и держать всю картину в голове не получается ни у кого.

Хуже другое: Битрикс не проверяет ссылки внутри шаблона. Ссылка на удалённое действие или на константу, которую забыли объявить, молча подставляет пустую строку. Процесс идёт дальше, письмо уходит с пропуском, согласующий не назначается — и в журнале при этом чисто. Такие дефекты живут в рабочих процессах годами и всплывают в самый неподходящий момент.

Отдельно про выключенные блоки. Штатная проверка Битрикса пропускает ветки с отключённым действием целиком, поэтому ошибки в них не показываются вообще. Ветку включают через год — и она не работает. Модуль такие места находит и помечает отдельно, не смешивая с текущими ошибками.

Что умеет модуль

• отдаёт шаблон в виде JSON — целиком или отдельной ветвью по пути
• ищет действия по типу, заголовку или содержимому свойств
• проверяет структуру: битые ссылки на действия, необъявленные константы и переменные, дубли имён, переменные, в которые пишут и которые никто не читает
• записывает изменения через штатный загрузчик Битрикса
• хранит снимок перед каждой записью, позволяет откатиться
• запускает процесс на конкретной сущности и показывает, где он стоит
• сопоставляет исполнителей вида user_271 с живыми сотрудниками

Кому подойдёт

Интеграторам и внутренним командам, которые ведут коробочный Битрикс24 с десятками процессов согласования. Особенно там, где процессы писали разные люди в разные годы и разбираться в них приходится по жалобам пользователей.

Безопасность

Ключи выдаются с раздельными правами: чтение, запись, создание, запуск, справочник сотрудников. Изменение блоков «Выполнить код» — отдельное право, по умолчанию отключённое, потому что это возможность загрузить на сервер произвольный PHP.

Область действия ключа ограничивается типами документов или конкретными ID шаблонов. Ключ, выданный на три шаблона одной воронки, к остальным процессам портала доступа не имеет — на запрос к чужому шаблону он получит тот же ответ, что и на запрос к несуществующему.

Запись защищена в несколько слоёв. Обязательная проверка версии не даёт затереть правку, сделанную человеком в визуальном редакторе за это время. Преобразование проверяет само себя: собранный шаблон разворачивается обратно и сравнивается с исходным, и запись отклоняется при любом расхождении. Структурные ошибки блокируют запись; обойти их можно только явным указанием, и факт обхода попадает в журнал вместе со списком проигнорированного.

Каждое обращение записывается: какой ключ, какой шаблон, что менялось, затрагивался ли исполняемый код.

Проверено на боевых данных

Преобразование проверено на 2584 шаблонах рабочего портала — полный цикл чтения и сборки не теряет данных ни на одном, включая шаблон на 1106 узлов. Проверку можно запустить у себя одной командой: она пройдёт по всем шаблонам портала, ничего не изменяя, и покажет результат.

Требования

Битрикс24 в коробке с модулем бизнес-процессов, PHP 8.2 и новее, MySQL или PostgreSQL, zlib. Для клиентской части — Claude Code.