Проверки и авто-коррекция

Analytics Agent проверяет отчёты на трёх уровнях: документ → блоки → запросы. Смысл простой: отчёт с ошибками не увидит читатель — всё ловится до публикации, а рядом с каждой ошибкой есть кнопка исправления ИИ.

Уровень документа

• MISSING_TITLE — у документа нет заголовка;
• NO_BLOCKS — документ без блоков;
• MISSING_BLOCK_ID — у блока нет ID;
• DUPLICATE_BLOCK_ID — дублирующийся ID блока;
• INVALID_BLOCK_WIDTH — ширина блока вне диапазона 1–24;
• EMPTY_BLOCK_CONFIG — пустая конфигурация блока;
• INVALID_ACCESS_LEVEL — неизвестный уровень доступа;
• DUPLICATE_QUERY_ID, DUPLICATE_OVERRIDE_ID — дубли ID запросов и переопределений.

Уровень контента

• тип блока известен реестру — опечатка в contentType ловится сразу;
• ссылки queryId существуют, источник запроса найден (DATA_SOURCE_NOT_FOUND);
• конфигурация графика заполнена: колонки указаны (EMPTY_CONTENT_DATA, INVALID_CONTENT_DATA_TYPE).

Уровень запросов

SQL-запросы проверяются до выполнения: синтаксис, колонки, источники. Подробнее — в разделе Запросы.

Фоновая валидация

• все документы проверяются автоматически, в фоне;
• результаты кэшируются — повторные проверки не нагружают сервер;
• при изменении файлов документов — перепроверка.

API и отображение

• POST /api/validation/document — валидация документа;
• POST /api/validation/content — валидация контента блоков;
• GET /api/validation/data-sources — проверка источников данных;
• ошибки отображаются в интерфейсе рядом с блоком — с кнопкой «Исправить с помощью ИИ» (подробнее — ИИ-агент в отчёте).

← Оглавление документации