Почему повторное чтение не закрывает проблему
Рабочая ситуация возникает и без сложного AI. Два специалиста открыли один кабинет, оба сохранили изменения; позднее сохранение могло опереться на старую карточку. Агент добавляет ещё одного участника этого процесса. Его способность быстро составить правильный JSON не означает, что исходные настройки всё ещё действуют.
Допустим, агент ещё раз прочитал лимит непосредственно перед отправкой. Между чтением и записью человек всё равно может изменить кампанию. Этот промежуток иногда короткий, но сама проверка не запрещает другому участнику действовать. Защита должна связывать условие и изменение на стороне системы, принимающей запись.
Здесь рассматривается именно потеря чужого обновления. Другие задачи тоже нужны: проверить право агента повышать бюджет, корректность поля, повтор команды и фактическое применение результата. Однако по отдельности они не отвечают на вопрос, изменился ли объект после чтения.
Версия входит в условие записи
HTTP предусматривает для такой задачи заголовок If-Match. Агент получает представление кампании и его метку ETag, затем передаёт эту метку при изменении. Сервер сравнивает её с текущей версией перед выполнением операции. Если метки разошлись, устаревшая команда не должна затереть новое состояние.
Это поведение описано в разделе 13.1.1 RFC 9110. Для сравнения используется сильная проверка метки. Справка MDN показывает применение к конфликтующим изменениям и ответ 412 Precondition Failed при невыполненном условии. Это документы HTTP, а не обещание поддержки любым рекламным кабинетом.
В учебном примере метки названы «v1» и «v2». Это условные непрозрачные значения: клиент хранит выданную сервером метку целиком. Ему не нужно вычислять её из бюджета, угадывать следующий номер или считать, что изменение другой настройки оставит версию прежней.
Три шага, на которых теряется решение человека
Сначала агент читает лимит 1000 с версией v1. Затем человек сохраняет 800, и текущей становится версия v2. Наконец агент отправляет 1200, полагаясь на v1. Без проверки условия новое значение заменит 800. При корректно реализованной условной записи сервер обнаружит конфликт и сохранит результат человека.
Исходная последовательность в CSV доступна для повторения. В редакционном стенде можно по шагам прочитать состояние, выполнить правку человека и сравнить два способа записи агента. Все суммы вымышлены, реальные рекламные API не вызываются.
Редакционный стенд воспроизводит логику условной записи и имитирует ответ 412; сетевой запрос к рекламному кабинету не отправляется. Он помогает согласовать ожидаемое поведение, но поддержку нужно испытать отдельно в разрешённой тестовой среде поставщика.
Что проверить у конечного API
Нужен конкретный документ для конкретной операции. Наличие ETag в ответе чтения ещё не доказывает, что метод изменения учитывает If-Match. Метка может использоваться только для кеша. Посредник или обёртка также может не передавать условие до системы, которая фактически меняет кампанию.
У поставщика стоит уточнить область версии. Она относится ко всей кампании, одной группе объявлений или отдельному полю? Если дневной лимит находится в дочернем объекте, версия родительской кампании может оказаться неподходящей. Условие нужно связать с тем ресурсом, изменение которого оно защищает.
В тестовой среде готовят контролируемую гонку. Клиент читает объект, второй разрешённый участник меняет его, первый пытается записать с прежней меткой. Проходной результат: первая устаревшая операция отклонена, правка второго участника сохранена. Тест фиксирует запросы, ответы и последующее чтение. Один успешный ответ без конкурентного изменения эту гарантию не проверяет.
Если кабинет предоставляет собственное поле версии вместо HTTP-заголовка, проверяют его документированную семантику. Смысл тот же: система принимает изменение только относительно ожидаемой версии и проверяет это вместе с записью. Если клиент сам сравнит версии, а затем отправит безусловный запрос, другой участник всё ещё сможет изменить объект между этими действиями.
Сильная метка, звёздочка и контроль существования
Для If-Match слабая метка с префиксом W/ не подходит: сильное сравнение с ней не даст совпадения. Поэтому агент не должен удалять префикс и выдавать полученное значение за сильное. Если API возвращает только слабые метки, нужно выяснить предусмотренный поставщиком способ защиты изменений.
Значение звёздочка решает другую задачу: условие проверяет наличие текущего представления ресурса. Оно не привязывает запись к той версии, которую прочитал агент. Подмена сохранённой метки звёздочкой способна убрать именно ту защиту от устаревшего изменения, ради которой всё было настроено.
Также нельзя заменить условие фразой в инструкции модели: «не меняй, если кто-то уже отредактировал». Модель не знает о будущих изменениях и не может заблокировать их на сервере. В задании разработчику нужна проверяемая операция, а в инструкции агенту уже описывают реакцию на её результат.
Конфликт требует нового решения
После 412 агенту нужно остановить старую команду, прочитать текущее состояние и показать различия. В нашем примере человек уменьшил бюджет. Это новое ограничение задачи, поэтому простая замена v1 на v2 и повтор 1200 превратят техническое согласование версий в сознательную отмену решения человека.
Не следует автоматически пересчитывать и относительное повышение. Если первоначальное намерение звучало как «плюс 20%», из 800 получилось бы 960. Но человек мог снизить лимит из-за аварии, остатков товара или новой договорённости. Разрешение на старый план не обязательно распространяется на новый расчёт. Порядок повторного разрешения задаётся политикой конкретной команды.
Полезный ответ агента содержит прочитанное раньше значение, текущее значение, планировавшееся действие и причину остановки. Решение принимает ответственный медиабайер. Автоматическое действие допустимо по заранее разрешённому правилу, которое явно учитывает такой конфликт. Нужна запись основания, а не одно слово «ошибка» в журнале.
Когда изменения можно объединить
Два участника иногда меняют разные поля: один исправляет название, другой уменьшает лимит. Проверка версии всего объекта может отклонить запись из-за изменения другого поля, хотя сами правки совместимы. Это консервативная защита: она сообщает о расхождении, но не обязана сама выбирать, какие изменения объединять.
После нового чтения клиент способен подготовить следующую операцию, сохранив чужие поля. Для этого нужно знать семантику метода. Отправка всей старой карточки может вернуть прежние настройки даже при правильной новой метке. Частичное изменение и условная запись решают разные части задачи; их следует проверять вместе.
Если объединение затрагивает бюджет, даты, таргетинг или доступность товара, совместимость нельзя определять только по разным названиям полей. Перенос даты окончания меняет допустимый расход; переключение аудитории может отменить основание ставки. Здесь требуется проверка намерения и ограничений кампании.
Тайм-аут не означает конфликт версии
Если клиент не получил ответ, операция могла успеть примениться. В такой ситуации он сначала выясняет фактическое состояние и использует предусмотренные API средства отслеживания операции. Повтор запроса с новой меткой до проверки может создать ещё одно изменение. Нельзя смешивать неизвестный результат и явно отклонённое условие.
В журнале полезно разделять три состояния: операция отклонена по версии, результат неизвестен из-за связи, изменение подтверждено последующим чтением. Для каждого нужен свой следующий шаг. Стенд показывает только первый конфликт, поэтому не подтверждает устойчивость интеграции к сетевым сбоям или повторным доставкам.
Если кабинет не умеет условную запись
Отсутствие документированной поддержки ограничивает автономность. Можно согласовать одного исполнителя изменений и очередь, через которую проходят все участники. Однако если люди продолжают писать напрямую в кабинет в обход очереди, она не обеспечивает общей защиты. Организационное правило должно охватывать реальных редакторов кампании.
Другой вариант состоит в подготовке агентом предложения без непосредственной записи чувствительных полей. Ответственный проверяет актуальное состояние перед сохранением и понимает оставшийся риск гонки. Это не технический эквивалент If-Match; такой режим просто сужает последствия доступной автоматизации.
Для российской команды исходная задача поставщику должна содержать объект, поле, единицу бюджета и двух участников. Проходной критерий конкретный: устаревшая запись не меняет более новую карточку. Пока это не подтверждено, агенту нельзя приписывать защиту, которой интеграция не предоставляет.
Дальнейшие проверки описаны в статьях о семантике частичного изменения, привязке разрешения к версии и проверке применённого состояния. Определения ограничений автоматизации и управления расходом помогают составить общий договор; связанные разборы находятся в разделе AI в маркетинге.





