AIKraft Agents
Главная/Блог/Гайд/Как остановить бесконечный цикл…
Гайд4 мин чтения · 12 ноября 2026 г.

Как остановить бесконечный цикл AI-агента: Полное руководство

Узнайте, как предотвратить финансовые потери и зависание AI-агентов в бесконечных циклах с помощью четырех уровней защиты: детекции, нормализации, лимитов и бюджетов.

Как остановить бесконечный цикл AI-агента: Полное руководство

Представьте себе сценарий: ваш AI-агент, созданный для автоматизации сложных задач, начинает работать. Вроде бы все идет по плану, но вдруг вы замечаете, что потребление токенов растет экспоненциально, а счетчик затрат на API стремительно приближается к критической отметке. Что происходит? Агент застрял в бесконечном цикле. Это не просто технический баг — это прямая угроза вашему бюджету. Когда модель продолжает вызывать инструмент, который постоянно выдает ошибку, она не получает сигнала остановиться. Каждый новый шаг отправляет всю историю диалога обратно в модель, увеличивая стоимость каждого последующего запроса. За ночь такой «бесконечный» цикл может стоить тысячи долларов.

В этой статье мы подробно разберем, почему AI-агенты попадают в ловушку бесконечных циклов (infinite loops) и, что самое важное, как их остановить. Мы не просто перечислим проблемы, а предложим комплексное решение, состоящее из четырех уровней защиты. Этот подход был протестирован на шести современных больших языковых моделях (LLM), и он позволяет заметно сократить количество лишних вызовов инструментов, экономя значительную часть затрат.

01Почему AI-агенты застревают в бесконечных циклах?

Чтобы понять природу проблемы, нужно взглянуть на механику работы агента. Цикл агента завершается только тогда, когда модель генерирует ответ, не требующий вызова инструмента. Однако, если инструмент постоянно терпит неудачу (например, таймаут или ошибка сервера), у модели нет причин прекращать попытки. Ошибка возвращается в контекст диалога, инструкции по-прежнему требуют выполнить задачу, и следующая попытка выглядит для модели как логичный следующий шаг.

Проблема усугубляется тем, что с каждым шагом стоимость выполнения растет. Поскольку каждый новый ход отправляет всю предыдущую историю разговора (включая все предыдущие ошибки) обратно в модель, объем входных данных увеличивается. В одном из наших тестов объем входных данных вырос с 131 токена до 3262 токенов, а стоимость каждого последующего хода почти увеличилась вчетверо. Если запустить такой процесс на ночь с несколькими сессиями одновременно, расходы могут достичь астрономических сумм.

Чтобы наглядно продемонстрировать эту проблему, мы создали «агента-биллинга», единственным инструментом которого является функция, всегда терпящая неудачу, имитируя сбой сервиса выставления счетов. Ниже приведен пример кода на TypeScript, который демонстрирует эту ситуацию без каких-либо защитных механизмов:

Как остановить бесконечный цикл AI-агента: Полное руководство
terminaltypescript
import { OpenRouter, tool, stepCountIs } from '@openrouter/agent';
import { z } from 'zod';

const openrouter = new OpenRouter({ apiKey: process.env.OPENROUTER_API_KEY });

let attempts = 0;

const fetchInvoice = tool({
  name: 'fetch_invoice',
  description: 'Fetch an invoice from the billing service by ID.',
  inputSchema: z.object({ invoice_id: z.string() }),
  execute: async ({ invoice_id }) => {
    attempts++;
    console.log(`fetch_invoice("${invoice_id}")`);
    throw new Error(`billing-service timeout after 30s fetching ${invoice_id}`);
  },
});

let cost = 0;
const result = await openrouter.callModel({
  model: 'mistralai/mistral-large-4-0',
  instructions: 'You are a billing agent. Complete the task. If a tool call fails, retry it. Do not stop until you have the invoice total.',
  input: 'Get the total of invoice INV-2291.',
  tools: [fetchInvoice] as const,
  stopWhen: stepCountIs(40), // Ограничитель только для демо
  hooks: {
    PostModelCall: [{ handler: ({ usage }) => { cost += usage?.cost ?? 0; } }],
    DoomLoopDetected: [{ handler: ({ action, streak }) => console.log(`DoomLoopDetected: ${action} (streak ${streak})`) }],
    SessionEnd: [{ handler: ({ reason }) => console.log(`SessionEnd: ${reason}`) }],
  },
});

const text = await result.getText();
const verdict = await result.getDoomLoopVerdict();

console.log(`attempts: ${attempts}, cost: $${cost.toFixed(4)}`);
console.log(verdict ? `stopped: ${verdict.message}` : '');
console.log(text.slice(0, 160));

Результат выполнения этого кода без детекции циклов показывает множество попыток вызова инструмента. Агент завершает работу только потому, что сработало жесткое ограничение в 40 шагов, заложенное в демо. Без этого ограничения он продолжал бы работать бесконечно. Финальный ответ модели гласит, что сервис постоянно таймаутит, но модель, не получив сигнала о невозможности выполнения, продолжает попытки.

Темная тема визуализации бесконечного цикла, подчеркивающая серьезность проблемы
Темная тема визуализации бесконечного цикла, подчеркивающая серьезность проблемы

02Шаг 1: Включите детекцию «смертельного» цикла (Doom-Loop Detection)

Первый и самый эффективный шаг — включить встроенную функцию детекции бесконечных циклов в OpenRouter Agent SDK. Это делается добавлением одной опции doomLoop: true в вызов модели. Эта функция анализирует каждый вызов инструмента, создавая «отпечаток» (fingerprint) на основе имени инструмента и его аргументов.

Детектор нормализует аргументы перед сравнением, что означает, что порядок ключей в JSON не повлияет на результат. Важно отметить, что повтор засчитывается только тогда, когда модель уже видела результат предыдущей попытки и снова запрашивает тот же инструмент. Пять идентичных вызовов в одном ходу считаются как один повтор. По умолчанию детектор использует лестницу реакций: наблюдение (observe) при 2 повторениях, блокировка (block) при 3 и остановка (stop) при 6.

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

💡
Совет по настройке. Вы можете настроить пороги срабатывания. Например, установка doomLoop: { ladder: { observe: 2, block: 3, stop: 4 } } позволит остановить цикл еще раньше, ч

Источник: OpenRouter ↗