Архитектуры агентов: ReAct, использование инструментов, планирование

Почему важна архитектура

У вас может быть самая умная модель в мире, но если обернуть её в плохую архитектуру, получится плохой агент. Архитектура определяет, как агент думает, принимает решения и действует. В этом уроке мы рассмотрим три фундаментальных подхода.

ReAct: рассуждение + действие

ReAct (Reasoning and Acting) — наиболее широко используемая архитектура агентов. Принцип прост: модель чередует мышление и действие. Мысль (мне нужно выяснить...) -> Действие (вызов инструмента) -> Наблюдение (просмотр результата) -> Мысль (на основе результата, что дальше) -> Действие...

Task: Find out what framework the project uses and what dependencies it has

Thought: I need to check the project structure. I'll start by reading package.json.
Action: read_file("package.json")
Observation: { "dependencies": { "next": "16.x", "react": "19.x" ... } }
Thought: It's Next.js 16 with React 19. Let me check tsconfig for more info.
Action: read_file("tsconfig.json")
Observation: { "compilerOptions": { "target": "ES2022" ... } }
Thought: I have enough info. The project uses Next.js 16, React 19, TypeScript.
Answer: The project uses Next.js 16 with React 19 and TypeScript...

Преимущества ReAct: прозрачное рассуждение (вы видите, почему агент делает то, что делает), подходит для задач, где план меняется на основе результатов, прост в реализации. Недостатки: может зацикливаться (мысль -> действие -> мысль об одном и том же), каждый шаг стоит токенов/денег, медленнее прямых подходов.

Plan and Execute (план и выполнение)

Альтернативный подход: агент сначала создаёт план всех шагов, затем выполняет их. В отличие от ReAct, где агент думает после каждого шага, здесь он думает в начале и выполняет последовательно.

Task: Add authentication to the application

Plan:
1. Analyze existing app structure
2. Install auth library (next-auth)
3. Create auth API route
4. Add login/logout components
5. Protect existing pages
6. Add tests
7. Run build and verify

Execution:
Step 1: read_file("src/app/layout.tsx") -> OK, got the structure
Step 2: run_command("npm install next-auth") -> OK
Step 3: write_file("src/app/api/auth/[...nextauth]/route.ts") -> OK
...

Преимущества: более эффективен для задач с чёткой процедурой, меньше шагов мышления = меньше затрат, пользователям легче отслеживать прогресс. Недостатки: план может оказаться неверным при выполнении, менее гибкий, чем ReAct, требует достаточного начального контекста.

Tool Use (использование инструментов, Function Calling)

Использование инструментов — не самостоятельная архитектура, а фундаментальный строительный блок всех архитектур агентов. Модель получает описания доступных инструментов и решает, какой использовать. Ключевой момент: модель НЕ выполняет инструмент — она возвращает структурированный запрос (имя инструмента + параметры), а ваш код его выполняет.

# Tool definition for Claude API
tools = [{
    "name": "read_file",
    "description": "Reads the contents of a file at the given path",
    "input_schema": {
        "type": "object",
        "properties": {
            "path": {
                "type": "string",
                "description": "Path to the file"
            }
        },
        "required": ["path"]
    }
}]

# Model decides to use a tool
# and returns: {"name": "read_file", "input": {"path": "src/app/page.tsx"}}
# Your code reads the file and sends the result back to the model

Продвинутые паттерны

Рефлексия

Агент оценивает собственную работу после выполнения задачи и исправляет ошибки. Например: пишет код -> запускает тесты -> тесты падают -> анализирует ошибку -> исправляет код -> запускает тесты снова. Это распространено в агентах для программирования, таких как Claude Code.

Поиск инструментов

Когда у агента есть доступ к сотням инструментов, не все они передаются в контексте. Вместо этого агент сначала ищет релевантные инструменты. Anthropic предлагает Tool Search Tool, который экономит до 85% контекста по сравнению с традиционными подходами.

Параллельные вызовы инструментов

Агент может вызывать несколько инструментов одновременно — например, читать 5 файлов параллельно. Это значительно ускоряет выполнение, особенно для I/O-операций.

Как выбрать архитектуру

• ReAct: когда вы не знаете всех шагов заранее, задача требует исследования или план меняется на основе результатов
• Plan and Execute: когда задача чётко определена, шаги предсказуемы и вы хотите минимизировать затраты
• Гибридный: план в начале, но с возможностью перепланирования после каждого шага — наиболее распространённый подход на практике