Agent Handoffs & State Transfer(Протокол передачі стану між агентами (Handoff))

1. Огляд концепції та системна проблема

У складних інженерних процесах одна модель не може якісно вирішувати всі етапи: планування вимагає філософського міркування, написання коду — суворого знання синтаксису, а код-рев'ю — прискіпливого скептицизму.

Якщо спробувати тримати все в одній довгій сесії, виникає "забруднення персони" (Persona Pollution): модель починає сама хвалити свій код або заплутується у власних суперечливих інструкціях.

Agent Handoff Protocol — це механізм контрольованої передачі "естафетної палички" між автономними сутностями. Як лікарі передають карту пацієнта під час перезмінки, один агент формує концентрований витяг стану та делегує контроль наступному фахівцю.

2. Архітектурна таксономія та ментальна модель

┌─────────────────────────────────────────────────────────────┐
│                 AGENT HANDOFF STATE MACHINE                 │
├─────────────────────────────────────────────────────────────┤
│ AGENT A: ARCHITECT (Explores, Researches, Generates Spec)   │
│   • Generates: specification.md & checklist                 │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ HANDOFF PACKET                   │
│   ┌─────────────────────────────────────────────────────┐   │
│   │ • Previous Agent ID: architect-01                    │   │
│   │ • Goal: Implement API routes according to spec     │   │
│   │ • Key Constraints: Use Zod validation, no any       │   │
│   │ • Artifact Pointers: ["/docs/spec.md"]              │   │
│   │ • Token Budget Remaining: 15,000                    │   │
│   └─────────────────────────────────────────────────────┘   │
│                          │                                  │
│                          ▼                                  │
│ AGENT B: CODER (Fresh Context Window, Reads Spec & Codes)   │
│   • Zero Persona Drift, Clean Attention Scope               │
└─────────────────────────────────────────────────────────────┘

3. Технічний пайплайн та внутрішня механіка

Структура пакета передачі контексту (Handoff Payload):

interface AgentHandoffPacket {
  sessionId: string;
  sourceAgent: string;
  targetAgent: string;
  taskSummary: string;
  resolvedContext: {
    userIntent: string;
    acceptedDecisions: string[];
    rejectedApproaches: string[];
  };
  artifactPaths: string[];
  returnOnCompletion: boolean;
}

• Context Slicing (Нарізка контексту): Замість 50 повідомлень переписки новий агент отримує 300 слів концентрованого брифу, що гарантує максимальну точність фокусування уваги трансформера.
• Idempotency & Replayability: Пакет handoff зберігається у базі даних, дозволяючи в разі аварії перезапустити роботу агента-виконавця без повторного проходження попередніх фаз.

4. Практичні інженерні сценарії в продакшені

01. Конвеєр від клієнтського брифу до деплою

1. Discovery Agent проводить інтерв'ю з користувачем, формує специфікацію та робить handoff до DB Architect Agent.
2. DB Architect Agent створює схему бази даних, міграції та передає керування Backend Agent.
3. Backend Agent генерує сервіси та ініціює handoff до Security Audit Agent.

02. Ескалація на людину (Agent-to-Human Handoff)

Якщо агент натрапляє на проблему, яку не може вирішити після 3 спроб, він формує Handoff Packet для живого інженера у Slack або Discord із точним описом проблеми, логами та двома кнопками вибору подальшої дії.

5. Підводні камені, типові помилки та безпека

• Broken Telephone (Ефект зіпсованого телефона): Якщо агент-ініціатор скорочує контекст занадто агресивно, наступний агент може втратити критичну деталь (наприклад, специфічну версію бібліотеки).
• Orphaned Sessions: Агент передав задачу, але цільовий агент впав із помилкою OOM. Необхідно мати механізм Heartbeat та таймаутів, які повертають задачу диспетчеру у разі мовчання.

6. Стратегічний висновок для інженера 2026 року

Правильно спроєктований Handoff-протокол дозволяє збирати з простих і дешевих агентів системи промислового рівня. Контекстна ізоляція кожного кроку гарантує, що система залишається стабільною навіть на проєктах, які тривають днями чи тижнями.