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