Agente Orquestrador
Ir para notas que citam estaAgente 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.