HRBP по подписке × HappyM

Урок 5:
Мультиагентные сценарии

Как раздать одну большую задачу нескольким агентам и собрать результат

01Проблема02Субагенты03Когда звать04Практика
00Где мы

Актуализация: что уже сделано

ШагЛюба
1 · Рабочая папка happym-workspace и Claude Code?
2 · Личная база знаний в Notion и скилл /notion-kb (QA Notion)?
3 · Утренний бриф по расписанию (домашка урока 4)?
4 · Один рабочий процесс, который вы уже делаете с агентом каждую неделю?
сделаноне сделаноещё не отмечено
01Рабочий стол агента
Задача: сверка недостач по инвентаризации с фулфилментом · пример из процессов HappyM

Чем больше подзадач в одной задаче, тем лучше ответ?

8%
голова занята
100
качество ответа
🧠 CLAUDE.md и память
Ответ агента (иллюстрация)

Точный: держит все детали задачи.

⚠
Упс! Решение, которое предложит агент, будет хуже, чем вы ждёте: часть деталей потеряна или достроена от себя.
Подзадачи внутри задачи «сверить недостачи с фулфилментом»
Подзадачи из памяти (Notion, заметки)
⚠
УПС!

Качество решения будет хуже, чем вы ждёте

нажмите, чтобы закрыть
02Где он ошибётся

Почему на большой задаче агент ошибается и выдумывает данные

1

Окно контекста заполняется

Контекст конечен. Чем он длиннее, тем хуже модель вспоминает детали: Anthropic называет это context rot. Спад идёт постепенно, не обрывом.

2

История сжимается

Когда окно почти полное, Claude Code делает compact: остаётся краткая сводка. В документации: детальные инструкции из начала разговора могут потеряться.

3

Детали пропадают, пробелы заполняются

Потеряв деталь, агент способен достроить правдоподобную вместо «не знаю». В аккуратной таблице такая строка выглядит как настоящая.

4

Результат хуже, чем в короткой задаче

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

03Что с этим делать

Решение: раздать задачу разным агентам

Было: один агент держит всё
80%
голова занята
63
качество ответа
📄 договоры📊 акты🔢 пересчёт📏 убыль⚖ возмещение⏳ сроки🔄 пересорт✉ письма

Всё лежит в одном окне: детали теряются, ответ плывёт.

→раздаём по частям
Стало: главный агент и три субагента
18%
главный: план и сводка
…95
качество сводки
Субагент 1 · договор
📄 договоры📏 убыль⚖ возмещение
свой чистый стол
Субагент 2 · пересчёт
📊 акты🔢 пересчёт🔄 пересорт
свой чистый стол
Субагент 3 · проверка
⏳ сроки✉ письма
свой чистый стол
⏱ Работают одновременно, каждый на своей части
↑ Главному приходят три коротких отчёта. Голова свободна, ответ точный.
04Определение

Что такое субагент

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

🧠
Главный агентставит задание текстом, как человеку
→задание
Субагент отдельная копия Claude Code
🪟
Своё окно контекстаНе видит вашу историю и чужую работу. Стол чистый.
📝
Своя инструкцияФайл .claude/agents/имя.md: роль, правила, формат ответа.
🔑
Свои права и модельТолько нужные инструменты и разрешения. Модель можно взять полегче.
→итог
Короткий отчётГлавный получает выжимку, а не всю работу субагента.
04Как это работает

Как задача проходит по этапам

1Вы ставите задачу
2Главный разбирает
3Субагенты работают
4Главный собирает
1

Вы ставите задачу

Одному главному агенту: цель, материалы (договоры, акты) и что считать готовым результатом. Один раз и без деталей работы.

ЗадачаСверить недостачи с фулфилментом по итогам инвентаризации
📄 договоры📊 акты🧾 шаблон сводки✅ что считать готовым
→
🧠
Главный агентдержит цель и план
2

Главный разбирает на части

Делит по естественным границам процесса, а не «один агент на один артикул». Сам ничего не ищет и не считает.

