Как собрать handoff-шину
для команды AI-агентов

Почему команда агентов «забывает» задачу на следующей смене

Вы открыли второй чат с AI-агентом — и он снова спрашивает бриф, снова ищет факты, снова предлагает то, от чего вы уже отказались. Это не «глупая модель». Это отсутствие шины передачи работы.

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

Где рвётся контекст: чат, файл, голова оператора

Контекст теряется в трёх местах.

1. Чат. Длинная переписка раздувается. Новая сессия стартует «с нуля» или с кривым кратким пересказом.
2. Файл. Один общий HANDOFF.md, который перезаписывают двое подряд: побеждает последний (last-write-wins). Второй агент «не видел» правки первого.
3. Голова оператора. Вы сами стали маршрутизатором: копируете куски из одного окна в другое и надеетесь, что ничего не выпало.

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

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

Мультиагентная система без шины — это очередь хаоса

Мультиагентная система — это несколько AI-агентов (или сессий с разными ролями), которые делят одну большую работу. Без шины получается так:

• исследователь дописал факты в чат, копирайтер их не увидел;
• два агента одновременно правят один бриф;
• «готово» ставит тот же агент, который писал текст;
• человек узнаёт о блокере только когда уже сорван дедлайн публикации.

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

Что такое handoff-шина простыми словами

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

Handoff-шина — это набор правил и файлов (или доски), через которые роли обмениваются состоянием работы, а не сырым диалогом. Шина отвечает на вопрос: «Что должен знать следующий агент, чтобы продолжить без вас?»

Три слоя: роли → доска задач → эскалация

Минимум, без которого «команда агентов» остаётся театром одного актёра:

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

Маркер: простыми словами. HITL (Human-in-the-loop) — человек в контуре: агент не принимает рискованное решение сам, а кладёт его в очередь человеку с кратким брифом «что решить».

Оркестрация агентов без этих трёх слоёв обычно сводится к одному «супер-промпту» и ручному копипасту. Агентные системы живут дольше одной сессии именно потому, что состояние вынесено наружу.

Чем шина отличается от «просто промпта следующему агенту»

В открытых кейсах с командами coding-агентов протокол ролей и эскалации чаще кормят хуками и файлами, а не одним гигантским системным промптом. Для контент-команды вывод тот же: не пихайте весь пайплайн в «ты теперь директор», а держите контракты снаружи.

В официальной оркестрации OpenAI Agents SDK есть два режима: handoffs (специалист забирает ownership ответа) и agents as tools (менеджер остаётся владельцем и вызывает специалистов). Шина файлов/доски — соседний практический слой: она нужна, когда роли живут днями и меняют сессии.

Маркер: простыми словами. Ownership — «кто сейчас отвечает за ответ». При handoff ownership переходит; при «агент как инструмент» ownership остаётся у менеджера.

Доска задач как единый источник правды

Доска — место, где видно: что open, что done, кто ждёт кого. Без неё вы снова маршрутизируете руками.

На практике встречаются три семейства транспорта (выбирайте по топологии, не по моде):

1. Blackboard / доска — сеть «любой → любому», секции ролей в одном markdown/store. Удобно, когда именованные роли живут долго и работают параллельно.
2. Вахтовый журнал (TRACKS + handoff-файл на трек) — индекс живых треков + рецепт контекста для следующей сессии. Удобно при частой смене задач.
3. Email-протокол + locks — append-only письма между сессиями и блокировки на общий ресурс. Нужен, когда много параллельных окон бьются за один файл.

Маркер: простыми словами. Append-only — «только дописывать, не затирать». Каждый handoff — новый файл или новая запись, чтобы второй агент не стёр первого.

Маркер: простыми словами. Lock (лок) — временный «занято» на ресурсе: пока один агент правит страницу или бриф, второй не лезет в тот же файл.

Минимальный шаблон карточки: цель, вход, выход, статус, блокер

Скопируйте в Notion, Google Docs, Obsidian или обычный .md в репозитории:

