# Сухой прогон автоматизации: как проверить изменения до записи

Как устроить сухой прогон автоматизации: показать список изменений, проверить нулевую запись и повторно сверить данные перед запуском в рабочей системе.

URL: https://posts.danashkin.ru/guides/suhoy-progon-avtomatizacii
Обновлено: 2026-11-18

---

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

**Главное**

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

## Что показывает сухой прогон автоматизации?

**Главное**

Сухой прогон читает входные данные и текущее состояние, вычисляет конкретные изменения и возвращает их на проверку. Рабочие записи, письма и задания для дальнейшей обработки от такого запуска не меняются.

Сухой прогон показывает, какие записи изменятся и почему. Для каталога это список товаров, где рядом видны артикул, старое значение, предложенное значение и причина.

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

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

Сухой прогон предложит сменить название первого, сохранит прежнее описание второго, если пустое поле означает пропуск, и отправит третий на ручной разбор. Если в отчёте все три товара значатся как «готовы к обновлению», как раз здесь и находится ошибка постановки задачи.

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

## Отчёт перед изменением

**Главное**

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

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

Если итоговые числа не складываются обратно в шесть, попроси объяснить, какая строка осталась за пределами расчёта. Если отчёт считает и строки входа, и уникальные товары, подпиши оба показателя явно.

| Случай в выгрузке | Что показать проверяющему |
|---|---|
| Поле меняется | Товар, поле, старый и новый текст |
| Значение совпадает | Число таких строк и способ открыть исходную строку |
| Поле пустое | Правило, по которому значение оставили или предложили очистить |
| Один ключ дал разные значения | Обе исходные строки и отсутствие автоматической записи |
| Товар не найден | Ключ из выгрузки и явное решение, допускается ли создание |

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

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

## Как отделить расчёт от записи?

**Главное**

Правила сопоставления и вычисления правок должны использоваться в обоих режимах. Сухой режим заканчивается на плане. Изменять каталог, отправлять письма и ставить задания в очередь может только рабочий этап.

Попроси [ИИ-агента](/concepts/ai-agent) сначала описать два этапа словами. На первом он читает обе стороны и получает список действий: заменить поле, оставить как есть или пропустить с объяснением.

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

Смотри и за непрямыми последствиями. Внутренний вызов «проверить карточку» может обновлять её служебную отметку. Создание задачи в очереди может запустить обработчика позже, после того как пробный прогон уже завершился.

Лог и отдельный файл предпросмотра допустимы, если их создание предусмотрено, а для каталога запись должна оставаться выключенной. Назови это в задании явно, особенно если один запуск вызывает несколько сервисов.

**Проверка на одном заметном изменении**

Возьми тестовый товар с легко узнаваемым названием. Пусть план предлагает новое значение. После сухого прогона снова открой товар и проверь, что там старое название, а по идентификатору прогона или тестовому товару в очереди и журнале отправки нет новых задач и уведомлений.

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

Если один и тот же инструмент имеет все права, проверь счётчик вызовов записи на тесте и состояние объектов после запуска. В [разборе доступа агента к рабочим системам](/guides/dostup-agenta-k-pochte-i-serveru) есть порядок выбора таких границ.

## Проверка, что план ещё актуален

**Главное**

Сохрани версию входа и ожидаемое старое состояние изменяемых полей. Если товар изменился после просмотра, не применяй к нему прежнюю операцию автоматически. Пересчитай список и покажи новые расхождения.

Допустим, после предпросмотра менеджер руками уточнил название первого товара. Ты открываешь вчерашний отчёт и видишь замену, которая выглядела разумно в тот момент. Если выполнить её вслепую, вчерашний план сотрёт сегодняшнюю правку.

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

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

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

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

## Как провести первую рабочую партию?

**Главное**

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

Собери три случая: обычная замена, пустое значение с пропуском, конфликт по ключу. Сделай сухой прогон и открой отчёт глазами. Разреши одно обычное изменение на тестовой копии.

Сверь поле после записи, отсутствие изменений на остальных товарах и то, что в журнале виден номер операции. Если есть внешний получатель, проверь, какие события он увидел. На этом этапе полезно действовать как [при приёмке работы агента](/guides/kak-proveryat-ai-kod-bez-teh-bekgraunda): открывать реальные результаты каждого шага.

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

Особенно внимательно смотри на кнопку «запустить ещё раз»: если одна операция уже выполнилась, защищённый повтор не должен выполнять её снова. Свяжи действие с сохранённым результатом по ключу операции, как в [разборе повторного запуска без дублей](/guides/povtornyy-zapusk-bez-dubley). Если потребуется вернуть изменённое поле, сохрани достаточную историю и заранее узнай, как [откатываются изменения](/guides/kak-otkatit-izmeneniya-agenta).

Когда копия прошла проверки, выбери небольшую рабочую партию. Снова построй список на свежих данных, укажи конкретные артикулы и сразу после записи открой изменённые поля в каталоге.

При переносе карточек из YouGile в AI-PULT сначала подготовили отчёт сухого прогона. Перед записью сделали резервную копию таблицы, импорт провели одной транзакцией. Повтор не добавил новых записей. Для своей команды опиши те же три результата в задании агенту: отчёт, способ восстановления и проверяемый повтор. Если нужна помощь с постановкой, посмотри [программу практикума по ИИ-агентам](https://danashkin.ru/agents/).

## Что делать с операциями, которые трудно вернуть?

**Главное**

Отдели отключения, удаления и очистку полей от обычных обновлений. На опасные действия нужны явное подтверждение списка и отдельный флаг запуска. По умолчанию они выключены.

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

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

В условном импорте обычная запись запускается с флагом применения изменений. Для отключений предусмотрен отдельный флаг, например `--allow-disable`, и список подтверждённых артикулов из конкретной версии плана. Даже этот флаг не разрешает удаление. Если удаление вообще поддерживается, задай отдельное разрешение и принимай только явно согласованные ID. Без флага операция должна оставаться в отчёте со статусом «не применена», даже если остальные правки уже записались.

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

## Что чаще всего путают с сухим прогоном?

**Главное**

Черновик плана может быть сухим прогоном, если он построен из текущих входных данных и ничего не меняет в рабочей системе. Ручная симуляция полезна для обучения, а тестовая запись проверяет другой этап.

### Частые вопросы

**Достаточно попросить агента ничего не сохранять?**

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

**Зачем нужен тест на копии, если предпросмотр уже сошёлся?**

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

**Нужен ли отдельный отчёт для одной записи?**

Часто хватает короткого сравнения старого и нового. Если изменение заметно клиентам или его тяжело отменить, даже одно поле стоит показать до записи и открыть после неё.

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

### Источники

- [Прогноз изменений и оговорка об изменениях состояния перед применением](https://developer.hashicorp.com/terraform/cli/commands/plan)
- [Чем пробный перенос отличается от передачи данных](https://man7.org/linux/man-pages/man1/rsync.1.html)
