Успешный запрос может вернуть ограниченную страницу

Пагинация означает выдачу набора частями. В API отчётов Яндекс Метрики количество строк страницы задаёт limit, начало - offset. Последний начинается с единицы. Есть также total_rows и признак округления общего количества. Это сведения одного продукта; иной API может продолжать выдачу непрозрачным курсором или вообще не сообщать точный остаток.

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

MCP описывает вызовы инструментов и их результаты. Пагинация tools/list перечисляет доступные инструменты, а не автоматически читает все строки рекламного отчёта внутри tools/call. Инструмент и его потребитель должны согласовать, как подтверждать полноту данных. Одной корректной схемы результата недостаточно.

Пройти три страницы одного снимка

В учебном CSV шесть кампаний. На первой странице расходы сто и двести рублей, на второй триста и четыреста, на третьей пятьсот и шестьсот. Все значения вымышлены, страницы относятся к одному явно заданному снимку S-1.

Первая страница даёт триста рублей по двум кампаниям. Две страницы дают тысячу по четырём. Только все три страницы дают 2 100 рублей по шести кампаниям нашего набора. Первая сумма сама по себе верна, но называть её расходом всех шести кампаний нельзя.

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

Одна страница не весь отчёт. Учебный журнал из шести кампаний, не настоящий API.
Учебный журнал из шести кампаний, не настоящий API.

Снимок S-1 - собственное поле демонстрации, не обязательный атрибут Метрики или MCP. Если настоящий источник не поддерживает стабильный снимок, команда должна проверить его способ согласованного чтения. Смена данных между запросами может изменить и состав, и порядок страниц. Сам факт получения нужного количества строк ещё не доказывает, что ни одна не пропущена и не повторена.

Разделить полноту страниц, выборку и права

Метрика отдельно раскрывает sampled, sample_share и data_lag. Они описывают семплирование и обновление данных. Прочитать все страницы семплированного ответа означает завершить выдачу этой выборки, а не получить все исходные наблюдения. Исправление offset не снимает ограничение выборки или задержку источника.

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

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

В MRC Outcomes and Data Quality Standards.pdf) полнота и известные ограничения рассматриваются как часть качества измерения. Для нашего инструмента это основание явно назвать недостающую часть, а не назначить ей ноль. Стандарт не предписывает учебный алгоритм страниц и не подтверждает наш результат как аккредитованное измерение.

Принимать вывод вместе с паспортом выгрузки

Свежая публикация AdExchanger о Chord и Zenlytic от 3 ноября 2026 года показывает коммерческий интерес к агентному интерфейсу аналитики. Частота вопросов к такому агенту не доказывает полноту прочитанных им данных. Практическая проверка остаётся у команды, которая подключает источник.

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

Критерий приёмки прост: промежуточная часть не называется полным отчётом; повтор не удваивает строки; смена снимка обнаруживается; неизвестное общее количество остаётся неизвестным. Если контракт API не позволяет доказать полноту, итоговый ответ прямо ограничивается наблюдаемым набором.

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