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

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

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

01Проблема02Субагенты03Когда звать04Практика
01Рабочий стол агента
Задача: сверка недостач по инвентаризации с фулфилментом · пример из процессов HappyM

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

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

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

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

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

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

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

1

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

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

2

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

Когда окно почти полное, агент сжимает историю: остаётся краткая сводка. Детальные инструкции из начала разговора могут потеряться.

3

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

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

4

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

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

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

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

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

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

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

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

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

🧠
Главный агентставит задание текстом, как человеку
→задание
Субагент отдельный поток Codex
🪟
Свой контекстРаботает в своём потоке и не тащит за собой чужую работу. Стол чистый.
📝
Своя инструкцияФайл .codex/agents/имя.toml: роль, правила, формат ответа.
🔑
Своя модель и усилиеЛёгкую модель на рутину, сильную на расчёты. Права те же, что у главного агента.
→итог
Короткий отчётГлавный получает выжимку, а не всю работу субагента.
04Как это работает

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

.codex/agents/proverka_nedostach.toml пример файла субагента
1name = "proverka_nedostach"
1description = "пересчитывает недостачу
  по акту одного фулфилмента"
4model = "gpt-6.1-sol"
4model_reasoning_effort = "medium"
developer_instructions = """
2Ты считаешь только недостачу по одному акту.
3Норму убыли бери из договора.
3Нормы нет? Пиши «нет данных», не 0%.
5Верни: артикул | недостача | пункт договора
"""

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

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

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

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

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

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

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

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

Отдельный поток Codex со своим контекстом и инструкцией (.codex/agents/имя.toml). Получает задание, работает у себя и приносит итог.

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

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

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%) и возвращает замечания. Это ответ на привычку «не проверяю — доверяю».

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

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

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

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

Плохо

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

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

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

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

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

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

17Запуск

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

codex
18Цена и время

Одна задача, два решения: что быстрее и расходует меньше

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

—

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

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

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

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

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

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

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

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

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

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

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

Просим агента подключить двух субагентов

1

Скачайте и распакуйте архив

⬇ research-subagents.zip

2

Передайте агенту папку

Укажите путь к распакованной папке research-subagents и вставьте запрос из блока справа

3

Агент подключает и проверяет

Кладёт файлы в .codex/agents/, запускает light_research на простом вопросе и отчитывается

4

Не сработало?

Откройте новую сессию в папке проекта и проверьте, что проект доверенный

терминал

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

Распакованная папка с двумя субагентами лежит здесь: <путь>/research-subagents. Подключи их к этому проекту: файлы из agents/ должны оказаться в .codex/agents/. Потом проверь, что они работают: запусти агента light_research на вопросе «какая сегодня дата?». deep_research не запускай, только убедись, что он виден. Если что-то не сработало, скажи, что именно (папка, доверенный проект, новая сессия). Больше ничего не меняй.
P4Практика · запуск

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

1

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

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

2

Запустите light_research

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

3

Запустите deep_research на том же вопросе

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

4

Сравните

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

Спросите самого Codex

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

терминал

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

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

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

1

Своя задача

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

2

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

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

3

Вызов и замер

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

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

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

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

Вопросы?

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

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