Один кодинг-агент — отличный напарник по программированию. Но когда в задаче несколько видов работы (планирование, написание кода, ревью, тестирование), одному агенту приходится жонглировать. Он теряет план, пока чинит тест, или ревьюит собственный код и не находит ошибок. Команда ИИ-агентов делит эту нагрузку так же, как человеческая: один агент руководит, остальные отвечают за свою роль, и все знают, кому передавать работу.
В этой статье я разбираю, что такое мультиагентная команда на самом деле, когда она оправдывает дополнительную настройку по сравнению с одним агентом или параллельным запуском, и как собрать её в представлении команды AgentVera.
Что такое команда ИИ-агентов
Команда ИИ-агентов — это несколько кодинг-агентов, которые работают над одной целью внутри общей структуры. Именно структура отличает команду от нескольких терминалов, которые просто оказались открыты одновременно. В ней четыре части:
- Менеджер: один агент получает запрос, делит его на части, раздаёт их и проверяет результат.
- Роли: у каждого участника своя работа, например исследователь, разработчик, ревьюер или тестировщик, и инструкции о том, что ему можно трогать, а что нет.
- Линии подчинения: каждый участник кому-то подчиняется. Если вы ничего не задали, он подчиняется менеджеру.
- Передача работы: у участника может быть и фиксированная следующая остановка для готовой работы, например разработчик передаёт ревьюеру, а ревьюер тестировщику.
Агенты общаются напрямую. Тестировщик, который нашёл баг, не ждёт, пока вы скопируете сбой в терминал разработчика, а сам отправляет сообщение.
Когда команда лучше одного агента
Команда тратит больше токенов и внимания, чем один агент, поэтому она должна окупаться. Вот как я выбираю:
| Ситуация | Что подходит | Почему |
|---|---|---|
| Небольшая правка в одном-двух файлах | Один агент | Разделение добавляет накладные расходы, а делить нечего |
| Фича с планированием, кодом, ревью и тестами | Команда агентов | У каждого этапа своя цель, и свежий взгляд помогает |
| Одна большая задача с чётко разделёнными частями | Параллельная команда | Части идут в своих worktree и сливаются в одну ветку |
| Постоянная работа часами или днями | Команда агентов | Команда остаётся открытой и сохраняет роли между задачами |
| Сравнение двух подходов к одной проблеме | Два агента рядом | Нужны независимые ответы, а не координация |
Коротко: берите команду, когда в работе есть разные виды шагов, которым полезны отдельные роли, и когда хочется, чтобы агенты продолжали согласовывать действия по мере изменения задачи. Если нужна просто пропускная способность на независимых кусках, параллельный запуск проще. Об этой стороне я писал в статьях параллельные кодинг-агенты и запуск нескольких агентов Claude Code.
Команда агентов и параллельная команда
Обе есть в AgentVera, и решают они разные задачи:
- Представление команды собирает уже открытых агентов в постоянную команду. Они сохраняют роли, общаются друг с другом и делят список задач и доску.
- Параллельную команду запускает агент под одну задачу. Она делит задачу на до 8 частей, запускает каждую в своём git worktree, сливает готовые части в интеграционную ветку и выполняет итоговую проверку. На этом она заканчивается, а открывать ли pull request, решаете вы.
Они хорошо сочетаются: менеджер команды может запустить параллельную команду, когда одна из его задач достаточно велика для разделения.
Проектирование команды
Перед тем как открывать окна, набросайте команду на бумаге. Большую часть решают три вопроса.
1. Кто руководит?
Менеджером должен стать агент, которому вы больше всего доверяете в планировании. Он читает запрос, разбивает его и решает, кто что делает. Дайте ему инструкции о том, как проверять работу, например «не помечай задачу выполненной, пока тестировщик не прогонит тесты».
2. Какие роли действительно нужны?
Начните с малого. Разработчик, ревьюер и тестировщик под менеджером покрывают большую часть работы над фичами. Исследователя добавьте, если перед кодом нужно читать, а роль документации — если правка затрагивает публичные API. Каждый лишний агент — это ещё один контекст, который нужно заполнить, и ещё одна порция токенов.
3. Куда течёт работа?
Проведите два вида линий:
- Reports to: кто кому подчиняется. Это определяет, к кому агент обращается, когда застрял.
- Hands its work to: следующая остановка для готовой работы. Типичная цепочка: разработчик → ревьюер → тестировщик.
Держите цепочку короткой. Длинная цепочка означает, что небольшая правка ждёт много ходов, прежде чем вам скажут, что она готова.
Сборка в представлении команды AgentVera
Представление команды превращает набросок в рабочую команду. Откройте его по значку команды у группы или в верхней части боковой панели.
Шаг 1: разместите агентов
В окне есть Team structure рядом с пулом Agents in the workspace. Перетащите агентов из пула в структуру или нажмите Open a new agent, чтобы запустить агента под роль, которой ещё нет. Первый агент, которого вы отметите как Manager, возглавит команду. В команде один менеджер и до 24 участников, и каждый участник должен быть агентом проекта группы. Терминальные сессии не включаются.
Если не хочется начинать с нуля, Ready-made teams даёт готовые наборы:
- Software team: техлид с планировщиком, разработчиком, ревьюером и тестировщиком.
- Research team: руководитель исследования с исследователем и автором отчётов.
- Social media team: SMM-менеджер с исследователем трендов, копирайтером, визуальным дизайнером и специалистом по рекламе. Он готовит черновики и спрашивает вас, прежде чем что-то опубликовать или потратить деньги.
Набор сам открывает нужных новых агентов.
Шаг 2: дайте каждому агенту роль
Выберите агента и задайте его Role и Instructions. Ready-made roles подставляют название и инструкции: исследователь, планировщик, разработчик, ревьюер, тестировщик, DevOps, дизайнер, документация и безопасность. У нескольких агентов может быть одна роль, что удобно, когда два разработчика делят фронтенд и бэкенд.
Шаг 3: проведите линии
У каждого участника есть Reports to и Hands its work to. Их можно задать в полях или перетащив одного агента на другого и выбрав «Report to…», «Hand its work to…» или «Swap places with…». Arrange automatically наводит порядок в раскладке. Участник без линии подчинения подчиняется менеджеру, а если вы случайно создали петлю, она возвращается к менеджеру.
Шаг 4: дайте команде инструменты
В Team’s MCP servers вы выбираете серверы, которые получает каждый участник. Каждая роль может добавить свои поверх, например Playwright для тестировщика или дизайнерский инструмент для дизайнера. Агент может отказаться в собственных настройках. Если рекомендованный сервер ещё не установлен, появится предупреждение, и его можно добавить из каталога. Агенты, у которых изменились инструменты, перезапускаются после завершения текущего хода, так что ничего не обрывается посреди задачи. Подробнее об MCP-серверах я рассказываю в статье что такое MCP-сервер.
Шаг 5: сохраните и дайте команде работу
Save and open the team помещает агентов в группу, чтобы они могли писать друг другу и делить список задач и доску. Сохранение ничего не запускает. Работа начинается, когда вы используете Give to the team: запрос по умолчанию идёт менеджеру или любому выбранному агенту. Каждый агент получает вводную о своей роли, и она повторяется только при изменении команды. Если обмен сообщениями между агентами был выключен, он включается.
Наблюдаем за работой команды
Вкладка Team показывает структуру в реальном времени. Работающие агенты светятся, сообщения бегут светом по линиям, а над говорящим агентом появляется облачко. Рядом:
- Team status показывает текущий шаг каждого агента: редактирует, читает, запускает команду, ищет, планирует или пишет сообщение.
- Activity — лента сообщений, работы и событий агентов с фильтрами All, Messages, Work и Agents.
- Tasks — общий список, в который агенты добавляют задачи, берут их и завершают.
- Waiting for you собирает запросы разрешений, которые можно одобрить или отклонить прямо там.
Когда нужно направить команду, Status report просит менеджера кратко сообщить, чем занят каждый агент, что готово и где команда застряла. Когда вы пишете одному агенту, Interrupt and redirect останавливает его текущее дело и сразу передаёт ваше сообщение, а Queue передаёт его, когда текущая работа закончится. Interrupt all после подтверждения прерывает всех работающих агентов.
Как агенты общаются
Под капотом обмен сообщениями между агентами даёт каждому агенту инструменты: посмотреть список остальных, отправить сообщение (при желании дождаться ответа), ответить и работать с общим списком задач. Занятый агент получает сообщение, когда его ход заканчивается, так что никого не прерывают посреди правки. Сообщения помечены как пришедшие от другого агента, а у каждого отправителя есть лимит частоты, чтобы два агента не зациклились. Это работает между разными CLI: Claude Code, Codex, Gemini CLI и остальные пользуются одними и теми же инструментами.
Частые ошибки
- Слишком много агентов в первый день. Пять агентов на мелкой правке тратят большую часть ходов на чтение сообщений друг друга. Начните с трёх и добавляйте роли, когда появится пробел.
- Расплывчатые роли. «Помогай с кодом» — это не роль. Укажите, чем агент владеет, какие папки может менять и что для него значит «готово».
- Нет ревьюера или тестировщика. Команда, где разработчик проверяет сам себя, — это просто один агент с лишними шагами.
- Пересекающееся владение файлами. Два разработчика в одних и тех же файлах будут мешать друг другу. Делите по папкам или пусть менеджер запустит параллельную команду, чтобы у каждой части был свой worktree. См. git worktree для параллельных агентов.
- Работа сразу всем агентам. Пусть её делит менеджер. В этом весь смысл его наличия.
- Игнорирование запросов разрешений. Агент, ждущий разрешения, блокирует всех ниже по цепочке. Следите за панелью внимания.
Чек-лист
- Один менеджер с инструкциями о том, как проверять работу
- У каждой роли есть понятный владелец, зона ответственности и определение «готово»
- Линии подчинения и передачи проведены, цепочка короткая
- Где-то в цепочке есть ревьюер или тестировщик
- MCP-серверы команды и ролей выбраны и установлены
- Первый запрос написан для менеджера, а не для каждого агента
Подводим итоги
Команда ИИ-агентов окупается, когда в работе есть отдельные шаги и вы хотите, чтобы ими занимались агенты, которые продолжают согласовываться без вас в роли почтальона. Структура простая: менеджер, несколько хорошо описанных ролей и короткие линии подчинения и передачи. Начните с малого, понаблюдайте за первым запуском на вкладке Team и уточняйте роли там, где агенты ждут или дублируют друг друга. Если вы предпочитаете мыслить фиксированными этапами, этот подход разобран в статье конвейеры рабочих процессов ИИ-агентов.
AgentVera позволяет собрать команду из уже открытых агентов, какой бы CLI они ни использовали. Можно начать бесплатно и посмотреть тарифы, когда понадобится больше.