Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Agente Orquestrador

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Agente orquestrador é o agente que recebe o objetivo do usuário, decide qual especialista trata cada etapa, repassa o contexto necessário e consolida as respostas num resultado único.

Ele existe por causa do limite de contexto. Um agente generalista diante de um problema abrangente precisa entender de muita coisa num espaço limitado e fica raso, como um pato que nada, voa e cisca sem se destacar em nada. Dividir o problema entre especialistas resolve cada parte com mais precisão, e o orquestrador é quem mantém o objetivo e decide quem faz o quê, como o maestro que indica quando cada seção toca sem tocar ele mesmo.

Sem essa camada, cada agente tenta cobrir o pedido inteiro, o trabalho se repete e o consumo de tokens cresce com respostas longas, pouco úteis e novas tentativas.

O que o orquestrador faz e o que ele não faz

O orquestrador nunca executa ações diretamente. Ele classifica a intenção, delega ao especialista certo e integra o retorno. O prompt dele costuma trazer regras explícitas: coordenar o fluxo, não analisar dados por conta própria e não inventar informação, porque toda análise deve vir dos especialistas.

Dos especialistas, o orquestrador enxerga só o nome e a descrição, não o prompt interno. Por isso a descrição é crítica: quando ela é vaga, o orquestrador encaminha para o subagente errado, e reescrever essa descrição resolve boa parte dos problemas de roteamento. Outras decisões comuns no prompt do orquestrador:

  • tratar saudações ali mesmo, devolvendo ao usuário as opções disponíveis, sem precisar de um agente só para isso;
  • descrever a lógica esperada do fluxo como orientação, não como sequência fixa, para não acionar um revisor antes de haver o que revisar;
  • fixar o formato da resposta final;
  • receber a data e a hora atuais, já que o modelo não sabe que dia é.

A arquitetura recorrente: orquestrador, especialistas e validador

O desenho que mais se repete tem três camadas: um orquestrador na entrada, dois ou mais especialistas por domínio e um Agente Validador que confere a resposta antes da entrega. Um assistente pessoal ligado a um mensageiro, por exemplo, usa um orquestrador e três especialistas (e-mail, calendário e contatos), com cerca de 18 funções de CRUD distribuídas entre eles. Cada especialista recebe no prompt a lista das próprias funções e quando usar cada uma. Outras variações dividem por área de atendimento (técnico, financeiro e um agente geral como rota de escape) ou por área técnica (desenvolvimento, infraestrutura e banco de dados). Algumas versões fecham com um agente sintetizador, que junta o que os especialistas produziram numa resposta só.

A separação também mantém cada contexto limpo: o especialista de e-mail não carrega as funções de calendário que nunca vai usar.

Encadeamento de chamadas entre especialistas

O orquestrador resolve pedidos que exigem mais de um especialista em sequência. Se o pedido é enviar um e-mail a um contato sem informar o endereço, ele aciona primeiro o especialista de contatos para descobrir o e-mail e só depois o especialista de e-mail para enviar a mensagem. Se o endereço já vem no pedido, a busca é pulada. O roteamento pode ter vários saltos (supervisor, especialista, atendente de fechamento) e o contexto precisa sobreviver a cada um. Cada especialista, porém, recebe só o que o orquestrador repassa, não o histórico inteiro da conversa.

Orquestrador, roteador e escolha de modelo

Quando a única tarefa da entrada é devolver um rótulo de intenção, o papel é o de Agente Roteador. O orquestrador vai além: mantém o objetivo ao longo de várias chamadas e consolida o resultado. As formas de combinar agentes (sequencial, paralela, por papéis) estão em Padrões de Orquestração de Agentes, e nenhuma é receita fixa.

Separar a decisão da execução também abre espaço para a escolha de modelo por papel: um modelo mais forte para planejar e coordenar e modelos mais baratos para executar partes simples. Quando o orquestrador erra a classificação e o pedido precisa ser reformulado várias vezes, a causa costuma estar na falta de precisão do prompt, não no padrão.