Центр активности

Центр активности — группа журналов раздела администрирования, в которой платформа хранит историю обращений к языковым моделям (LLM), прогонов агента, транскрибаций аудио и отзывов пользователей на ответы. Журналы открываются из левого меню раздела Администрирование и доступны пользователям с глобальной ролью admin. По записи журнала вы восстанавливаете, что платформа отправила провайдеру, сколько времени это заняло и на каком шаге прогон оборвался. Журналы показывают факты прошедших запусков и ничего не настраивают: чтобы изменить поведение, откройте профильный раздел — политики, модели или настройки агента.

Что вам понадобится

• глобальная роль admin: страницы центра активности закрыты для остальных пользователей;
• время обращения, о котором идёт речь, и название рабочего пространства;
• название ассистента или адрес почты пользователя, если жалоба пришла от конкретного человека.

Как открыть журналы центра активности

Нажмите на свой аватар внизу левого меню, выберите Администрирование и в сайдбаре раздела найдите группу Центр активности. Группа содержит пять журналов, каждый из которых открывается отдельной страницей.

Карточка отдельного запуска имеет собственный адрес: /settings/administration/llm-executions/<id-запуска> для журнала LLM, /settings/administration/asr-executions/<id-запуска> для журнала ASR и /settings/administration/activity/ingest-journal/<id-документа> для журнала обработки документов. Такую ссылку можно передать коллеге, и он откроет ту же карточку без поиска по фильтрам.

Примечание. Пункты Журнал действий и Логи уведомлений зарезервированы под будущие журналы и в меню скрыты.

Как найти причину проблемы по журналу

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

Журналы «Запуски LLM», «Запуски ASR» и «Обработка документов» открываются за текущий день. Если обращение было раньше, сначала измените период, иначе таблица окажется пустой при работающем поиске. Для произвольного периода в календаре выберите сначала дату начала, затем дату конца. Выбор одного дня — два нажатия на эту дату; готовые периоды под календарём применяются одним нажатием.

Как разобрать запуск LLM

Страница «Журнал запусков LLM» содержит по одной записи на каждое обращение к языковой модели: ответ в чате, запуск действия, шаг сценария. Строка показывает время, рабочее пространство, пользователя, модель, начало сообщения пользователя, длительность, статус и наличие отзыва. Бейдж RAG в колонке Сообщение означает, что запрос использовал поиск по базе знаний, бейдж LLM — прямое обращение к модели.

1. Откройте Администрирование → Центр активности → Запуски LLM.
2. В фильтре Период выберите день обращения или пресет «Последние 7 дней».
3. Выберите рабочее пространство в фильтре Воркспейс, затем — если нужно — ассистента.
4. Включите переключатель Только с ошибками, чтобы оставить проблемные запуски.
5. Нажмите на строку — откроется панель «Детали запуска».

Список ассистентов в фильтре наполняется после выбора рабочего пространства: без выбранного пространства фильтр Ассистент остаётся пустым.

Панель «Детали запуска» собирает разбор сверху вниз: сначала время, длительность, Chat ID, рабочее пространство, пользователь, ассистент и модель. Ниже идут блок «Отзывы» со связанными оценками, блок «Связанный RAG run» с полями Статус, Источник, Ошибка и Stage, блок «Полный лог запуска» и хронология шагов.

Шаги со статусом Ошибка раскрываются автоматически: у каждого видны входные и выходные данные, код и сообщение ошибки. Кнопка «Скопировать полный лог» кладёт весь разбор в буфер обмена одним текстом.

Зависший в статусе Выполняется запуск снимите кнопкой Снять в строке таблицы или кнопкой «Снять задачу» в заголовке панели. Кнопка доступна, только когда у запуска есть связанный прогон, который платформа умеет прервать; иначе в строке Отмена карточки написана причина отказа.

Переключатель Отладка в шапке страницы добавляет в шаги полный текст промптов. Тексты платформенных директив в лог не попадают: вместо них платформа пишет идентификаторы вида [platform:<id>].

