На этой странице
Аналитика и журнал запросов¶
Найдите причину сбоя или долгого ответа¶
Владельцу пространства доступны Аналитика → Вопросы. Выберите Период и отфильтруйте строки по исходу, режиму, входу или оценке. Откройте запрос и сравните время этапов, вызовы моделей, найденные фрагменты и фрагменты в контексте модели. Для чтения сохранённых текстов вопросов и проверок ответа нужно отдельное право.
Сравните дневные итоги по режимам или источникам запросов. Например, откройте запросы с исходом Ничего не найдено и сверьте их с индексом. После исправления повторите вопрос на вкладке Работа. Если результат содержит ID запроса, Открыть разбор запроса ведёт владельца к соответствующей записи.
При росте задержек сравните p50 и p95 целиком и по этапам. В блоке Стоимость проверьте вызовы без тарифа. Общая сумма учитывает вызовы с известной ценой. Перцентили стоимости ответа учитывают запросы, для которых известна цена каждого вызова. Сравните число положительных и отрицательных оценок с долей оценённых запросов.
После истечения срока хранения записей остаются дневные итоги. Перцентили
задержки, стоимость одного ответа и число уникальных авторов вопросов
относятся только к той части периода, по которой остались записи. В ответе
API начало этого интервала указано в rows_since. В блоке
Использование документов видно, какие документы нашёл поиск, а какие
были переданы модели.
Выгрузите вопросы или соберите датасет для оценки¶
Кнопка Выгрузить CSV скачивает до 50 000 самых свежих строк за выбранный период с учётом фильтров. Чтобы получить меньше строк, сократите период или уточните фильтры. Текст попадает в файл, если он сохранён и у вас есть право его читать.
Отметьте до 500 вопросов, тексты которых вам доступны, и выберите Собрать набор для оценки. Хотя бы один запрос должен был найти документ, у которого сохранился извлечённый текст. При сборе ContextBase копирует вопросы из журнала и текущее содержимое документов. Если документ заменили после запроса, его текст может отличаться от текста, по которому выполнялся поиск. Собранные датасеты и выгруженные файлы хранятся как отдельные копии.
Откройте результат в разделе Датасеты. Для метрик с метками релевантности или эталонами прочитайте собранные корпус и вопросы, разметьте их и загрузите новый датасет. Формат JSON и постраничное чтение через REST описаны в разделе Оцените качество поиска и ответов.
Управляйте хранением и доступом к текстам¶
В разделе Настройки → Сохранённые тексты запросов и проверок ответа выключите Сохранять тексты вопросов и проверок ответа, чтобы журнал перестал сохранять тексты новых запросов. Настройка также действует на черновики ответа, контекст генерации и пояснения проверок. Длительность, исходы, затраты и метаданные источников продолжают записываться. Ранее сохранённые тексты удаляются по общему сроку хранения.
В блоке Кто может читать тексты запросов и проверок ответа владелец с правом чтения текстов может выдать его другому владельцу или отозвать. Создатель пространства получает это право при создании. Блок Чтения текстов запросов и проверок ответа показывает, кто читал тексты в списке или карточке запроса, выгружал их или собирал из них датасет.
На уровне установки задаются QUERY_LOG_RETENTION_DAYS (по умолчанию
90 дней) и QUERY_LOG_MASK_PATTERNS со списком регулярных выражений в JSON
для маскирования совпадений перед сохранением. Персональные данные могут
не попасть под заданные шаблоны. Вошедший пользователь может удалить свои
сохранённые запросы из журналов всех пространств через
DELETE /api/v1/query-log/mine. Обезличенные дневные итоги сохраняются.
Прочитайте аналитику через REST¶
Передавайте токен доступа вошедшего пользователя в заголовке
Authorization: Bearer <access_token>. Для маршрутов пространства
нужен токен владельца. Все пути в таблице используют префикс
/api/v1/spaces/{space_id}/analytics.
Запрос |
Что посмотреть или изменить |
|---|---|
|
Сводка за последние |
|
Журнал запросов с фильтрами и сведения по одному запросу. |
|
Выгрузка CSV и сбор датасета. Для сбора передайте |
|
Прочитать или изменить |
|
Посмотреть журнал чтений и выдать или отозвать право. |
Схемы запросов и ответов приведены в Справочник REST API. Порядок расчёта периода и доступные данные описаны в контроллере аналитики и настройках хранения.