ИИ-аудитор CRM на LangGraph
b24-ai-auditor
Мультиагентный аудитор регламента CRM на LangGraph и DeepSeek: проверяет лиды и сделки Битрикс24, шлет нарушения в чаты руководителям
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Отправляет уведомления о нарушениях в рабочие чаты руководителей от имени системы
- Читает историю сделок, звонков и персональные данные сотрудников и клиентов из CRM
Установка
Ручная установка
git clone https://github.com/Usachev-Real-Estate/AI_agents_Bitrix24.git b24-ai-auditor && cd b24-ai-auditor && python -m venv venv && pip install -r requirements-dev.txtПосле установки заполните .env вебхуком Битрикс24 и ключом DeepSeek и проверьте подключение python scripts/test_b24.py.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект собирает граф LangGraph из детерминированных Python-аналитиков и коллекторов, которые по расписанию (дважды в день по будням) читают лиды, сделки покупателей и продавцов и общую базу Битрикс24 через fast_bitrix24, проверяют соблюдение регламента (пропущенные звонки, просроченные шаги воронки, качество квалификации лидов) и рассылают нарушения в чаты руководителей отделов, а сводку в общий чат. LLM (DeepSeek) используется только в одном узле контроля качества лидов, остальные проверки детерминированные. Отдельный модуль строит витрину данных (ETL из истории стадий сделок в SQLite) и веб-дашборд на FastAPI с разграничением доступа по ролям и отдельной интеграцией с внешней CRM недвижимости для карточек объектов. Режим DRY_RUN позволяет прогнать аудит только на чтение, без отправки сообщений.
Для кого. Для руководителей отделов продаж недвижимости на Битрикс24, которым нужен автоматический контроль регламента вместо ручной проверки сделок.
Подходит, если
- Нужен автоматический контроль пропущенных звонков и просроченных шагов воронки по расписанию
- Есть отдельная CRM объектов недвижимости, которую нужно свести с Битрикс24 в одном дашборде
- Нужна история движения сделок по стадиям, а не только текущий срез
Не подходит, если
- Ваш бизнес не про недвижимость и не про воронки покупателей и продавцов: проект глубоко заточен под эту структуру
- Нет готовности адаптировать хардкод (ID чатов, ID воронок, карту отделов) под свою организацию
- Нужен готовый продукт «из коробки», а не референсная реализация под конкретную компанию
Пример запроса к агенту
Прогони аудит сделок покупателей в режиме dry-run и покажи, какие нарушения регламента нашлисьОграничения
Проект написан под конкретную компанию: ID чатов руководителей, карта отделов и ID воронок захардкожены в коде и требуют полной переработки под другую организацию. Опирается на внешний сервис DeepSeek API и отдельную стороннюю CRM недвижимости со своим ключом, доступной по своему контракту. Дашборд и ETL хранят данные в локальном SQLite, для прод-окружения нужен отдельный чек-лист деплоя с nginx и TLS.
Как отключить. Остановите cron-задачу аудита и процесс веб-дашборда, отзовите вебхук Битрикс24 и ключ DeepSeek API.
Проверка безопасности
- Отправляет уведомления о нарушениях в рабочие чаты руководителей от имени системы
- Читает историю сделок, звонков и персональные данные сотрудников и клиентов из CRM
Коротко о README
README описывает архитектуру LangGraph v2 диаграммой из коллекторов, аналитиков и диспетчера отчетов, стек (Python, LangGraph, DeepSeek API, fast_bitrix24, Docker, cron), подробно расписывает веб-дашборд по воронкам с отдельной витриной SQLite и ETL, интеграцию с внешней CRM недвижимости для карточек объектов с разбором прав доступа и нюансов подсчета метрик, быстрый старт, деплой через Docker и cron, полный список переменных окружения и структуру проекта.
Частые вопросы
ИИ сам меняет данные в CRM?
Нет, LLM используется только в контроле качества квалификации лидов, остальные аналитики детерминированные, а режим DRY_RUN дает только чтение без отправки уведомлений.
Можно ли использовать без второй CRM недвижимости?
Да, раздел «Объекты» дашборда подключается отдельным ключом AFINA_API_KEY, без него страница и пункт меню просто не появляются.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма