Почему AI-агент ломается в проде: пять слоёв отказа и диагностическая петля
Почему флагманские LLM проваливают простые задачи в реальных репозиториях: пять слоёв отказа агента (задача, инструкции, состояние, инструменты, верификация) и диагностическая петля поиска сломанного слоя.
- Перестанете чинить агента апгрейдом модели там, где проблема в harness.
- Освоите пятислойную модель отказа и будете быстро находить, в каком слое дефект.
- Проведёте диагностическую петлю на своём реальном провале агента.
강의 시작 부분
Знакомая картина: агент говорит «готово», а тесты красные
- Добавил фичу — сломал три теста
- Починил баг — родил два новых
- Двадцать минут работы, уверенное «готово»
- Открываете диф — а там не то, что просили
Вы даёте агенту реальную задачу в реальном репозитории. Он добавляет фичу и ломает три теста. Чинит баг и создаёт два новых. Работает двадцать минут и уверенно заявляет «готово», а вы открываете диф и видите совсем не то, что просили. Первая мысль почти всегда одна — нужна модель посильнее. Дальше в лекции разберём, почему эта мысль почти всегда неверная и на что смотреть вместо модели.
🤔 Миф: нужна модель посильнее
- 🤔 Миф / Часто путают: чтобы агент перестал проваливать задачи, нужно взять модель помощнее
- ✅ На самом деле: разрыв между бенчмарком и вашей реальностью решает не модель, а среда вокруг неё
- 📌 Запомните: закрывает этот разрыв инженерия harness, а не апгрейд модели
Первая мысль после провала агента почти всегда одна: нужна модель посильнее. Это миф. Разрыв между тем, что модель показывает на отобранных бенчмарках, и тем, что получается в вашем реальном репозитории, называется capability gap. И закрывается он не апгрейдом модели, а изменением среды вокруг неё — тем, как сформулирована задача, какой контекст доступен агенту, насколько воспроизводима среда исполнения и есть ли честная проверка результата. Дальше на конкретных экспериментах разберём, почему это так.
Способность модели и надёжность результата — не одно и то же
- Лучшие кодинг-агенты на SWE-bench Verified держатся в районе 50–60%
- Это на отобранных задачах с внятным описанием и уже готовыми тестами
- В вашем репозитории требования размыты, тестов нет — и цифра падает ещё ниже
- Разрыв между бенчмарком и реальностью — это и есть capability gap
К концу 2025 года лучшие кодинг-агенты на SWE-bench Verified держались в районе пятидесяти-шестидесяти процентов. И это на отобранных задачах с внятным описанием и уже существующими тестами. В вашем же репозитории требования размыты, тестов нет, бизнес-правила живут в головах людей — и цифра падает дальше. Способность модели решать задачи в вакууме и надёжность результата в вашем конкретном проекте — это два разных измерения, и путать их — источник большинства напрасных апгрейдов.
전체 강의는 구독 후 이용 가능
전체 버전에는 17개의 슬라이드가 더 있습니다.
로그인하고 구독하면 영상, 모든 슬라이드, 노트, 테스트, AI 튜터, 면접을 이용할 수 있습니다.
로그인 또는 회원가입 구독하기강의 목차
- Знакомая картина: агент говорит «готово», а тесты красные
- 🤔 Миф: нужна модель посильнее
- Способность модели и надёжность результата — не одно и то же
- 🛠 Эксперимент Anthropic: та же модель, разная упряжь
- 📖 Кейс OpenAI: миллион строк без единой строчки от человека
- Пять слоёв, где на самом деле ломается агент
- Слой 1 и 2: задача понятна и агент знает конвенции?
- Слой 3 и 4: среда воспроизводима и есть ли честная проверка?
- Слой 5: знание переживает сессию или каждый раз с нуля
- Грабли: чинят модель, а не слой
- Сквозной проект курса: платёжный бэкенд на FastAPI
- Диагностическая петля — ядро всей методологии
- Применяем петлю к нашему платёжному бэкенду
- ❓ Стоп-проверка: в каком слое проблема
- 💡 Разбор: сразу два слоя
- Шаг 1: пишите Definition of Done явно
- Шаг 2: заведите AGENTS.md
- Шаг 3: заведите журнал провалов
- Домашний эксперимент: два прогона одной задачи, один неожиданный вывод
- Модель редко виновата — виноват harness вокруг неё
이 강의 관련 글
- Harness engineering이란: AI 에이전트를 실제로 쓸 수 있는 도구로 만드는 방법
- AI 에이전트를 신뢰할 수 있게 만드는 방법: 측정에서 자율 작업까지 단계별 로드맵
- CLAUDE.md와 AGENTS.md: 무엇이며 무엇을 써야 하고 에이전트가 규칙을 무시하는 이유
- 에이전트가 "완료"라고 했지만 기능이 작동하지 않는다: AI 에이전트 작업을 검증하는 방법
- Harness vs context engineering: 하네스 엔지니어링은 prompt 및 context engineering과 어떻게 다른가
이 강좌의 모든 강의
- Что такое harness engineering: почему AI-агент ломается из-за среды, а не модели
- Накопление ошибок у AI-агента: почему 95% точности на шаг дают провал на 10-м шаге
- Метрики надёжности AI-агента: MTBF, MTTR, радиус поражения и закон Литтла
- Почему AI-агент ломается в проде: пять слоёв отказа и диагностическая петля
- Из чего состоит harness AI-агента: инструкции, инструменты, среда, состояние, обратная связь
- Карта репозитория для AI-агента: структура проекта и состояние без памяти между сессиями
- AGENTS.md: почему большой файл инструкций не работает и как устроить роутер
- Память AI-агента между сессиями: session handoff, PROGRESS.md и bootstrap-контракт
- feature_list.json для AI-агента: WIP=1, статусы фич и верификация через verify.sh
- Агент написал «готово», а фича не работает: verification gap и Definition of Done
- Все тесты зелёные, а фича сломана: E2E-тесты и архитектурные правила для AI-агента
- Наблюдаемость AI-агента: sprint contract, рубрика оценщика и чистый выход из сессии
- Автономный AI-агент часами без присмотра: Loop Engineering и условия остановки
- Graph Engineering для AI-агентов: когда одного цикла мало и нужен граф задач
- Харнес AI-агента с нуля: AGENTS.md, feature_list.json, verify.sh и автономный цикл