Задача целиком
Условия договораубыль, оценка, срок претензии
Пересчёт актаучёт против факта, пересорт
Проверка и вердиктусловия против цифр, решение
3

Субагенты работают

У каждого своё окно и своя инструкция. Друг друга не видят, поэтому не путают чужие данные.

Субагент 1 · договор
читает договор…ищет допсоглашения…берёт последнюю редакцию…
Субагент 2 · пересчёт
открывает акт…считает учёт минус факт…пересорт — отдельной строкой…
Субагент 3 · проверка
сверяет с условиями…«нет нормы» не пишет как 0%…пишет обоснование…
4

Главный собирает итог

Получает не сотни страниц договора и строк акта, а три коротких отчёта в заданном формате, и собирает из них одну таблицу.

Отчёт 1условия и пункты договора
Отчёт 2недостача или «нет данных»
Отчёт 3вердикт и почему
→
18%
Сводкаодна таблица по фулфилменту · голова главного занята на 18%
05Зачем передавать задачи

Узкая роль: почему субагент работает точнее

.claude/agents/proverka-nedostach.md пример файла субагента
---
1name: proverka-nedostach
1description: пересчитывает недостачу по акту
  одного фулфилмента и сверяет с его договором
4tools: Read, Grep
4model: sonnet
---
2Ты считаешь только недостачу по одному акту.
3Норму убыли и порядок оценки бери из договора.
3Нормы нет? Пиши «нет данных», не 0%.
5Верни: артикул | недостача | пункт договора

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

1
Своя рольЗнает одну работу и не держит чужие правила.
2
Меньше токеновВ окне только своя инструкция и материалы, а не весь процесс.
универсалузкая роль
3
Свои правила на местеПравила записаны там, где нужны: «нормы убыли нет» не равно «0%» лежит у проверки недостач.
4
Нужные права и модельТолько нужные инструменты. Лёгкая модель на рутину, сильная там, где считаются деньги и принимается решение.
5
Конкретный отчёт главномуФормат задан в инструкции: сумма и пункт договора, а не пересказ. Собирать проще.
06Скилл и субагент

Чем скилл отличается от субагента?

Скилл (skill) · отвечает на вопрос «как?»

Инструкция: как делать

Папка с инструкцией (SKILL.md). Агент читает её и выполняет прямо в вашем разговоре, как рецепт, который положили на стол.

Ваша задача+ инструкция навыка+ всё, что читал и делал
Один стол на всех
Субагент · отвечает на вопрос «кто?»

Исполнитель: кому поручить

Отдельная копия Claude Code со своим окном, инструкцией и правами (.claude/agents/имя.md). Получает задание, работает у себя и приносит итог.

Ваша задача← итог на 5 строк
читает, ищет, считает
Свой стол у каждого
СкиллСубагент
КонтекстОбщий, подгружается в ваш разговорСвоё окно
Что видитВесь ваш разговорСвою инструкцию и задание. Не видит вашу историю
ЗапускClaude находит подходящий скиллПо описанию, по @-имени или флагом --agent
Права и модельОтдельных нетСвои инструменты, разрешения и модель
ВозвращаетНичего отдельноИтоговый отчёт главному агенту

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

06Когда что выбирать

Когда звать субагентов, а когда хватит одного агента

✅ Субагенты помогают
Контекст засоряетсяПодзадача выдаёт много материала (больше 1000 токенов), но главному он не нужен.
Части независимыЗадача делится на куски, которые идут параллельно. Выигрыш в охвате, а не в скорости.
Нужна специализацияСвой набор инструментов, свои правила или экспертиза под часть работы.
Работа самодостаточнаЕё можно отдать и получить обратно короткой сводкой.
☝ Хватит одного агента
Много итераций «туда-сюда»Вы уточняете и правите по ходу, каждый шаг опирается на прошлый.
Этапы делят один контекстПланирование, правка и проверка одной вещи. Последовательные шаги и общее состояние.
Небольшая или точечная задачаБыстрая правка, простой поиск факта. Субагент стартует с чистого листа и тратит время на сбор контекста.
Коротко и дёшево важнееКоманда стоит в 3–10 раз больше токенов.
Сколько агентов под задачу: ориентир из исследовательской системы Anthropic
1Простая1 агент, 3–10 вызовов инструментовнапример: поправить строку в таблице
→
2–4Сравнение2–4 субагента по 10–15 вызововнапример: сверить 3–4 фулфилмента
→
10+Широкий ресёрчбольше 10 субагентов с чётко разделёнными роляминапример: все фулфилменты и склады за год
09ИграЧасть 1 · задача 1 из 5
0/5
верных ответов
10Пять паттернов

