Блог студии Раисыча AI-агенты · автоматизация
Обсудить задачу
ИИ-агенты для продаж 5 мин чтения 1 January 2026

Tool calling в Bitrix CRM: whitelist, dry run, аудит и откат — как настроить безопасно

Tool calling (вызов инструментов) в Bitrix CRM позволяет агенту автоматически выполнять действия: создавать сделки, менять ответственных, отправлять письма…

Обсудить задачу Все статьи кластера
Tool calling в Bitrix CRM: whitelist, dry run, аудит и откат — как настроить безопасно

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 сделки, поля);
  • соответствие бизнес-логике (например, не создаётся ли дубль).

Как организовать:

  1. Включите флаг DRY_RUN в конфиге шлюза.
  2. Все вызовы пишутся в отдельный лог с полными параметрами.
  3. Проведите тестовые диалоги с агентом (10–20 сценариев).
  4. Сверьте логи с ожидаемым поведением.
  5. Только после успешной проверки отключайте 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 на боевом портале безопасен, если настроен правильно. Тестовый портал упрощает проверку сложных сценариев.

Читайте также

Заявка

Обсудить задачу

Расскажите, что нужно автоматизировать. Александр Раисович ответит лично и предложит архитектуру решения.

Раисыч

Основатель Студии Раисыча. Проектирую ИИ-контуры для продаж, поддержки и документов — с критериями приёмки и журналом.

Написать в Telegram →
Обсудить задачу