Перейти к содержимому

Субагенты и расширения

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

Субагент (subagent) работает вспомогательным агентом, которого основной запускает для отдельной подзадачи. У него отдельный контекст, а инструкции, инструменты и права задаёт харнес. Он может вернуть итог, передать промежуточное сообщение или запросить уточнение; доступные способы взаимодействия зависят от инструмента.

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

Изоляция контекста. Главная ценность. Представьте задачу «найди, где в этом большом репозитории обрабатываются платежи». Поиск означает десятки прочитанных файлов, большинство из которых окажутся не теми. Если основной агент делает это сам, весь мусор поиска оседает в его контексте и вытесняет важное. Если ищет субагент, мусор остаётся в его отдельном окне, а основному агенту возвращается три абзаца выжимки: вот нужные файлы, вот как устроен код. Контекст основного агента остаётся самым ценным ресурсом сессии, и субагенты позволяют его беречь: тратить чужой контекст на черновую работу, а свой оставлять на решение.

Параллелизм. Независимые подзадачи субагенты могут выполнять одновременно: пока один проверяет бэкенд, второй смотрит фронтенд, третий читает документацию. Для задач, которые естественно распадаются на независимые куски, это заметно ускоряет работу.

  • «Исследователь». Субагенту поручают разведку: изучить незнакомую часть кодовой базы, разобраться в библиотеке, собрать информацию по документации. Он перелопачивает много материала и возвращает компактный отчёт. Основной агент строит решение на выжимке, а не на сырых файлах.
  • «Ревьюер». После того как основной агент написал код, отдельный субагент со свежим контекстом проверяет результат. Свежесть здесь принципиальна: агент, который сам писал код, разделяет собственные заблуждения о нём, а ревьюер видит только diff и требования, как коллега, которого позвали посмотреть чужой PR. Ревьюеру можно дать собственную инструкцию: чек-лист команды, акцент на безопасность.
  • Параллельные независимые задачи. Несколько однотипных подзадач раздаются нескольким субагентам: обновить одну и ту же зависимость в пяти сервисах, прогнать проверку по списку модулей. Ключевое здесь слово «независимые»: подзадачи не должны редактировать одни и те же файлы и зависеть от результатов друг друга.

Многие харнесы позволяют определять именованных кастомных агентов: вы описываете роль («ревьюер безопасности»), инструкцию и доступные инструменты, и такой агент вызывается по имени, вручную или автоматически, когда основной агент сочтёт нужным.

Отдельный контекст не означает отдельную файловую систему. Перед параллельными правками назначьте каждому агенту свои файлы или рабочую копию, а сборку общего результата поручите одному исполнителю. Для исследователя заранее определите форму ответа: пути, проверенные факты, источники и неопределённости. Для ревьюера сохраняйте запрет на изменение проверяемого результата.

Субагенты входят в более широкий набор механизмов расширения. Основные:

  • Слэш-команды. Сохранённые промпты, вызываемые по короткому имени: /review, /release-notes, /standup. По сути макросы: часто используемая инструкция оформляется один раз и становится доступной всей команде. Хорошо подходят для повторяемых действий, у которых есть понятное имя.
  • Хуки (hooks). Обработчики событий харнеса: например, запуск форматера после правки или проверка запроса перед инструментом. Возможность блокировать действие зависит от события, типа обработчика и обработки ошибок. Хук после выполнения не отменяет уже отправленный запрос. Проверяйте тайм-ауты и поведение при сбое; примеры различий есть в справочнике Claude Code. Критичные ограничения дополнительно закрепляют правами ОС и внешних систем.
  • Плагины. Упакованные наборы расширений: команды, агенты, скилы, хуки, MCP-серверы одним пакетом. Удобный способ распространять командную настройку: новый сотрудник ставит плагин и получает всё окружение сразу.

Вместе с памятью (Память), скилами (Скилы) и MCP (MCP-серверы) это превращает харнес из «умного чата с терминалом» в настраиваемую платформу под процессы конкретной команды.

Оркестрация нескольких агентов: когда оправдана

Заголовок раздела «Оркестрация нескольких агентов: когда оправдана»

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

Когда оправдано:

  • Работа действительно распараллеливается на независимые части: миграция по множеству модулей, проверка большого списка однотипных объектов.
  • Нужен взгляд со свежим контекстом: связка «исполнитель + независимый ревьюер».
  • Черновой работы много, и она забила бы контекст одиночного агента: глубокие исследования с последующей выжимкой.

Когда это лишняя сложность:

  • Задача по силам одному агенту. Один агент с хорошим контекстом почти всегда предсказуемее трёх с плохой координацией.
  • Подзадачи зависят друг от друга. Агенты, параллельно редактирующие связанный код, порождают конфликты и несогласованность; координация съедает весь выигрыш.
  • Вы ещё не отладили работу с одним агентом. Оркестрация умножает и сильные стороны, и проблемы: если одиночный агент у вас регулярно уходит не туда, пять агентов будут уходить не туда в пять раз быстрее.

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

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

Переносите по одному специалисту: сохраните его процедуру в скиле, дайте основному агенту нужные инструменты и повторите эвалы. Сравните качество полного результата, расходы и задержку. Если отдельный контекст нужен для независимого ревью, разграничения доступа или параллельной работы, сохраните эту границу. Запрет в инструкции ревьюеру сам по себе не ограничивает права его инструментов.

Автор учебника: Шахматов Алексей