Успешный запрос не закрывает весь список
Массовое действие удобно человеку: одна просьба вместо десятков карточек. За ней могут стоять один вызов API, несколько вызовов или собственная очередь приложения. Эти уровни важно различать. Сообщение о доставленном запросе ещё не описывает результат каждой операции, а успех первой части очереди не означает успех всей команды.
В документации API Директа об операциях над массивом входным объектам соответствуют результаты в том же порядке. Ошибка одного объекта обычно не мешает остальным. Есть существенное исключение: отсутствие обязательного параметра может сделать неверным формат всего запроса. Поэтому нельзя заранее считать любой пакет полностью независимым набором действий.
У метода campaigns.update результаты возвращаются в UpdateResults. В них различаются идентификатор объекта, предупреждения и ошибки. Это проверяемый пример российского рекламного API. Он не устанавливает правила всех платформ и не означает, что любые поля кампании разрешено менять одинаковым способом.
Транспортный статус, описание метода и результаты элементов читаются вместе. RFC 9110 задаёт семантику HTTP, но не бизнес-договор собственного агента «изменить пять кампаний». Значение такого итога должно быть определено приложением. Простая зелёная отметка возле общего вызова слишком бедна для оператора.
Сохранить связь с исходным объектом
Представим, что агент отправил A, B, C и D в этом порядке. Для успешных операций вернулись идентификаторы, для ошибок - описания без ID. Если сначала удалить ошибочные элементы, а затем сопоставлять оставшиеся ответы с исходным списком по позиции, связь с кампанией сдвинется. Чужая ошибка может оказаться приписана другому объекту.
В Директе порядок результатов помогает восстановить эту связь. Для собственной очереди сохраняют локальный ключ, номер вызова, исходную позицию, идентификатор объекта и версию желаемого изменения. Локальный ключ не подменяет ID платформы. Он нужен, чтобы команда могла объяснить, какой ответ относится к какому заданию.
Сортировку для удобного экрана делают после сопоставления. Оператор вправе видеть ошибки первыми, но в записи уже должна существовать устойчивая связь с исходной операцией. Для чужого API отдельно проверяют, сохраняет ли он порядок, возвращает ли корреляционный ключ и как обозначает отсутствующий результат.
Сохранять весь запрос с пользовательскими данными для этого необязательно. Обычно достаточно разрешённых существенных полей, контрольной суммы задания и нужных технических ключей. Политика хранения определяет доступ и срок, а не стремление положить в диагностический журнал всё, что когда-либо увидел агент.
Разобрать пять учебных операций
В CSV реестра находятся пять вымышленных операций. Первые четыре относятся к одному условному вызову Q-1, для которого получен HTTP 200 и отдельные результаты. Пятая относится к другому вызову Q-2: его ответ потерян. Таким образом, мы не выдаём отсутствующую часть повреждённого JSON за успешно разобранный ответ.
| Операция | Наблюдение | Состояние знания | Следующее действие |
|---|---|---|---|
| A | Принята без предупреждения | Успех по ответу | Сохранить результат |
| B | Принята с предупреждением | Успех с особенностью | Прочитать предупреждение |
| C | Отказ из-за значения | Не выполнена | Исправить задание |
| D | Отказ в доступе | Не выполнена | Разобрать полномочия |
| E | Ответ отдельного вызова потерян | Неизвестно | Прочитать состояние |
У двух операций есть подтверждённый ответ об успехе, у двух - отказ, у одной исход неизвестен. Заявление «успешно изменены пять кампаний» неверно. Заявление «ничего не прошло» тоже неверно. Неизвестность E не превращается в отказ лишь потому, что агент не дождался сообщения.

