Документация ПрофиCRM: AI-контроль качества звонков. Диагностика и журнал событий
Диагностика и журнал событий
Когда смотреть диагностику
Диагностика нужна, когда карточки не создаются, AI не запускается, очередь зависла или результаты не сохраняются. Решение ведет журнал событий, который помогает понять, на каком этапе возникла проблема.
Что проверять первым
- Настройки отбора звонков: сотрудник, тип, длительность.
- Наличие записи звонка.
- Состояние фоновых агентов.
- Очередь AI и статусы задач.
- Ошибки в журнале событий.
- Лимиты AI-провайдера и паузу после лимита.
Типовые причины ошибок
- звонок короче минимальной длительности;
- запись звонка недоступна;
- у карточки не выбрана тема или чек-лист;
- AI-запрос остановлен из-за лимита;
- робот запущен на неподходящей стадии;
- агенты решения отключены.
Как разбирать проблему
Не начинайте с переустановки решения. Откройте конкретную карточку контроля, найдите ее события в журнале и проверьте, какой шаг был последним успешным: создание карточки, расшифровка, отправка в AI, получение результата или сохранение оценки.
Журнал событий и диагностика AI
В административных настройках решения есть вкладка Журнал событий. На ней администратор включает запись событий в стандартный журнал Битрикс и выбирает уровни, которые нужно сохранять: ERROR, WARNING, INFO и DEBUG.
Журнал событий и состояние очереди отправки в AI.
Какие уровни включать
| Уровень | Когда использовать |
| ERROR | Оставляйте включенным в рабочем режиме. Помогает увидеть ошибки установки, обновления, создания полей, обработки AI и очереди. |
| WARNING | Полезен, когда нужно отследить предупреждения и пограничные ситуации без полного отладочного шума. |
| INFO | Подходит для расширенной диагностики работы агентов и сценариев, когда нужно понять последовательность обработки. |
| DEBUG | Включайте только временно на время диагностики. В этом режиме могут сохраняться полные ответы AI-моделей. |
Важные события AI
| Событие | Что записывается |
| AI_AUDIO_ANSWER | Ответ AI-модели при расшифровке звонка. |
| AI_QUALITY_ANSWER | Ответ AI-модели при оценке звонка по чек-листу. |
| AI_ROBOT_CALLBACK | Результат AI-роботов, включая данные, которые возвращаются в бизнес-процесс. |
Для обычной эксплуатации достаточно вывода ошибок и предупреждений. DEBUG удобен при разборе сложного кейса с AI, но его лучше выключать после диагностики, потому что в журнал могут попадать расшифровки, ответы модели и данные, связанные с бизнес-процессом.
Диагностика очереди
На этой же вкладке отображается состояние очереди AI: пауза из-за лимита, количество отправок за последний час, статусы WAIT, PROCESSING, SENT, DONE, ERROR и CANCELLED, а также последняя ошибка лимита. Это быстрый экран для администратора, когда нужно понять, почему AI-обработка временно не идет или почему часть карточек ожидает обработки.
Служебные поля AI-ошибок в карточке
Кроме общего журнала, решение хранит диагностику AI прямо в карточке контроля качества. Для этого создаются служебные поля AI количество ошибок (служебное) и AI журнал ошибок (служебное).
Служебные поля AI-ошибок в карточке контроля качества.
| Поле | Для чего нужно |
| AI количество ошибок | Показывает, сколько раз AI-обработка карточки завершалась ошибкой. По умолчанию после 5 ошибок карточка не отправляется в AI. |
| AI журнал ошибок | Хранит историю ошибок с датой, временем и коротким текстом причины. По нему удобно понять, повторяется ли одна и та же проблема: лимит AI, временный сбой запроса, недоступная запись или ошибка обработки. |
Эти поля заполняются автоматически. Они нужны администратору, контролеру и автоматизации: если одна карточка несколько раз не обработалась, ее можно быстро найти, открыть журнал ошибок и понять, стоит ли повторить обработку, проверить запись звонка, лимиты AI или настройки роботов.