TASK-014 | Собрать SEO-ядро по теме X
- from: исследователь → to: копирайтер
- status: open | in_progress | done | blocked | escalated
- цель: ...
- вход: ссылки / бриф / запреты
- выход (контракт): таблица ключей + H2/H3 + meta
- блокер: нет / описание
- не перерешивать: уже отвергнутые углы
- первый шаг для следующего: ...

Статусы держите жёсткими. «Почти готово» — не статус, а приглашение к хаосу.

Вахтовый журнал: что обязан оставить уходящий агент

Handoff — не дневник чувств. Это контракт со следующей сессией. Минимум секций:

• Задача и метод — что делали и по какому правилу.
• Сделано / осталось — без воды.
• Загрузить — какие файлы открыть.
• Не грузить целиком — анти-список, чтобы не засорять контекст.
• Не перерешивать — решения, которые уже закрыты.
• Первый шаг — куда ткнуть курсором сразу после старта.
• Не сработало — самая ценная секция: чтобы следующий не наступил на те же грабли.

Архитектура мультиагентных систем для новичка начинается не с «фреймворка», а с дисциплины: один трек — один актуальный handoff; закрытый трек уходит в короткую спеку, а не копится кладбищем мёртвых файлов.

Пошаговая сборка шины с нуля

Ниже — контур, который новичок из РФ может собрать за вечер на markdown + любой привычный чат с агентом (Cursor, Claude, ChatGPT и т.п.). Оплата зарубежных подписок из России иногда нестабильна: если сервис недоступен, ту же схему держите в локальных файлах репозитория / Google Docs / Notion и отдавайте артефакты руками между ролями.

Шаг 1–3: контракты ролей, файл обмена, статусы

Признак успеха после шагов 1–3: вы можете открыть доску и за 30 секунд сказать, кто что ждёт и какой файл является «правдой».

Шаг 4–6: параллельные пары, склейка, QA-петля

Признак успеха после шагов 4–6: следующий агент стартует с одного файла/карточки и не спрашивает «а где бриф?».

Типичные ошибки новичка

1. Один общий HANDOFF.md на всех → last-write-wins. Решение: секции ролей или append-only файлы на сессию.
2. Эскалация в чат окна → человек не видит очередь. Решение: секция HITL на доске.
3. «Проверь, что всё хорошо» → self-confirm. Решение: явная задача «опровергни / найди 3 риска».

Так вы по сути создаёте не «магического ИИ-агента», а маленькую мультиагентную систему с оркестрацией ownership — даже если «агенты» пока запускаете вы вручную.

Чеклист запуска и типовые поломки

Перед запуском на боевой контент пройдитесь по списку.

Чеклист запуска

• Есть реестр ролей с «можно / нельзя»
• Есть одна доска (или TRACKS-индекс), а не пять чатов «как источник правды»
• У каждой карточки контракт выхода
• HITL-очередь отдельной секцией
• На критичных шагах QA ≠ исполнитель
• Запрет перезаписи чужого handoff без append/секций
• Для общего ресурса (бриф, прод-страница) продуман lock или «только одна роль пишет»

Дубли блоков, потеря маркеров, «тихий» пропуск роли

Частые поломки мультиагентных систем:

• Дубли блоков — два агента сдали «финальный» текст; склейка не назначена.
• Потеря маркеров — следующий этап не видит статус / from→to / контракт выхода.
• Тихий пропуск роли — «давай сразу публиковать», хотя research/QA не закрыт.
• Self-confirm — агент подтверждает сам себя.
• Перегруз system prompt — правила растут в промпте вместо файлов и хуков.

Какая проблема часто возникает у мультиагентных систем? Потеря согласованного состояния и гонки за один ресурс. Лечится доской + контрактами + запретом last-write-wins.

Как проверить, что handoff читает следующий агент, а не человек-переводчик

Тест на 10 минут:

1. Закройте чат роли A.
2. Откройте чистую сессию роли B.
3. Дайте только доску/handoff-файл — без устных пояснений.
4. Если B задаёт вопросы, ответы на которые уже должны быть в артефакте — шаблон дырявый. Допишите секции и повторите тест.

Пример мультиагентной системы «на минималках» для контента: исследователь → копирайтер → QA → публикатор, четыре секции на доске, HITL на факты и прод.