Synapsea BP Agent — правка бизнес-процессов через AI-агента

Что умеет решение

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

В рабочем процессе специалист обращается к Claude Code с описанием задачи обычным текстом, например: «В процессе согласования договоров иногда не назначается согласующий, заявка зависает. Разберитесь, в чём причина».

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

Решение состоит из двух частей. Модуль представляет серверную часть: он обеспечивает HTTP-интерфейс для работы с шаблонами, управляет ключами доступа, версиями и ведёт журнал событий. Скилл для Claude Code является клиентской частью. Это модель формата шаблонов и набор инструментов, распространяемый бесплатно с открытым исходным кодом на GitHub: ShyDamn/bitrix-bizproc-skill.

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

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

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

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

Возможности модуля:

- Возвращает шаблон в формате JSON полностью или отдельной ветвью по указанному пути.

- Ищет действия по типу, заголовку или содержимому свойств.

Модуль Synapsea BP Agent проверяет структуру бизнес-процессов в Битрикс24, выявляя битые ссылки на действия, необъявленные константы и переменные, дубликаты имен, а также переменные, в которые пишут данные, но которые никто не читает. Изменения записываются через штатный загрузчик Битрикс24. Перед каждой записью сохраняется снимок состояния, что позволяет откатить изменения. Инструмент запускает процесс на конкретной сущности и показывает его текущее положение. Также реализовано сопоставление исполнителей с идентификаторами вида user_271 с реальными сотрудниками.

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

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

Запись защищена многослойной системой безопасности. Обязательная проверка версии предотвращает случайное перезаписывание изменений, внесённых человеком через визуальный редактор. Процесс преобразования проходит самопроверку: сгенерированный шаблон разворачивается обратно и сравнивается с исходным; при любом расхождении запись отклоняется. Структурные ошибки блокируют сохранение; их можно обойти только явным указанием, при этом факт обхода и список проигнорированных элементов фиксируются в журнале. Каждое обращение логируется с указанием ключа, шаблона, характера изменений и факта воздействия на исполняемый код. Функционал проверен на реальных боевых данных. Преобразование успешно протестировано на 2584 шаблонах рабочего портала: полный цикл чтения и сборки не привёл к потере данных ни в одном случае, включая шаблон с 1106 узлами. Проверку можно запустить локально одной командой: она пройдёт по всем шаблонам портала без внесения изменений и выведет результат. Требования: Битрикс24 в коробочной версии с модулем бизнес-процессов, PHP 8.2 или новее, СУБД MySQL или PostgreSQL, библиотека zlib. Для работы клиентской части требуется Claude Code.

Для «Synapsea BP Agent — правка бизнес-процессов через AI-агента» команда General iT может выполнить подключение, настройку и контрольную проверку после установки.