Agente Roteador
Ir para notas que citam estaAgente roteador é o agente que classifica a solicitação recebida e a encaminha ao agente ou fluxo especializado certo, com um agente geral de fallback para o que não se encaixa.
Ele existe porque agentes especializados são bons justamente por serem estreitos. Um agente cujo prompt só sabe gerar critérios de aceite tenta gerar critérios de aceite para qualquer coisa que receber. O roteador protege esses especialistas: cada um só recebe o tipo de entrada para o qual foi desenhado. É um dos padrões descritos no artigo da Anthropic sobre construção de agentes eficazes (routing), ao lado da paralelização e do loop de validação.
Roteador versus orquestrador
O roteador decide o destino, não gerencia a execução. Ele olha a entrada, escolhe o caminho e sai de cena. O Agente Orquestrador vai além: decompõe o objetivo, delega partes a vários trabalhadores, acompanha o andamento e consolida o resultado. Os nomes se misturam em fóruns (request classifier, router, orquestrador), e um mesmo sistema pode ter as duas peças: um nó que roteia na entrada e, dentro de cada fluxo, um orquestrador ou validador.
O roteamento também pode acontecer entre modelos, não só entre agentes: imagem vai para o agente que trata imagens, texto em português para um modelo bom em português, pedido de código para um modelo especializado em código. Isso conversa com a Seleção de Modelo por Tarefa: um modelo pode gerar bom código e ainda assim entender mal o que o usuário precisa, e o roteador permite usar o modelo mais apropriado em cada etapa.
O caso da receita de bolo e o agente de fallback
Um fluxo em Spring AI recebia uma história de usuário, um agente analisador extraía papel, objetivo e benefício, e um agente gerador produzia de 3 a 5 critérios de aceite no formato Dado/Quando/Então. Com uma história de compras online (salvar os dados de pagamento para finalizar a compra mais rápido da próxima vez), o resultado saiu como esperado. Diante de um pedido de receita de bolo, porém, o gerador produziu critérios de aceite para um suposto produto de bolo: uma Alucinação provocada por um especialista forçando o único formato que conhece.
A correção teve duas partes. Primeiro, um agente geral, com prompt bem mais simples, que dá respostas concisas a qualquer solicitação fora dos fluxos especializados. Depois, um classificador à frente de tudo, que decide se a entrada é história de usuário ou consulta geral. Com isso, o mesmo pedido de receita foi roteado ao fluxo geral e respondido normalmente, com ingredientes e modo de preparo.
Se toda entrada precisa cair em algum especialista, a que não se encaixa vai para o menos inadequado deles e alucina do mesmo jeito. O agente geral é o destino legítimo do que não é especialidade de ninguém.
Como o classificador decide
O classificador devolve uma saída estruturada em JSON com dois campos: o tipo de fluxo identificado e o motivo da escolha. Para a história de compras, o motivo foi o texto descrever uma funcionalidade da perspectiva de um usuário, no molde como/quero/para que. Para a receita, foi o pedido não especificar nenhuma funcionalidade. O critério que define o que é uma história de usuário, escrito no prompt do classificador, pode ser rascunhado com ajuda de um modelo de chat e depois refinado.
No QAssist, o mesmo papel é do nó analisador: ele monta a lista de agentes válidos a partir do registro de agentes, escolhe qual acionar e exige JSON. Se a saída vier fora do formato, o fluxo não avança. Em LangGraph, isso vira uma aresta condicional que liga o nó analisador a todos os agentes cadastrados, e uma regra de negócio complementar impede pular direto para um agente de geração sem antes passar por um de interpretação.
Crescer adicionando fluxos
O padrão é extensível: um fluxo para testes, outro para música, outro para uma aplicação específica, e o geral para o resto. Adicionar um fluxo significa criar o agente especializado e ajustar o classificador para reconhecer o novo tipo de entrada, sem mexer nos fluxos existentes.