﻿---
title: Цикл агента
description: "Наблюдение, план, действие и проверка: как устроен цикл, зачем нужен предел шагов и когда цикл не нужен вовсе."
---

Цикл — сердце агента. Модель получает состояние, выбирает действие, получает
результат и повторяет, пока не достигнет цели или не упрётся в предел. Почти все
проблемы эксплуатации — зацикливание, рост стоимости, потеря цели — это проблемы
цикла, а не модели.

## Четыре фазы

```mermaid
flowchart LR
  S["Наблюдение"] --> P["План"]
  P --> A["Действие"]
  A --> V["Проверка"]
  V -->|"цель не достигнута"| S
  V -->|"готово"| E["Ответ"]
```

- **Наблюдение.** Агент получает вход и всё, что накопилось: историю, результаты
  инструментов, ошибки.
- **План.** Модель решает, какой следующий шаг приближает к цели.
- **Действие.** Вызов инструмента, обращение к модели или запрос к человеку.
- **Проверка.** Оценка результата: цель достигнута, нужен ещё шаг или нужна
  эскалация.

В минимальной реализации все четыре фазы делает один вызов модели с описанием
инструментов. В LangGraph фазы становятся узлами графа, а переходы — рёбрами; в
CrewAI — задачами внутри команды. Это разные способы выразить один и тот же цикл.

## Предел шагов — обязателен

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

Рабочая практика:

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

В [разборе 01](https://wpcraft.ru/aia/examples/01-web-research-agent.md) цикла фактически нет: две
функции соединены в граф, маршрут фиксирован. Это законный случай — задача
укладывается в два шага, и предел не нужен.

## Когда цикл не нужен

Цикл нужен, когда число шагов заранее неизвестно. Если задача решается за
фиксированное число шагов, цикл добавляет только риск:

- **Один вызов.** Классификация, извлечение, переписывание.
- **Два шага.** Найти и синтезировать; получить и отформатировать.
- **Пайплайн.** Последовательность шагов с фиксированным маршрутом.

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

## Три отказа цикла

| Отказ | Как выглядит | Что делать |
| --- | --- | --- |
| Зацикливание | Повтор одного действия или переформулировка запроса | Детект повторов, лимит шагов |
| Дрейф цели | Агент решает смежную задачу | Явное условие остановки и проверка результата |
| Ложное завершение | Агент объявляет успех без результата | Проверка пост-условия кодом |

Дрейф цели особенно заметен в исследовательских агентах: вместо ответа на вопрос
агент начинает собирать всё, что нашёл. Лечится явным критерием готовности,
который проверяет код, а не модель.

## Проверка пост-условия

Самый дешёвый способ стабилизировать цикл — проверять результат детерминированно.
Есть ли обязательные поля, сходится ли сумма, существует ли созданная запись,
непустой ли ответ. Если проверка не проходит, цикл делает ещё один шаг с явным
сообщением об ошибке, а не начинает заново.

Это тот же приём, что валидация схемы в
[«Структурированном выводе»](https://wpcraft.ru/aia/patterns/structured-output.md), только применённый
к состоянию задачи.

## Материалы и источники

- [LangGraph: concepts](https://langchain-ai.github.io/langgraph/concepts/) — состояние, узлы и переходы.