Важно. Переключатель Отладка живёт в памяти сервера: после перезапуска платформа возвращает значение переменной окружения LLM_LOG_DEBUG_PROMPTS.

Как разобрать запуск агента

Страница «Запуски агента» показывает прогоны агента — универсального рантайма, который сам выбирает инструменты и делает несколько раундов обращений к модели. Таблица содержит время, пространство, ассистента, модель, статус, счётчики и длительность. Колонка Счётчики читается как «раунды модели / вызовы инструментов / попытки провайдера»: 4/7/1 означает четыре раунда, семь вызовов инструментов и одну попытку без переключения на запасного провайдера.

Список сужают фильтр Статус и переключатель Только с честным отказом. Переключатель по умолчанию выключен; при активном фильтре появляется Сбросить фильтры. Фильтров по периоду и пространству нет, поэтому ищите прогон по времени в первой колонке. Причины отказа разобраны ниже, в разделе Почему прогон агента остановился.

Нажмите на строку — платформа откроет карточку прогона. Разбирайте неудачный прогон в таком порядке:

1. Проверьте строку Ошибка — она содержит код и сообщение, с которых начинается разбор.
2. Сверьте Счётчики: в карточке они перечислены как «попыток N, раундов ≈N, инструментов N, payload N». Это другой порядок, чем у сокращённой колонки таблицы.
3. Если в карточке есть секция Инструменты: выдано N, вызвано M, откройте её. Вызванные инструменты отмечены заливкой, остальные выданные — контуром.
4. Разверните Хронология событий и найдите первое событие со статусом Ошибка: заголовок называет фазу, источник и номер раунда.
5. Нажмите Показать payload, чтобы увидеть запрос или ответ инструмента. Кнопка доступна, только если у события сохранены данные.
6. Сравните Финальный ответ (превью) с ответом в чате.

Секция Инструменты показывается, если для запуска записан состав выданных инструментов. Если сохранились вызовы без состава выданных, показано Снимок инструментов не записан для этого запуска. Если секции нет, разбирайте запуск по ошибке и хронологии событий.

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

Почему прогон агента остановился

Начните с бейджа причины рядом со статусом и строки Остановка в карточке. Они появляются, если записана причина остановки или честный отказ, в том числе у прогона со статусом Успех. Если причины остановки и отказа различаются, строка дополнительно показывает причину честного отказа.

Честный отказ означает, что агент сообщил о нехватке данных вместо выдуманного ответа. Переключатель Только с честным отказом отбирает такие прогоны.

Неизвестная причина отображается исходным кодом. Если причина не записана, но был честный отказ, бейдж показывает честный отказ. Нажатие Остановить в чате даёт статус Отменён и само по себе не гарантирует бейдж: причина появляется, только если её успел записать рантайм.

Как разобрать транскрибацию в журнале ASR

Страница «Запуски ASR» содержит историю распознавания речи: голосовые сообщения в чате, загруженные аудиофайлы, запуски действий транскрибации. Любую колонку таблицы можно отсортировать нажатием на заголовок — это удобно, чтобы вывести наверх самые длинные записи или самые медленные обработки.

Панель содержит Период, Воркспейс, Статус, ASR-сервис и Диаризация. По умолчанию выбраны Все ASR-сервисы. Фильтр Ассистент появляется после выбора пространства. Фильтров Пользователь, Тип и переключателя Только с ошибками нет: проблемные транскрибации отбирайте по статусу Ошибка.

Карточка запуска открывается нажатием на строку и разбита на три части.

Lifecycle — служебный статус жизненного цикла записи транскрибации.

Ниже идут блок «Полный лог запуска» с кнопкой «Скопировать полный лог» и хронология этапов обработки.

Если сервис распознавания взял запись в работу и не вернул результат вдвое дольше её длины, но не раньше чем через 20 минут (длина неизвестна — через час), платформа снимает задачу и один раз запускает её заново. Так работают и чаты, и загрузка аудио в базы знаний; кредиты списываются только за успешную расшифровку. В хронологии запуска это видно двумя событиями: Зависшая задача снята — с номером задачи, причиной, порогом и длиной записи — и Задача запущена заново — с прежним и новым номером задачи. Если зависла и новая задача, после второго события Зависшая задача снята запуск завершается ошибкой ASR_TASK_STALLED, а пользователь видит сообщение с предложением повторить.

Начинайте разбор с полей Этап ошибки и HTTP ошибки: первое называет стадию, на которой всё сломалось, второе отличает отказ провайдера от проблемы с самим файлом. Поле Списано кредитов показывает стоимость запуска — по нему сверьте строку в журнале списаний.

Как работать с отзывами и оценками

Страница «Отзывы и оценки» собирает два потока обратной связи: оценки конкретных ответов ассистента, которые пользователи ставят прямо в чате, и общие отзывы о продукте из меню «Обратная связь» внизу боковой панели. Над таблицей платформа считает аналитику по текущим фильтрам. Общие отзывы доступны всегда. Видимость ссылки на чат сообщества администратор настраивает в Платформа → Настройка меню.

Каждая плитка аналитики работает как фильтр. Список сужает нажатие на день в блоке «Активность», на сектор диаграммы «Всего отзывов», на счётчик лайков или на строку в блоках «Проблемные ассистенты», «Проблемные пространства» и «Активные пользователи».

Список открывается за последние семь дней. Нажатие на строку открывает панель «Детали отзыва» с полным комментарием, собственной формулировкой причины для варианта Другое, сообщением пользователя, ответом ассистента и приложенными скриншотами — миниатюра раскрывается в полноразмерный просмотр.

Блок «Связанный LLM run» и кнопка «Открыть запуск» переводят на карточку запуска, который породил спорный ответ. Обратный переход тоже работает: в карточке запуска LLM блок «Отзывы» и кнопка «Открыть список» возвращают к отфильтрованному по этому запуску списку отзывов.

Кнопка «Экспорт JSONL» выгружает отзывы по текущим фильтрам построчным JSON-файлом — формат подходит для анализа накопленных жалоб во внешних инструментах. Счётчик на кнопке Обновить показывает, сколько новых отзывов пришло с момента загрузки страницы.

Как разобрать обработку документа

Страница «Обработка документов» показывает, что конвейер приёма сделал с каждым документом, который пользователи загрузили в базы знаний или ассистентам, во всех рабочих пространствах. Журнал только для разбора: повторную обработку запускает владелец документа на своём экране, а из журнала доступна одна операция — прервать обработку, которая занимает исполнителей.

Страница состоит из четырёх вкладок.

Статус документа принимает семь значений.

Над таблицей документов показываются только те остановленные документы, причину которых снимает администратор: лимит страниц или длительности записи, не настроено распознавание сканов, изображений или речи, закончились кредиты, нет исполнителя стадии. Сообщения сгруппированы по причине — тысяча документов с одной причиной дают одну строку. Если причину снимает экран настроек, в сообщении есть кнопка «Открыть настройки»; после снятия многих причин обработка продолжится сама, перезагружать документы не нужно.

Документы, которые ждут своего владельца — файл защищён паролем, ссылка не открылась, распознавание не подтверждено, нужен ручной повтор, — собраны на вкладке «Узкие места» в таблице «Ждут владельца документа»: причина, число документов и сколько ждёт самый давний. Снять эти причины может только владелец. Нажатие на строку открывает список этих документов, чтобы подсказать владельцу, какой документ и почему остановлен.

Разбирайте документ в таком порядке:

1. Найдите документ по имени в поле поиска или отфильтруйте список по статусу, стадии и причине.
2. Нажмите на строку — откроется карточка. Строка Причина называет, почему обработка остановилась.
3. Разверните «Хронологию обработки»: у каждой попытки стадии видны исполнитель, номер попытки, ожидание в очереди, длительность и код ошибки. Если стадия запускалась повторно, каждая попытка идёт отдельной строкой, и подпись говорит, чем она закончилась: «запланирован повтор», «исполнитель пропал», «попытки исчерпаны». Документы, обработанные до появления истории попыток или при выключенном журнале, показывают только последнюю попытку каждой стадии.
4. Нажмите «Скопировать разбор», чтобы передать всю историю документа поддержке или ИИ-ассистенту. Текста самого документа в разборе нет.

Блок «За период» на той же вкладке показывает историю: для каждой стадии и движка — долю общего времени обработки, число попыток и единиц, длительность, долю отказов, среднее ожидание в очереди и долю ответов из кэша. На периоде до 3 суток длительность показана медианой и 95-м перцентилем, а ниже перечислены частые причины сбоев — нажмите на причину, чтобы открыть список документов с ней. На периоде длиннее вместо перцентилей показаны среднее и максимум: история хранится суточными итогами 400 дней. Если за часть периода итогов нет — они ещё не посчитаны или исходные записи уже удалены уборкой, — над таблицей стоит предупреждение, и нулями такие дни не рисуются. Блок «Размер журнала» показывает, сколько места занимают таблицы журнала и возраст старейшей записи в каждой; замер обновляется раз в 5 минут.

На вкладке «Узкие места» сравните три числа по стадии: сколько задач в очереди, сколько ждёт старейшая и сколько исполнителей её обслуживают. Долгое ожидание при занятых исполнителях означает, что стадии не хватает исполнителей. Ноль исполнителей означает, что стадию никто не обслуживает и документы на ней остановятся. Документы, которые уже обрабатывает внешний сервис, считаются в «Выполняется», а не в очереди: пока сервис работает, исполнителя они не занимают. Так идут три стадии: расшифровка записей, разбор документа в Docling и индексация. Одновременно у сервиса расшифровки не больше 2 записей одного пользователя и 8 записей одного пространства, у Docling — не больше 2 документов одного пространства, поэтому большая загрузка одного человека или пространства не задерживает остальных. Эти числа меняются на вкладке Производительность страницы «Политики LLM и OCR».

В карточке документа строка «Как получен текст» показывает, что текст распознан моделью по изображению, какой моделью и сколько страниц. Для скана и изображения это обычный путь. У PDF с текстовым слоем это значит, что текст можно было взять из файла напрямую, но конвейер ушёл запасным путём, — тогда в строке «Замечания» указано, какой способ был основным, какой использован вместо него, почему и что сделать. Например, если недоступен Docling, его стоит включить: текст PDF начнёт браться из файла напрямую, быстрее и без ошибок распознавания.

Колонка «Страницы» в списке показывает итог по завершённому документу: сколько страниц (у книги — листов) готово, сколько не удалось и сколько с замечаниями, с полоской соотношения. У документа в работе там живой прогресс текущей стадии, у документа, остановленного до распознавания, — «300 · не начато». Прочерк означает, что журнал по документу не вёлся. Нажмите на заголовок колонки, чтобы поднять наверх документы с наибольшим числом неудавшихся страниц.

В карточке документа строка «Итог обработки» даёт ту же сводку плюс число символов и токенов и самую долгую стадию. Сводка хранится столько же, сколько сам документ, и не пропадает, когда уборка удаляет постраничную детализацию. У документа базы знаний карточка показывает задачу индексации, поставленную для этого документа, — её статус и число фрагментов; у файла ассистента — запись файла ассистента.

В карточке документа над хронологией стоит карта страниц: одна клетка — одна страница документа, у книги Excel — один лист. Цвет и форма клетки показывают, что получилось со страницей по всем стадиям сразу:

Если страницы загружаются частями, подпись над картой указывает, для скольких уже загруженных страниц посчитаны исходы.