Пять паттернов: как организовать работу нескольких агентов

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

Как устроено

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

Когда подходит

Задачу легко и чётко разложить на фиксированные подзадачи.

Пример: сверка с фулфилментом (гипотеза)

Договор и допсоглашения → акт инвентаризации → пересчёт недостачи → проверка по условиям (убыль, оценка, срок) → сводка. Если акта нет в папке, цепочка на этом фулфилменте останавливается.

На что смотреть

Ошибка раннего шага тянется до конца. Поставьте проверку между шагами (наш совет).

Сценарий: диспетчер решает, кому передать расхождение из акта

Как устроено

Вход классифицируется и уходит специалисту с отдельной инструкцией и инструментами.

Когда подходит

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

Пример: сверка с фулфилментом (гипотеза)

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

На что смотреть

Ошибка классификации портит всё дальше. Нужен выход «не уверен, спросить человека» (наш совет).

Сценарий: все фулфилменты сразу или спорный расчёт несколько раз

Как устроено

Несколько вызовов работают одновременно. Разделение: независимые части одной задачи. Голосование: одна и та же задача несколько раз, ответы сравниваются.

Когда подходит

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

Пример: сверка с фулфилментом (гипотеза)

Разделение: папки всех фулфилментов ведутся одновременно, у каждого свой субагент. Голосование: спорный расчёт (неоднозначный пункт договора) считают трое независимо и сверяют суммы.

На что смотреть

Расход токенов растёт с числом вызовов. Делите по естественной единице (фулфилмент, договор), а не «один агент на каждый артикул» (наш совет).

Сценарий: «по каким фулфилментам предъявлять претензию», плана заранее нет

Как устроено

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

Когда подходит

Задача сложная, и какие подзадачи понадобятся, заранее не известно.

Пример: сверка с фулфилментом (гипотеза)

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

На что смотреть

Расход трудно предсказать. Задайте лимит числа исполнителей и глубины (наш совет).

Сценарий: расчёт недостачи проверяется по договору

Как устроено

Один вызов создаёт ответ, другой оценивает его и возвращает замечания. Цикл идёт, пока результат не станет приемлемым.

Когда подходит

Есть чёткие критерии оценки, и доработка по кругам реально улучшает результат.

Пример: сверка с фулфилментом (гипотеза)

Один субагент считает недостачу и пишет, на какой пункт опирается, второй сверяет с договором (последняя редакция, норма убыли, «нормы нет» не равно 0%) и возвращает замечания. Это ответ на привычку «не проверяю — доверяю».

На что смотреть

Без чётких критериев оценщику нечего оценивать. Ограничьте число кругов, оценщику права только на чтение (наш совет).

11Два вида параллели

Параллель бывает двух видов

Разделение · делим задачу на части
По очереди
часть 1
часть 2
часть 3
Параллельно
часть 1
часть 2
сборка
часть 3

схема, не замер

Голосование · одну задачу решаем несколько раз
Попытка 1
та же задача
Попытка 2
та же задача
сравнить
Попытка 3
та же задача

Разные «голоса» дают шанс заметить расхождение. К этой идее вернёмся на следующей встрече.

Правило из блога Anthropic
«Декомпозиция идёт по контексту, а не по типу задачи»

Decomposition follows context, not problem type.

Конвейер из ролей «планировщик, исполнитель, тестировщик» тратил больше токенов на координацию, чем на работу. Делите по объектам и по тому, какой контекст нужен, а не «по должностям».

13Как ставить задачу

Расплывчатое задание = пустая трата

Плохо

«Проверь недостачи».

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

Добавляйте по одному и смотрите, что меняется
0/7
Нажимайте кнопки слева: промпт собирается справа.
задание субагенту
Проверь партии.
14Список задач
claude · список задач
Зависимости между задачами

Три идут параллельно, четвёртая ждёт

Список задач не даёт агенту бросить работу на восьмом шаге из десяти. Сборка заблокирована, пока не завершатся все три. При сбое честная сводка показывает дыру, а не прячет её.

иллюстрация механики, не реальный вывод

15Файл субагента
.claude/agents/nedostacha-checker.md---name: nedostacha-checkerdescription: Пересчитывает недостачу по акту ОДНОГО фулфилмента и сверяет с его договором. Вызывать, когда нужно сверить несколько фулфилментовtools: Read, Grep, Globmodel: sonnet---Ты проверяешь ОДИН акт. Вход: акт и договор этого фулфилмента.Ответ строго: фулфилмент / недостача / что признано по договору / срок претензии / вердикт (1 строка).Нет данных? Пиши «нет данных». Не придумывай.
Нажмите на строку

Что здесь важно

Шапка между --- это настройки. Тело ниже становится «головой» субагента. В документации обязательны только name и description.

Шаблон-запрос: 6 полей
Создай субагента <имя>. Роль: <кто он и на что смотрит>. Вход: <что я ему буду давать>. Права: только чтение (+ веб-поиск, если нужен). Ответ строго: <поля>, не больше 5 строк. Если данных нет, пиши «нет данных». Не придумывай.
Три способа создать

1. Попросить Claude Code по шаблону выше. 2. Команда /agents: меню создания и правки. 3. Руками: файл в .claude/agents/ (проект) или ~/.claude/agents/ (все проекты). После ручного файла перезапустите Claude Code.

17Запуск

Пять способов вызвать субагента

claude

иллюстрация, не реальный вывод · вызов через @-имя в новых версиях, проверьте у себя · после ручного файла перезапустите Claude Code

18Цена и время

Одна задача, два решения: что быстрее и дешевле

Задача: сверка недостач с фулфилментом. Один прогон — один фулфилмент за одну инвентаризацию: договор с допсоглашениями и акт. В прогоне 74 шага (10 фрагментов договора, 34 блока артикулов из акта, 30 сверок с условиями). Размер условный.
1234
6прогонов
Один агентхватитSonnet 5.5, всё в одном контексте
Время4 ч
Контекст в конце2,7 млн
Токены (млн)—
Стоимость—
КомандалучшеHaiku 5.5: договор и сверка · Sonnet 5.5: пересчёт акта · Opus 5.5: главный
Время20 мин
Самый большой контекст115 тыс.
у каждого агента окно почти пустое
Токены (млн)—
Стоимость—
Что выгоднее

—

Где лучше результат

У команды: у каждого агента чистый контекст, поэтому детали не теряются (слайд 4). У одного агента контекст выходит за окно 1 млн, начинается сжатие. Цена команды: нужна сборка и проверка результата.

Теория позади

А теперь
к практике

Два субагента-исследователя: ставим, запускаем, сравниваем.

01Установка02Запуск на своём вопросе03Сравнение
P1Практика · задание

Один вопрос, два субагента-исследователя

Вы получите два готовых субагента, запустите оба на своём реальном вопросе и сравните: что даёт быстрый ресёрч, а что глубокий, и сколько это стоит.

ваш вопросОдин реальный вопрос, где нужен внешний факт: например, что изменилось в условиях Wildberries (выплаты, приёмка, комиссии) за последний месяц
→
light-researchбыстрый ресёрч
haikuдо 10 действий2–3 источника
deep-researchглубокий ресёрч с проверкой
sonnetдо 40 действийдо 14 источников
→
вы сравниваетеглубину · минуты · расходы токенов · где источники разошлись
Установка5′
Свой вопрос5′
Запуск обоих12′
Сравнение8′
Итоги3′
P2Практика · что внутри

