Transferência de Estado e Handoffs de Agentes

1. Visão Geral do Conceito e Problema Sistêmico

Em processos de engenharia complexos, um único modelo não consegue resolver com qualidade todas as etapas: o planejamento exige raciocínio filosófico, a escrita de código demanda conhecimento rigoroso da sintaxe, e a revisão de código requer ceticismo minucioso.

Se tentarmos manter tudo em uma única sessão longa, surge a "Poluição de Persona" (Persona Pollution): o modelo começa a elogiar seu próprio código ou se confunde em suas instruções contraditórias.

O Agent Handoff Protocol é um mecanismo de transferência controlada do "bastão de testemunho" entre entidades autônomas. Assim como médicos transferem o prontuário do paciente durante a troca de turno, um agente gera um extrato concentrado do estado e delega o controle ao próximo especialista.

2. Taxonomia Arquitetural e Modelo Mental

┌─────────────────────────────────────────────────────────────┐
│                 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 Técnico e Mecânica Interna

Estrutura do Pacote de Transferência de Contexto (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 (Fatiamento de Contexto): Em vez de 50 mensagens de chat, o novo agente recebe um briefing concentrado de 300 palavras, garantindo máxima precisão no foco da atenção do transformer.
• Idempotency & Replayability: O pacote de handoff é armazenado no banco de dados, permitindo que, em caso de falha, o trabalho do agente executor seja reiniciado sem repetir as fases anteriores.

4. Cenários Práticos de Engenharia em Produção

01. Esteira do Briefing do Cliente até o Deploy

1. O Discovery Agent realiza a entrevista com o usuário, formula a especificação e executa o handoff para o DB Architect Agent.
2. O DB Architect Agent cria o schema do banco de dados, migrações e transfere o controle para o Backend Agent.
3. O Backend Agent gera os serviços e inicia o handoff para o Security Audit Agent.

02. Escalation para Humano (Agent-to-Human Handoff)

Se o agente encontrar um problema que não consegue resolver após 3 tentativas, ele forma um Handoff Packet para um engenheiro humano no Slack ou Discord, com descrição exata do problema, logs e dois botões para escolha da próxima ação.

5. Armadilhas Comuns, Erros Típicos e Segurança

• Broken Telephone (Efeito Telefone Sem Fio): Se o agente iniciador resumir o contexto de forma muito agressiva, o próximo agente pode perder um detalhe crítico (por exemplo, uma versão específica de biblioteca).
• Orphaned Sessions: O agente transferiu a tarefa, mas o agente alvo caiu devido a erro de OOM. É necessário ter um mecanismo de Heartbeat e timeouts que devolvam a tarefa ao dispatcher em caso de silêncio.

6. Conclusão Estratégica para Engenheiros em 2026

Um protocolo de Handoff bem projetado permite construir sistemas de nível industrial a partir de agentes simples e baratos. O isolamento de contexto em cada etapa garante que o sistema permaneça estável mesmo em projetos que duram dias ou semanas.