Над картой — счётчики страниц по этим исходам. Переключатель «Только проблемные» превращает карту в список страниц с диагнозами. Нажмите на клетку — под картой откроется блок страницы: какая стадия и каким движком её обрабатывала, почему не получилось, размер изображения, число распознанных символов, расход токенов, длительность и сколько фрагментов для поиска собрано с этой страницы. Изображения, для которых номер страницы не определён, перечислены под картой отдельно. У документов, где страниц нет физически (DOCX без разметки страниц, текст, таблица-датасет, аудио и видео), вместо карты показан блок «Что извлечено из документа» — итог каждой стадии.

У распознанных страниц журнал проверяет качество по числам, без обращения к модели. Замечание ставится, если текст противоречит изображению (на странице почти нет печати, а текста как на обычной странице; текст совпал с несколькими другими страницами при разных изображениях) или если модель сама дала повод — отметила фрагменты неразборчивыми, вернула много служебных символов или распознала страницу только с повтора — и при этом текста заметно меньше, чем на остальных страницах того же документа. Одно лишь «мало текста» замечанием не считается: титульный лист, разделитель и чертёж законно дают мало символов. Замечание видно в блоке страницы и в списке «Только проблемные»; на статус документа оно пока не влияет — правило калибруется на реальных документах. Журнал не отличает правдоподобно выдуманный моделью текст от корректного: обнаруживаются только противоречия между изображением и текстом и аномалии распределения.

Текст документа в журнале не хранится. Кнопка «Показать распознанный текст» читает текст страницы из рабочих файлов обработки и доступна, только если чтение включено в Администрирование → Знания и поиск → Импорт документов (блок Журнал приёма). Каждое открытие текста фиксируется в журнале событий сервера (событие admin.ingest_journal.unit_text_read: кто, когда, какой документ и страница). Рабочие файлы хранятся 7 дней после окончания обработки; после этого текст страницы можно посмотреть в самом документе базы знаний. Постраничная детализация хранится 30 дней — потом карта сообщает, что детализация удалена политикой хранения, а сводка по стадиям остаётся.

Если над списком показано сообщение «Журнал приёма выключен настройкой», новые попытки не записываются: запись выключена в Администрирование → Знания и поиск → Импорт документов, блок Журнал приёма. Документы при этом обрабатываются как обычно.

Примечание. Вложения чата обрабатываются отдельным контуром и в этот журнал не попадают. Файлы ассистента, загруженные до перехода на общий конвейер приёма, в журнале тоже не видны — их число указано под таблицей документов.

Частые вопросы

Почему журнал пустой, хотя запуски точно были

Журналы «Запуски LLM» и «Запуски ASR» открываются за текущий день, а «Отзывы и оценки» — за последние семь дней. Проверьте:

• в фильтре Период выбран день обращения;
• в журнале запусков LLM не включён переключатель Только с ошибками;
• выбрано то рабочее пространство, в котором работал пользователь.

Почему в фильтре «Ассистент» пусто

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

Почему пункты «Журнал действий» и «Логи уведомлений» не видны в меню

Обе страницы зарезервированы под будущие журналы и скрыты из навигации. Историю отправленных писем платформа пишет на вкладке Журнал уведомлений страницы Администрирование → Платформа → SMTP.

Почему у отзыва нет связанного запуска

Платформа создаёт связь отзыва с запуском LLM в момент отправки отзыва и задним числом её не восстанавливает. У сообщений, отправленных до появления такой связи, в карточке отзыва вместо кнопки «Открыть запуск» написано, что связанный запуск не найден. У общих отзывов о продукте связи с чатом и запуском нет по определению.

Что дальше

• Раздел администрирования — карта всех групп настроек и переход в соседние разделы.
• Эксплуатация платформы — журнал уведомлений SMTP, режим обслуживания и политики очистки.
• Модели и политики — таймауты, режим очереди и поведение при отказе провайдера, которые вы увидели в журнале.
• Тарифы, кредиты и биллинг — сверить списание из карточки запуска с журналом списаний.