Чем глубокий ресёрч отличается от быстрого

light-researchdeep-research
МодельЛёгкая (haiku)Сильнее (sonnet)
Объём работыдо 10 действий, до 5 страницдо 40 действий, до 14 страниц
Углы поиска2–3 запроса4–6 разных углов: официальный, практики и обсуждения, критика, свежие данные
Выбор источниковПервые подходящие, ссылка и датаОценивает тип: первичный, пересказ, блог. Первичные важнее SEO-сайтов
ПроверкаОдин быстрый проходТри разные проверки главных утверждений: цитата, поиск противоречия, свежесть и метод
Где ищетВеб (поиск и чтение страниц)Веб, включая публичные обсуждения и форумы. Закрытое (соцсети с входом) не откроет и скажет об этом
Что вернёт2–4 строки, таблица со ссылкамиВыводы с уверенностью, опровергнутое, расхождения источников, пробелы, список источников
На чём это основано
  • Начинать широко, потом сужать. Короткие общие запросы, затем уточнение (Anthropic, исследовательская система).
  • Несколько углов. В системе Anthropic разные подагенты исследуют разные стороны вопроса. У нас deep проходит углы по очереди сам.
  • Качество источников. Ранние агенты Anthropic выбирали SEO-сайты вместо авторитетных источников, пришлось добавить правила выбора.
  • Ссылки на источники у каждого утверждения.
  • Проверяйте сами. Авторы нашли выдуманные ответы на необычных запросах.

Соцсети как источник в описании Anthropic не упомянуты: публичные обсуждения мы добавили как угол поиска сами.

P3Практика · установка

Ставим двух субагентов в свой воркспейс

1

Скачайте архив

⬇ research-subagents.zip

2

Скопируйте папку agents

в .claude/ вашего happym-workspace. Должно получиться .claude/agents/light-research.md и deep-research.md

3

Перезапустите Claude Code

exit, затем снова claude

4

Проверьте

Наберите /agents: оба субагента в списке

терминал

иллюстрация шагов, ваши пути будут другими

Нет в списке: проверьте путь и перезапуск. Это самая частая причина.

P4Практика · запуск

Запускаем оба на одном вопросе

1

Выберите один свой вопрос

Внешний факт или картина по рынку. Без персональных данных и без договоров.

2

Запустите light-research

Запишите: сколько минут ждали и что получили.

3

Запустите deep-research на том же вопросе

Пока он работает, читайте ответ light.

4

Сравните

Глубина, расхождения источников, минуты и токены.

Спросите самого Claude Code

«Прочитай оба файла в .claude/agents/ и задай мне 5 вопросов, чтобы подогнать их под мой процесс.» Потом: «Добавь в light-research список источников, которым мы доверяем».

терминал

иллюстрация, текст и время условные

F2Домашнее задание

Домашка: свой субагент под свою задачу

1

Своя задача

Возьмите сверку недостач с одним фулфилментом: договор с допсоглашениями и акт инвентаризации. Если нужен другой процесс (возвраты и невыкуп по WB, договоры), выберите его, но с однотипными объектами.

2

Свои субагенты

Создайте субагента под эту задачу по пяти правилам: узкая роль, точное описание, минимум прав (только чтение), жёсткий формат ответа, честное «нет данных». Основой можно взять nedostacha-checker со слайда про файл субагента. Второго, «проверяющего», добавьте, если успеете.

3

Вызов и замер

Вызовите по имени на 2–3 фулфилментах. Запишите минуты: вручную против субагента. Сверьте хотя бы одну сумму руками. Принесите цифры на следующую встречу.

Что принести на следующую встречу

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

Урок 5 · HappyM · Субагенты

Вопросы?

Для какой вашей задачи вы создадите первого субагента? Что из сегодняшнего осталось непонятным? Где вам хватит одного агента, а где нужна команда? Какой формат ответа нужен вашему субагенту и как вы проверите его цифры?

HappyM · Урок 5 · Мультиагентные сценарии