Przekazanie zadań i transfer stanu między agentami

1. Przegląd koncepcji i problem systemowy

W złożonych procesach inżynieryjnych jeden model nie jest w stanie jakościowo realizować wszystkich etapów: planowanie wymaga filozoficznego rozumowania, pisanie kodu – ścisłej znajomości składni, a code review – skrupulatnego sceptycyzmu.

Próba utrzymania wszystkiego w jednej długiej sesji prowadzi do "zanieczyszczenia persony" (Persona Pollution): model zaczyna chwalić własny kod lub gubi się we wzajemnie sprzecznych instrukcjach.

Agent Handoff Protocol to mechanizm kontrolowanego przekazywania "pałeczki sztafetowej" między autonomicznymi bytami. Podobnie jak lekarze przekazują kartę pacjenta podczas zmiany dyżuru, jeden agent tworzy skoncentrowany wyciąg stanu i deleguje kontrolę kolejnemu specjaliście.

2. Taksonomia architektoniczna i model mentalny

┌─────────────────────────────────────────────────────────────┐
│                 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. Pipeline techniczny i mechanika wewnętrzna

Struktura pakietu transferu kontekstu (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 (Cięcie kontekstu): Zamiast 50 wiadomości z historii czatu nowy agent otrzymuje 300 słów skoncentrowanego briefu, co zapewnia maksymalną precyzję skupienia uwagi transformera.
• Idempotency & Replayability: Pakiet handoff jest zapisywany w bazie danych, umożliwiając w przypadku awarii ponowne uruchomienie pracy agenta wykonawczego bez powtarzania wcześniejszych faz.

4. Praktyczne scenariusze inżynieryjne na produkcji

01. Konwejer od briefu klienta do wdrożenia

1. Discovery Agent przeprowadza wywiad z użytkownikiem, tworzy specyfikację i wykonuje handoff do DB Architect Agent.
2. DB Architect Agent tworzy schemat bazy danych, migracje i przekazuje sterowanie do Backend Agent.
3. Backend Agent generuje usługi i inicjuje handoff do Security Audit Agent.

02. Eskalacja do człowieka (Agent-to-Human Handoff)

Jeśli agent napotka problem, którego nie może rozwiązać po 3 próbach, tworzy Handoff Packet dla żywego inżyniera na Slacku lub Discordzie, zawierający dokładny opis problemu, logi oraz dwa przyciski wyboru dalszego działania.

5. Pułapki, typowe błędy i bezpieczeństwo

• Broken Telephone (Efekt głuchego telefonu): Jeśli agent inicjujący zbyt agresywnie skraca kontekst, kolejny agent może utracić krytyczny szczegół (np. konkretną wersję biblioteki).
• Orphaned Sessions: Agent przekazał zadanie, ale docelowy agent upadł z błędem OOM. Konieczne jest posiadanie mechanizmu Heartbeat oraz timeoutów, które zwracają zadanie dyspozytorowi w przypadku braku odpowiedzi.

6. Strategiczny wniosek dla inżyniera roku 2026

Prawidłowo zaprojektowany protokół Handoff pozwala budować systemy klasy przemysłowej z prostych i tanich agentów. Izolacja kontekstu na każdym kroku gwarantuje stabilność systemu nawet w projektach trwających dni czy tygodnie.