Пошаговое демо показывает эту разбивку и очередь разбора. Оно использует собственное представление результатов, не готовый payload Директа. Условия, идентификаторы и суммы вымышлены; рекламные API не вызываются. Демонстрация нужна для проверки решения оператора, а не для запуска настоящих изменений.
В дополнительном шаге демо читает заранее заданное текущее состояние E. Оно совпадает с целевым. Это позволяет написать «целевое состояние подтверждено», но не доказывает, что именно потерянная команда его создала: параллельно мог действовать другой исполнитель. В интерфейсе эти основания остаются раздельными.
Не путать предупреждение и разрешение на повтор
В документации Директа наличие ID и Warnings означает успешную операцию с особенностью. Считать такую строку провалом и отправлять заново весь пакет - плохое восстановление. Нужно прочитать, что именно произошло. Предупреждение может быть полезно для последующего исправления процесса, даже если желаемое действие уже выполнено.
Массив Errors означает неисполнение. Та же документация рекомендует анализировать причину и менять приложение, а не автоматически повторять операцию с ошибкой. Отказ из-за неверного значения не исправится, если агент двадцать раз отправит то же значение. Отказ в доступе не является приглашением искать обход полномочий.

Исправленное задание - новая проверяемая версия. Его нужно заново проверить по существенным условиям, сопоставить с текущим объектом и выполнить в рамках разрешённого процесса. Если при изменении бюджета требуется согласование, старый отказ не освобождает от него. Привязка разрешения к версии плана закрывает именно эту связь.
Потерянный ответ требует другого пути. Сначала, насколько это позволяет продукт, читают фактическое состояние или реестр операций. Затем решают, нужен ли повтор и безопасен ли он. Механизм защиты от двойного создания разобран в материале о повторной команде агента. Здесь важно не скрыть неизвестную строку за общим процентом успеха.
Решить, что делать с уже принятыми изменениями
Человек может ожидать, что массовая команда выполнится целиком или не выполнится вовсе. Но такая атомарность должна быть свойством конкретного API или процесса. Наличие массива в запросе само по себе её не создаёт. После частичного успеха нельзя обещать автоматический откат всех объектов, если продукт не предоставляет такой гарантии.
Обратное изменение иногда выглядит простым: вернуть прежнее значение. Но между исходным чтением и восстановлением другой оператор мог законно поменять кампанию. Без проверки актуального состояния «откат» затрёт более позднее решение. Для компенсации сохраняют основание, проверяют версию и объясняют, какие изменения она сама внесёт.
Поэтому заранее полезно выбрать политику частичного выполнения. Один процесс останавливает следующую часть после первого отказа, другой продолжает независимые элементы и собирает отчёт. Третий сначала валидирует все задания, насколько это возможно. Ни один вариант не обещает отсутствия ошибок после проверки: права, состояние и данные могут измениться.
Для дорогих или связанных изменений разумно ограничивать размер шага и иметь понятное условие остановки. Универсальное безопасное число кампаний здесь не существует. Оно зависит от характера действия, обратимости и возможностей платформы. Не нужно превращать учебные пять операций в производственный лимит.
Принять массовую команду по понятному протоколу
Российская команда может встроить эту проверку в обычную приёмку агентной функции. Владелец процесса задаёт смысл общего успеха, интегратор проверяет формат и смысл ответов API, аналитик сверяет реестр, оператор получает список конкретных исключений. Интерфейс показывает процент успеха, неизвестные исходы и основание каждого результата.
Перед допуском проходят успешный элемент, успех с предупреждением, отказ по данным и отказ по правам. Отдельно проверяют ошибку формата всего запроса, повторный ID, потерю ответа другой части очереди и восстановление после перезапуска агента. У последнего задания должна сохраниться связь с исходным списком, даже если экран сортирует результаты иначе.
Критерий готовности проверяем: число входных операций объясняется состояниями реестра; ни одна строка не потерялась; уже принятые изменения не отправляются снова из-за ошибки соседней строки; неизвестный исход не назван отказом. Исправления имеют новую версию, а подтверждение текущего состояния не выдаётся за полную историю его происхождения.
Дальше пригодятся матрица прав агента, состояние после отмены и проверка агента без расходования бюджета. Определения guardrails, доставки и бизнес-результата связаны с темой AI в маркетинге.





