На этой странице

Аналитика и журнал запросов

Найдите причину сбоя или долгого ответа

  1. Владельцу пространства доступны Аналитика → Вопросы. Выберите Период и отфильтруйте строки по исходу, режиму, входу или оценке. Откройте запрос и сравните время этапов, вызовы моделей, найденные фрагменты и фрагменты в контексте модели. Для чтения сохранённых текстов вопросов и проверок ответа нужно отдельное право.

  2. Сравните дневные итоги по режимам или источникам запросов. Например, откройте запросы с исходом Ничего не найдено и сверьте их с индексом. После исправления повторите вопрос на вкладке Работа. Если результат содержит ID запроса, Открыть разбор запроса ведёт владельца к соответствующей записи.

  3. При росте задержек сравните 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.

Запрос

Что посмотреть или изменить

GET по префиксу

Сводка за последние days дней, включая текущий день по UTC.

GET /queries и GET /queries/{query_id}

Журнал запросов с фильтрами и сведения по одному запросу.

GET /queries/export и POST /datasets

Выгрузка CSV и сбор датасета. Для сбора передайте name и query_ids.

GET /settings и PUT /settings

Прочитать или изменить store_query_texts.

GET /text-accesses и PUT /text-readers/{user_id}

Посмотреть журнал чтений и выдать или отозвать право.

Схемы запросов и ответов приведены в Справочник REST API. Порядок расчёта периода и доступные данные описаны в контроллере аналитики и настройках хранения.

ContextBase0.1.0

Поиск в документации