P. Mafra MendesConversar

Agente coordenador: como um agente de IA chama os outros em sequência

Por Pedro Mafra Mendes · 4 min de leitura

Quando você já tem agentes pequenos, cada um com um objetivo, dá para criar um agente de fechamento que executa os outros em ordem. Ele só avança se a conferência do anterior passou e, se algo falha, avisa e não pula etapa. A ordem precisa estar escrita, senão a IA executa tudo em paralelo.

Por que vários agentes pequenos funcionam melhor que um grande

A tentação de quem começa é escrever um agente gigante que faz tudo: lê a base, analisa, monta a apresentação e escreve o e-mail para a diretoria. Em um documento só, com vinte passos.

Isso costuma dar errado por um motivo prático. Quando o resultado sai ruim, você não sabe onde quebrou. Foi a leitura do dado? A análise? A montagem do deck? Com tudo misturado, cada correção mexe em outra coisa.

A regra que sigo é um objetivo por agente. Em vez de um agente que faz tudo, três agentes pequenos:

  • o primeiro lê a planilha e faz a análise, com conferência dos totais;
  • o segundo pega a análise pronta e monta o deck;
  • o terceiro escreve o rascunho do e-mail com o resumo e o link.

Cada um pode ser testado sozinho. Se o deck saiu feio, você mexe só no segundo. Se o número veio errado, o problema está no primeiro, e o segundo e o terceiro nem precisam ser abertos.

O que o agente de fechamento faz

Com os agentes pequenos funcionando, crio um agente de fechamento que coordena os outros. Ele não faz o trabalho de ninguém; chama cada agente na hora certa e confere se a etapa terminou bem antes de chamar a próxima.

As regras desse agente são poucas e duras:

  • executa os agentes na ordem escrita, um depois do outro;
  • só passa para o próximo se a conferência do anterior passou;
  • se algo falha, avisa quem precisa saber e para ali;
  • nunca pula uma etapa para "adiantar".

A última regra é a que mais protege. Uma IA sem essa instrução, diante de uma etapa que falhou, às vezes tenta seguir com o que tem. Aí o deck é montado em cima de uma análise pela metade, e o e-mail para a diretoria cita um número que não fecha.

Por que a ordem precisa estar escrita

Esse é o erro que mais vejo em quem monta o primeiro agente coordenador. A pessoa escreve "execute a análise, o deck e o e-mail" e acha que a IA vai entender que é uma coisa depois da outra.

Nem sempre entende. A IA pode querer executar tudo em paralelo para ganhar tempo, e o segundo agente começa antes de a análise do primeiro terminar. Ele monta o deck com dado vazio ou com dado de uma rodada antiga, e você só percebe quando abre o arquivo.

Por isso escrevo a sequência de forma explícita no documento do agente de fechamento:

  • passo um: execute o agente de análise e espere a conferência;
  • passo dois: só depois que a conferência do passo um passar, execute o agente do deck;
  • passo três: só depois que o deck estiver salvo, execute o agente do e-mail.

Parece redundante para uma pessoa, mas para a IA é a diferença entre um fluxo que funciona e um que atropela as etapas.

Um gatilho só, três entregas

O resultado prático é que um único gatilho gera todo o pacote. Na segunda de manhã, você dispara o agente de fechamento e ele entrega a planilha analisada, o deck montado e o rascunho de e-mail para a diretoria, cada um conferido antes do próximo começar.

Para um e-commerce, esse desenho serve para o fechamento semanal de venda, para a reunião mensal de estoque ou para o relatório de atendimento. Em todos os casos, a lógica é a mesma: agentes pequenos que fazem uma coisa cada, e um coordenador que segue a ordem e para quando algo não bate.

Repare que o terceiro agente escreve um rascunho, e não manda o e-mail. Quem lê e envia para a diretoria é uma pessoa.

Perguntas frequentes

Quantos agentes um coordenador pode chamar?

Não existe um limite fixo, mas comece com dois ou três. Cada agente a mais é uma etapa a mais para conferir, e é melhor ver o fluxo funcionar curto antes de crescer.

O que acontece se um dos agentes falhar?

O coordenador deve avisar e parar ali, sem pular para a próxima etapa. Seguir com um resultado pela metade contamina tudo o que vem depois.

Preciso de uma ferramenta especial para isso?

Não. O agente de fechamento pode ser um documento com a ordem escrita, chamando os documentos dos outros agentes, como qualquer agente fixo.

Leia também