Отдел 00 · Агент

Ошибка агента: заметить, остановить, откатить

время чтения ~10 минут · рецептов: 3 · обновлено: ноябрь 2026

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

Останавливать — вам, читать след — агенту

Хорошо: остановить работу сразу, как заметили неладное, снять снимок состояния, прочитать, какие файлы и строки изменились, откатить ровно испорченное и записать причину, чтобы она не повторилась. Категорически плохо: давать агенту самому решать, что было ошибкой, откатывать вслепую целую папку, стирать журнал изменений и просить «сделай как было», не показав, что именно стало не так. Ошибку чинят в три такта: стоп, след, откат. Пропущенный такт превращает мелкую правку в потерянный день.

Шаг 1. Остановить работу и снять снимок

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

Второе — снимок. Сфотографируйте экран, сохраните список изменённых файлов, скопируйте папку целиком в отдельное место. Например, после неудачной уборки архива я копировал папку «Документы» в «Документы до правки» и только потом что-то трогал. Копия занимает место, зато откат перестаёт быть гаданием. Если проект под управлением версий, снимок уже есть в истории, но и там полезно записать, на какой версии всё сломалось.

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

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

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

Рецепт 1 · стоп и снимок
Задание остановлено, вот что известно: [что случилось, одна фраза].
1) Составь список того, что могло измениться: файлы, письма, настройки.
2) Дай команду сохранить копию этих мест в папку с датой.
3) Выведи таблицу: путь, время изменения, размер до и после.
4) Пометь строки, где размер изменился больше чем на [порог].
Ничего не исправляй: только список и копия.

Разбор: почему «сделай как было» не работает

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

Шаг 2. Прочитать след: что именно изменилось

Когда работа стоит и копия снята, наступает очередь следа. След — это не рассказ агента, а список изменений: какие файлы тронуты, какие строки добавлены и удалены, какие письма ушли, какие записи появились. В папке с историей версий это одна команда сравнения; без истории — сравнение с копией, снятой на первом шаге.

Читать след стоит по одному месту за раз. Большая таблица изменений пугает, но почти всегда порча сосредоточена в двух-трёх файлах, а остальные строки — следствие. Например, агент «поправил отчёт» и заодно пересохранил все таблицы в новом формате: содержательная ошибка одна, а изменённых файлов тридцать. Такие волны видны по одинаковому характеру правок.

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

Читая след, полезно задавать один вопрос к каждой строке: это последствие моей просьбы или самостоятельное решение агента? Последствие обычно ожидаемо, даже если сделано грубо. Самостоятельное решение удивляет — и именно оно чаще всего и портит дело. Например, вы просили переименовать три файла, а агент заодно привёл к единому виду ещё двадцать: следствие понятное, но объём работы вы не заказывали.

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

Рецепт 2 · разбор следа
Вот список изменённых файлов: [вставьте список].
1) Сгруппируй изменения по смыслу: содержание, формат, служебные файлы.
2) Для каждой группы назови, что именно испорчено и чем это видно.
3) Отдельно — действия наружу: письма, публикации, загрузки.
4) Сверь каждое утверждение с исходной строкой и укажи, где она лежит.
Не чини: только разбор с ссылками на места.

Разбор: отличать порчу от побочного следа

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

Шаг 3. Откатить ровно испорченное и закрыть причину

Откат — самое узкое место. Широкий откат «вернуть папку целиком» стирает и полезное: правки, сделанные после снимка, чужие изменения, случайно нужные файлы. Поэтому откатывают по списку из второго шага, по одному месту, с проверкой после каждого. Сначала — то, что ушло наружу и ещё можно остановить; потом — файлы; в конце — служебные настройки.

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

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

Последний такт — причина. Не «впредь быть внимательнее», а конкретное правило: не давать агенту права удалять без подтверждения, работать в отдельной папке, отправлять письма только черновиком. Причина, записанная одной строкой рядом с делом, экономит следующую ошибку. Подробнее о том, как принимать работу в обычном режиме, — в статье «Приёмка работы».

Рецепт 3 · откат и запись причины
Откатываем по списку: [места из шага 2].
1) Порядок: сначала внешние действия, потом файлы, потом настройки.
2) После каждого места — сравнение с исходником и строка «отличий: 0».
3) Если отличие осталось, назови его и объясни, почему оно безопасно.
4) Одной строкой запиши причину и правило, которое её закрывает.
Не расширяй откат за пределы списка.

Разбор: журнал ошибок дешевле повторной ошибки

Записанная причина работает как лекарство от повтора. Через месяц вы не вспомните, почему запретили агенту трогать папку загрузок, а строка в журнале напомнит. Ведение такого журнала описано в статье «Журнал решений»: те же поля — что случилось, что решили, чем проверим.

Почему это стоит проговорить заранее

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

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

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

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