Swarm:
агенты передают управление по контексту

Handoff: управление путешествует

Ключевая идея Swarm — handoff (передача управления). В любой момент активен один агент. Он ведёт диалог, пока задача в его зоне. Как только всплывает то, что лучше сделает коллега, он передаёт эстафету — и теперь активен другой агент, унаследовав весь контекст разговора. Тот, в свою очередь, может передать дальше. Центра нет: решение «кто следующий» принимает сам текущий агент.

Живая аналогия — служба поддержки. Ты попал на оператора общего профиля. Вопрос про биллинг — он переводит тебя на биллинг-специалиста. Тому нужен техотдел — он переводит дальше. Ты всё время говоришь с одним человеком, но кто это — меняется по мере того, как выясняется суть. Никакого «супервайзера-диспетчера» над ними нет; каждый сам знает, кому передать.

Важно: handoff — это полная передача, а не «делегировал подзадачу и жду ответа» (как в Supervisor). Управление уходит целиком; предыдущий агент выбывает из разговора. Контекст (история) при этом сохраняется — новый агент видит всё, что было.

Swarm против Supervisor

Оба про «кто следующий», но принимают это решение по-разному — в этом суть децентрализации.

Как реализуют handoff

Технически handoff чаще всего оформляют как особый инструмент: у агента есть «инструменты-передачи» (transfer_to_billing, transfer_to_tech), и когда модель их вызывает — рантайм переключает активного агента. То есть передача управления — это просто ещё один tool call, только его эффект — не действие в мире, а смена «говорящего».

# Каждый агент знает, КОМУ он может передать управление
def transfer_to_billing():
    return billing_agent          # вернуть агента = передать ему управление

def transfer_to_tech():
    return tech_agent

triage = Agent(
    name="triage",
    instructions="Определи тему и передай профильному агенту.",
    functions=[transfer_to_billing, transfer_to_tech],   # доступные handoff'ы
)

billing = Agent(
    name="billing",
    instructions="Решай вопросы по счетам. Не по теме — верни в triage.",
    functions=[transfer_to_triage, transfer_to_refunds],
)

# Рантайм: пока агент не вызвал handoff — он активен;
# вызвал transfer_to_X → активным становится X, контекст сохраняется
client.run(agent=triage, messages=[{"role": "user", "content": "Верните деньги"}])

Это модель OpenAI Swarm (экспериментальный фреймворк, давший имя паттерну; его продолжение — Agents SDK). Идея переносится и на другие инструменты: в LangGraph handoff выражают через Command(goto=..., graph=...) — узел-агент возвращает команду «перейти к другому агенту», что ровно и есть передача управления в графе. Паттерн один — реализация зависит от инструмента.

Сильные и слабые стороны

Когда брать Swarm

• Маршрутизация запросов: служба поддержки, роутинг обращений по отделам — канонический случай Swarm.
• Зоны ответственности чёткие, а порядок — нет: заранее не известно, к какому специалисту пойдёт разговор, но каждый знает свою область.
• Нужна отказоустойчивость без центра: нет единой точки, чей сбой всё роняет.
• Диалоговые системы: где «говорящий» естественно меняется по ходу беседы.

А не бери Swarm, если нужен строгий контроль и аудит всех решений (→ Supervisor: всё через центр) или порядок фиксирован (→ Pipeline). Swarm — про гибкую децентрализованную маршрутизацию, а не про жёсткие сценарии.

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

Шпаргалка

ПАТТЕРН: децентрализованный handoff — активный агент САМ передаёт
  управление другому по контексту. НЕТ центра. Активен всегда ОДИН.
  топология «сеть» (peer-to-peer) · контекст путешествует с управлением

HANDOFF ≠ ДЕЛЕГИРОВАНИЕ:
  handoff (Swarm)      — управление уходит СОВСЕМ (эстафета)
  делегирование (Sup.) — поручил и ЖДЁШЬ результат обратно

РЕАЛИЗАЦИЯ:
  handoff = особый tool call (transfer_to_X → активен X)
  OpenAI Swarm / Agents SDK · LangGraph: Command(goto=..., graph=...)

SWARM vs SUPERVISOR:
  решает "кто следующий": Swarm — сам агент · Supervisor — центр
  топология: сеть vs звезда · точка отказа: нет vs центр
  контроль: ниже vs выше

✅ нет узкого места · гибкая маршрутизация · простые агенты · поддержка/роутинг
❌ труднее контроль · РИСК handoff-пинг-понга · нет общей картины · отладка

КОГДА: маршрутизация запросов · зоны чёткие, порядок нет · диалоги
НЕ НАДО: нужен строгий контроль → Supervisor · порядок фиксирован → Pipeline

ПРАВИЛА:
  • ЛИМИТ передач (иначе пинг-понг) + критерии "решай сам"
  • чёткие непересекающиеся зоны ответственности
  • контекст сохраняется при handoff

Практическое задание

Собери децентрализованную маршрутизацию:

Что дальше

Supervisor, Pipeline, Swarm — это способы распределить работу. Есть и паттерн, где несколько агентов работают над одним вопросом, но не согласованно, а споря — чтобы в столкновении аргументов родился лучший ответ. Это Debate — следующий урок.