Quando um único agente não consegue fazer tudo, você divide o trabalho.
Um agente pesquisa, outro escreve, outro revisa, outro entrega. Cada um especializado, cada um responsável por uma etapa.
O problema é a transição.
Se o agente B não sabe o que o agente A decidiu, descobriu e descartou, ele começa do zero. O trabalho se repete, o erro se acumula e a cadeia quebra exatamente onde deveria conectar.
O padrão de handoff resolve isso. É uma estrutura de prompt que captura o estado completo de um agente antes de encerrar e o entrega de forma legível para o próximo.
Este post explica como funciona, quando usar e como montar o prompt.
1) Por que agentes múltiplos precisam de handoff
Dividir tarefas entre agentes especializados é um padrão que cresce junto com a complexidade dos fluxos de IA.
No paper AutoGen (Wu et al., 2023), a Microsoft mostrou como conversas entre múltiplos agentes LLM permitem resolver tarefas complexas que um único agente não consegue com a mesma qualidade. O experimento cobre desde escrita de código até resolução de problemas matemáticos com agentes colaborando em sequência.
Na prática, as divisões mais comuns são:
- Agente de pesquisa → agente de síntese.
- Agente de triagem → agente de execução → agente de revisão.
- Agente de planejamento → agente de tarefa → agente de relatório.
Em cada transição, há risco de perda de contexto se não existir um mecanismo de transferência explícito.
Sem handoff, o próximo agente precisa reinferir o que já foi decidido — e pode inferir errado.
2) O que precisa ser transferido
Antes de montar o prompt, é preciso entender o que constitui o "estado" de um agente em execução.
Cinco categorias que geralmente precisam ser passadas:
- Objetivo: o que a cadeia como um todo quer alcançar.
- Progresso: o que já foi feito, em qual etapa está.
- Decisões: o que foi escolhido e por quê — incluindo o que foi descartado.
- Bloqueios: o que não funcionou, quais restrições foram encontradas.
- Próximo passo: o que o agente seguinte deve fazer primeiro.
O erro mais comum é transferir só o resultado final, sem o raciocínio. O próximo agente recebe a resposta, mas não sabe o caminho — e ao tomar uma nova decisão, pode contradizer o que já foi resolvido.
3) O prompt de handoff
O handoff é um bloco de texto estruturado que o agente A gera ao final da sua execução, antes de passar o controle.
Estrutura mínima:
## Handoff — [nome do agente] para [nome do próximo agente]
**Objetivo geral da cadeia:**
[descreva em 1-2 frases o que a cadeia completa deve entregar]
**O que foi feito até aqui:**
[lista das ações executadas, em ordem cronológica]
**Decisões tomadas:**
[lista de escolhas feitas e a justificativa resumida de cada uma]
**O que foi descartado e por quê:**
[lista de caminhos tentados e rejeitados — importante para evitar retrabalho]
**Bloqueios e restrições ativas:**
[o que não pode ser feito, o que depende de aprovação, o que falhou]
**Estado atual:**
[onde a tarefa está agora — dado, documento, rascunho, lista, etc.]
**Próximo passo recomendado:**
[instrução objetiva para o agente seguinte começar]
**Contexto adicional relevante:**
[qualquer informação que o próximo agente precisará mas que não está no histórico]
Esse bloco pode ser gerado automaticamente ao final de cada etapa ou solicitado manualmente quando a tarefa passa de um agente para outro.
4) Prompt para o agente gerar o handoff
Em vez de escrever o handoff manualmente, você instrui o agente a gerá-lo como parte do fluxo.
Prompt prático de geração de handoff:
Você concluiu sua etapa desta cadeia de agentes.
Antes de encerrar, gere um bloco de handoff completo para o próximo agente.
O handoff deve conter:
1) Objetivo geral da cadeia (em 1-2 frases).
2) Lista do que foi executado nesta etapa.
3) Decisões tomadas e justificativas resumidas.
4) O que foi tentado e descartado (com motivo).
5) Restrições ativas que o próximo agente deve respeitar.
6) Estado atual do artefato (texto, dados, rascunho, etc.).
7) Instrução objetiva de início para o próximo agente.
Formato: use os cabeçalhos do template de handoff.
Regra: seja preciso. Omitir informação aqui causa retrabalho na próxima etapa.
Esse prompt pode ser fixado no final de qualquer agente que opera em cadeia.
5) Prompt para o agente receber e interpretar o handoff
O agente receptor também precisa saber como consumir o handoff corretamente.
Prompt prático de recepção de handoff:
Você está recebendo o controle de um agente anterior.
O bloco de handoff abaixo contém o estado atual da tarefa.
Antes de agir:
1) Leia o objetivo geral e confirme que entendeu.
2) Identifique o próximo passo recomendado.
3) Verifique as restrições ativas — não repita o que foi descartado.
4) Se houver ambiguidade no handoff, liste as dúvidas antes de começar.
5) Ao concluir sua etapa, gere um novo handoff para o próximo agente.
Handoff recebido:
[cole aqui o bloco gerado pelo agente anterior]
Esse padrão cria um loop contínuo: cada agente recebe contexto, executa, e passa contexto adiante.
6) Exemplo prático: cadeia de pesquisa e redação
Para tornar concreto, veja como o handoff funcionaria em uma cadeia simples de dois agentes.
Agente 1 — Pesquisador:
- Tarefa: buscar dados sobre adoção de IA em pequenas empresas no Brasil em 2025.
- Executa: consulta fontes, filtra dados relevantes, descarta dados sem referência verificável.
- Gera handoff com: fontes usadas, dados encontrados, dados descartados e por quê, instrução para o redator.
Handoff gerado pelo Agente 1:
## Handoff — Agente Pesquisador para Agente Redator
Objetivo geral: produzir artigo sobre adoção de IA em pequenas empresas no Brasil.
O que foi feito: consultadas 6 fontes; selecionadas 3 com dados verificáveis de 2024-2025.
Decisões tomadas: priorizar dados do Sebrae e FGV por relevância e credibilidade local.
Descartado: relatório da McKinsey (dados globais, não segmentados para PMEs brasileiras).
Restrições ativas: não usar dados anteriores a 2023; não fazer afirmações sem fonte.
Estado atual: lista de 4 dados com fonte, ano e citação exata — pronta para usar.
Próximo passo: escrever artigo de 900 palavras usando os dados da lista. Tom: direto e sem jargão.
Com esse handoff, o Agente Redator começa com contexto real — não precisa adivinhar o que foi pesquisado nem repetir a busca.
7) Quando usar e quando não usar handoff
Handoff faz sentido quando:
- A tarefa é longa demais para um único agente processar sem perda de foco.
- Há etapas com habilidades distintas (pesquisa, escrita, revisão, validação).
- O erro em uma etapa afeta todas as seguintes — o handoff serve como checkpoint.
- Você quer rastreabilidade do que cada agente decidiu.
Handoff não é necessário quando:
- A tarefa é curta e cabe em um único contexto de agente.
- O fluxo é linear e sem ramificações — um prompt bem estruturado já resolve.
- O overhead de estruturar o handoff é maior que o benefício de continuidade.
A Anthropic, no guia de construção de agentes eficazes, reforça esse ponto: complexidade de orquestração deve ser proporcional à complexidade da tarefa. Orquestração excessiva em tarefas simples cria custo sem ganho.
8) Conclusão
Agentes múltiplos só funcionam bem quando a transição entre eles é tratada como parte do design, não como detalhe.
O prompt de handoff é o mecanismo que garante essa transição:
- Captura o que foi feito e por quê.
- Evita retrabalho de decisões já tomadas.
- Dá ao próximo agente um ponto de partida real, não um recomeço.
Quando você automatiza esse padrão — cada agente gerando e consumindo handoffs como parte do fluxo — a cadeia passa a operar com consistência, independentemente de quantas etapas tem.
Leia também:
Conheça o meuOpenClaw: https://meuopenclaw.cloud/contratar