Ищите дефекты с проверяемыми гипотезами

Опишите сбой до предложения исправления

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

Фраза «экспорт сломан» мало помогает. Лучше: «Локально экспорт работает. В staging тот же запрос руководителя возвращает 403 после последнего развёртывания. Остальные маршруты работают».

Это описание не устанавливает причину. Оно указывает различия, которые направляют исследование.

Сохраняйте несколько возможных объяснений

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

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

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

Выберите безопасное наблюдение

Начните с недорогого наблюдения, которое различает объяснения. Сравните развёрнутую версию и несекретную конфигурацию. Изучите соответствующую ошибку и идентификатор запроса. По возможности воспроизведите проблему в разрешённом тестовом окружении.

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

Укажите, что ослабит каждую гипотезу. Это помогает агенту пересматривать объяснение вместо защиты первого ответа.

Меняйте по одной причине

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

Проверьте исходное условие сбоя. Также проверьте соседнюю границу. Исправив доступ руководителя, убедитесь, что пользователь без разрешения по-прежнему получает отказ.

Для повторяющегося дефекта добавьте регрессионную проверку на уровне, который способен его обнаружить. Unit-тест не обнаруживает все ошибки конфигурации развёртывания. Некоторым сбоям нужна интеграционная проверка или контролируемая проверка после развёртывания.

Останавливайте повторные попытки без новых данных

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

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

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