Агенты

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

Иллюстрация: робот идёт по кругу мимо одной и той же двери

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

Это меняет всё в отладке. Ты ищешь не место, где всё встало, а причину, по которой агент не понимает, что дело уже сделано.

Таких причин обычно три. Идут по частоте.

Причина 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 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →