---
title: "Проверки и авто-коррекция"
id: "1345"
type: "page"
slug: "validation"
published_at: "2026-08-15T23:32:28+00:00"
modified_at: "2026-08-16T14:30:20+00:00"
url: "https://pastukhov.com/agents/analytics/docs/validation"
markdown_url: "https://pastukhov.com/agents/analytics/docs/validation.md"
excerpt: "Analytics Agent проверяет отчёты на трёх уровнях: документ → блоки → запросы. Смысл простой: отчёт…"
---

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

[https://pastukhov.com/agents/analytics/docs/validation.md](https://pastukhov.com/agents/analytics/docs/validation.md)

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-запросы проверяются до выполнения: синтаксис, колонки, источники. Подробнее — в разделе [Запросы](/agents/analytics/docs/queries)
.

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

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

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

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

[← Оглавление документации](/agents/analytics/docs)