﻿---
title: Агент, ассистент и workflow
description: "Практическая граница между чат-ботом, детерминированным workflow и агентом: по числу решений, которые принимает модель."
---

Разница между ассистентом, workflow и агентом — не в модели и не в модности
термина, а в том, **сколько решений принимает модель во время выполнения**. От
этого зависят предсказуемость, стоимость и тесты.

## Три конструкции

**Ассистент.** Один вызов модели на один запрос пользователя. Модель отвечает
текстом, ничего не делает во внешнем мире. Пример: помощник в редакторе текста.

**Workflow.** Последовательность шагов задана кодом. Модель может участвовать в
отдельных шагах (классифицировать, извлечь, переписать), но маршрут определяет
программист. Пример: «получить заявку → извлечь поля → проверить по CRM →
отправить письмо по шаблону».

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

```mermaid
flowchart LR
  A["Ассистент<br/>1 вызов"] --> B["Workflow<br/>маршрут в коде"]
  B --> C["Агент<br/>маршрут выбирает модель"]
```

## Где проходит граница

Практический критерий: **если можно перечислить все ветки заранее — это workflow.**
Агент нужен, когда число состояний задачи не перечислить: открытый веб-поиск,
разбор произвольного документа, диагностика инцидента, многошаговый диалог с
уточнениями.

Второй критерий — **цена ошибки и повторяемость**. Workflow дешевле тестировать и
проще откатывать: каждый шаг детерминирован. Агент дороже в эксплуатации, потому
что один и тот же запрос может пройти разными путями.

| Свойство | Workflow | Агент |
| --- | --- | --- |
| Маршрут | Задан кодом | Выбирает модель |
| Тестирование | Юнит-тесты шагов | Наборы сценариев и evals |
| Стоимость | Предсказуема | Плавающая, зависит от числа шагов |
| Отладка | По шагам | По трассе решений |
| Когда нужен | Известный процесс | Неизвестное число шагов |

## Типичная ошибка

Агента берут там, где хватает workflow. В результате простая задача «извлечь
поля из письма» получает цикл, инструменты и память, а вместе с ними — плавающую
стоимость и нестабильный результат. В [разборе 07](https://wpcraft.ru/aia/examples/07-github-issue-triager.md)
триаж issue — это по сути классификация, хотя обёрнут в агентную конструкцию.

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

## Гибрид как рабочее решение

В продакшене чаще всего не «агент» и не «workflow», а гибрид: детерминированный
каркас с агентными вставками.

- Получение и валидация входа — код.
- Извлечение и классификация — модель.
- Ветвление по результату — код.
- Свободный поиск или диалог — агент.
- Публикация результата — код с подтверждением.

Такой каркас оставляет предсказуемость снаружи и гибкость внутри, а точки отказа
сосредоточены в предсказуемых местах.

## Что это значит для выбора фреймворка

Если задача — workflow с вставками модели, тяжёлый графовый фреймворк может быть
избыточен: хватит SDK модели и нескольких функций. Если маршрут действительно
динамический, отсутствие состояния и чекпойнтов станет проблемой на второй неделе
эксплуатации. Подробнее — в разделе [«Фреймворки»](https://wpcraft.ru/aia/frameworks.md).

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

- [Anthropic: Building effective agents](https://www.anthropic.com/research/building-effective-agents) — различение workflow и агента.