Tool calling в Bitrix CRM: whitelist, dry run, аудит и откат — как настроить безопасно
Tool calling (вызов инструментов) в Bitrix CRM позволяет агенту автоматически выполнять действия: создавать сделки, менять ответственных, отправлять письма…
Tool calling (вызов инструментов) в Bitrix CRM позволяет агенту автоматически выполнять действия: создавать сделки, менять ответственных, отправлять письма. Без ограничений это риск. Чтобы внедрить безопасно, нужны четыре элемента: whitelist (белый список) разрешённых инструментов, dry run (пробный запуск) для проверки сценариев, аудит действий и механизм отката. Ниже — как это устроить на практике.
Что такое tool calling в Bitrix CRM и зачем его ограничивать
Tool calling — это когда LLM-агент по запросу пользователя или по триггеру вызывает методы REST API Bitrix24 (crm.deal.add, crm.contact.update и т.д.). Без ограничений агент может удалить сделку, изменить воронку или отправить письмо не тому адресату. Ограничения нужны, чтобы:
- не потерять данные из-за ошибочного вызова;
- не нарушить права доступа сотрудников;
- соответствовать требованиям безопасности (особенно если агент работает с персональными данными);
- упростить отладку и разбор инцидентов.
Whitelist: какие инструменты разрешать
Whitelist — список методов API, которые агенту разрешено вызывать. Всё, что не в списке, блокируется на уровне шлюза (прокси между агентом и Bitrix).
Рекомендуемый минимальный набор для старта:
- Чтение: crm.deal.get, crm.deal.list, crm.contact.get, crm.contact.list, crm.company.get, crm.company.list.
- Создание: crm.deal.add, crm.contact.add, crm.lead.add.
- Обновление: crm.deal.update, crm.contact.update (только определённые поля).
- Коммуникации: messages.send (если используется), но с ограничением по шаблонам.
Запрещать по умолчанию:
- crm.deal.delete, crm.contact.delete, crm.company.delete;
- crm.deal.fields (может раскрыть структуру);
- user.add, user.update (управление пользователями);
- любые методы, меняющие настройки воронки или права доступа.
Whitelist лучше хранить в конфиге и версионировать. При изменении — обязательный код-ревью.
Dry run: как проверять сценарии без риска
Dry run — режим, при котором агент формирует вызов, но не отправляет его в Bitrix, а логирует. Это позволяет проверить:
- правильность выбора инструмента;
- корректность параметров (ID сделки, поля);
- соответствие бизнес-логике (например, не создаётся ли дубль).
Как организовать:
- Включите флаг DRY_RUN в конфиге шлюза.
- Все вызовы пишутся в отдельный лог с полными параметрами.
- Проведите тестовые диалоги с агентом (10–20 сценариев).
- Сверьте логи с ожидаемым поведением.
- Только после успешной проверки отключайте dry run для части методов.
Dry run можно совместить с тестовым порталом Bitrix (если есть возможность). Но даже на боевом портале dry run безопасен, так как не меняет данные.
Аудит: что и как логировать
Аудит — это журнал всех вызовов tool calling с возможностью разбора. Минимальный набор полей:
- дата и время;
- ID пользователя (или системы), инициировавшего вызов;
- название метода;
- параметры вызова;
- результат (успех/ошибка, код ответа);
- ID созданной/изменённой сущности (сделки, контакта).
Логи должны храниться не менее 30 дней (а лучше — 90). Доступ к ним — только у администратора и службы безопасности. На основе аудита можно строить отчёты: сколько вызовов в день, какие методы чаще всего, сколько ошибок.
Откат: как исправить ошибочное действие
Откат — это возможность вернуть данные в исходное состояние. В Bitrix CRM нет встроенной функции «отменить действие агента», поэтому откат проектируется заранее.
Способы:
- Перед изменением — снимок сущности. Агент перед вызовом crm.deal.update получает текущие значения полей и сохраняет их в отдельную таблицу. При откате — вызывает crm.deal.update с сохранёнными значениями.
- Мягкое удаление. Вместо crm.deal.delete используйте пометку «удалено агентом» в отдельном поле. Восстановление — снятие пометки.
- Транзакционные сценарии. Если агент выполняет цепочку вызовов, при ошибке на шаге N откатываются шаги N-1, N-2 и т.д. Для этого нужен менеджер транзакций (можно реализовать на стороне шлюза).
Важно: откат должен быть автоматическим или полуавтоматическим (по команде администратора). Ручной откат по логам занимает часы.
Чек-лист внедрения
- [ ] Определите список методов для whitelist, запретите опасные.
- [ ] Настройте шлюз между агентом и Bitrix (прокси с проверкой whitelist).
- [ ] Включите dry run и прогоните 10–20 тестовых сценариев.
- [ ] Настройте аудит-лог с хранением не менее 30 дней.
- [ ] Реализуйте механизм снимков перед изменением и мягкое удаление.
- [ ] Проведите тест отката на копии данных.
- [ ] Назначьте ответственного за просмотр логов и реакцию на инциденты.
- [ ] Проводите ревью whitelist раз в квартал.
Сроки и стоимость
Пилот одного сценария с tool calling, whitelist и dry run — от 60 до 350 тыс ₽ в зависимости от сложности. Прототип можно получить за 10–14 дней. Полный контур с аудитом и откатом — 30–90 дней. Сопровождение — 15–50 тыс ₽ в месяц. Если нужен агент поддержки (например, для ответов на вопросы по сделкам), базовый вариант — от 50 тыс ₽. Агент продаж — от 200 тыс ₽. Сложный контур с интеграцией нескольких систем — от 500 тыс ₽.
Если коротко
- Tool calling без ограничений опасен: агент может удалить или изменить данные.
- Whitelist — список разрешённых методов, всё остальное блокируется.
- Dry run — пробный запуск без изменения данных, обязателен перед боем.
- Аудит — логи всех вызовов, хранить не менее 30 дней.
- Откат — снимки перед изменением, мягкое удаление, транзакции.
- Внедрение: пилот 10–14 дней, полный контур 30–90 дней.
FAQ
Можно ли использовать tool calling без whitelist? Технически можно, но рискованно. Любая ошибка агента может привести к потере данных. Whitelist — минимальная мера безопасности.
Что делать, если агент вызвал запрещённый метод? Шлюз должен блокировать вызов и записывать инцидент в лог. Администратор получает уведомление. Вызов не доходит до Bitrix.
Как часто нужно обновлять whitelist? Рекомендуется раз в квартал или при изменении бизнес-процессов. Любое изменение — через код-ревью.
Сколько стоит внедрение tool calling с безопасностью? Пилот одного сценария — 60–350 тыс ₽. Полный контур с аудитом и откатом — от 500 тыс ₽. Точная цена зависит от количества методов и сложности интеграции.
Можно ли сделать откат вручную? Можно, но долго. Автоматический откат на основе снимков или мягкого удаления экономит время и снижает риск ошибки.
Нужен ли отдельный тестовый портал Bitrix? Желательно, но не обязательно. Dry run на боевом портале безопасен, если настроен правильно. Тестовый портал упрощает проверку сложных сценариев.
Читайте также
- Tool-calling AI-агента в Bitrix/CRM: whitelist, dry-run и откат
- Оркестрация tool calling и аудит AI-агента: этапы, цифры и сроки
- Оркестрация tool-calling AI-агента: SOP, лимиты и audit trail
Обсудить задачу
Расскажите, что нужно автоматизировать. Александр Раисович ответит лично и предложит архитектуру решения.