Почему ИИ-агент зациклился — и как его остановить

Первое, что стоит понять: агент не завис. Зависший процесс молчит. А твой бодро работает — просто в двадцатый раз делает одно и то же. Открывает тот же файл, шлёт тот же запрос, «проверяет» уже сделанное.
Это меняет всё в отладке. Ты ищешь не место, где всё встало, а причину, по которой агент не понимает, что дело уже сделано.
Таких причин обычно три. Идут по частоте.
Причина 1: агент не видит результат своего действия
Самая частая. Агент вызвал инструмент, инструмент отработал — но обратно вернулась пустота: undefined, пустая строка, null. Для модели это выглядит как «ничего не произошло». Логичная реакция — повторить.
Это и есть суть цикла агента: думает → действует → смотрит на результат → думает дальше. Убери третий шаг — и цикл замкнётся.
Как проверить. Залогируй то, что уходит обратно модели, а не то, что возвращает твоя функция:
const result = await runTool(name, args);
console.log("→ модели уходит:", JSON.stringify(result));
Увидел undefined, {} или пустую строку — нашёл причину. Частый вариант: функция асинхронная, а результат вернули без await.
Как починить. Инструмент всегда возвращает текст, который что-то утверждает. Не молчание, а «Файл config.json создан, 412 байт». Даже когда делать было нечего: «Записей не найдено, таблица пуста» — это ответ, а «ничего» — не ответ.
Причина 2: нет критерия «готово» и лимита шагов
Ты попросил: «Улучши код в этом файле». Агент улучшил. И спрашивает себя: готово? А непонятно — «улучши» не имеет конца. Он улучшает ещё раз. И ещё.
То же самое с задачами-состояниями: «сделай, чтобы тесты проходили». Если тест падает по причине, которую агент не может устранить, он будет чинить его вечно — каждый раз новым способом.
Как проверить. Прочитай свою задачу и ответь одним предложением: что должно быть на экране, чтобы работа считалась законченной? Не смог — агент тоже не сможет.
Как починить.
- Задай видимый признак готовности. Не «улучши», а «вынеси повторяющийся код в функцию и покажи итоговый файл». Есть файл — есть конец.
- Поставь лимит шагов. 10–15 хватает почти для всего. Уперся в лимит — это не поражение, а сработавший предохранитель.
- Разбей задачу. Три маленькие с понятным финалом надёжнее одной большой.
Причина 3: ошибка приходит без подробностей
Инструмент упал, а модель получила «Error» или, того хуже, — молчаливый «успех». Обе ситуации ведут в цикл: в первой агенту не за что зацепиться, чтобы поменять подход, во второй он уверен, что всё хорошо, и удивляется, почему результата нет.
Знакомый пример: вызов инструмента уходит с неверным ключом, сервер отвечает 401, а обёртка глотает ошибку и возвращает пустой список. Агент видит «пусто» и просто пробует ещё раз.
Как проверить. Найди в коде инструментов try/catch и посмотри, что в catch. Если там return null или голое "error" — вот оно.
Как починить. Возвращай ошибку текстом, как обычный результат:
catch (e) {
return `Ошибка: ${e.message}. Проверь ключ API и повтори запрос.`;
}
Модель прочитает это и сменит тактику — попросит ключ или пойдёт другим путём. Ошибка в контексте полезнее тишины.
Аварийный тормоз — поставь его сразу
До того как чинить причины, поставь ограничители. Они дешёвые и спасают счёт за токены:
- Лимит шагов — жёсткий предел итераций.
- Ловушка повтора — запоминай последние 2–3 вызова с аргументами. Третий одинаковый подряд — остановись и верни агенту: «Ты повторяешь один и тот же вызов, он не помогает. Смени подход».
- Лимит бюджета — потолок по токенам на задачу.
- Лог каждого шага — что вызвал, с чем, что получил. Без него ты гадаешь.
Отдельная история — когда агент не зациклился, а забыл, что уже делал: длинная задача не влезла в окно контекста, и начало разговора выпало. Симптом похож, лечение другое — про это есть разбор, почему бот забывает контекст.
Это баг модели?
Почти никогда. В девяти случаях из десяти проблема в обвязке: инструмент вернул пустоту, ошибка потерялась, задача без критерия готовности. Модель просто честно реагирует на то, что видит.
Поможет ли модель поумнее?
Немного: сильная модель раньше догадается, что топчется на месте. Но если результат до неё не доходит, догадываться не из чего — цикл вернётся, просто дороже.
Почему счёт вырос так быстро?
Каждый круг тащит с собой всю предыдущую переписку, и она растёт. Двадцать кругов — это не двадцать запросов по цене первого, а всё более длинные и дорогие. Поэтому лимит шагов ставят до отладки, а не после.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





