Router: envie solicitações para o especialista certo
O roteador classifica a intenção e escolhe um ramo especializado.
O que você aprenderá
- Explique: um fluxo de trabalho tem estrutura explícita
- Aplique a ideia em um exemplo: Roteador: envie solicitações para o especialista certo
- Reconheça as limitações e verifique o resultado do exercício
O roteador classifica a intenção e escolhe um ramo especializado. Ele se enquadra em categorias distintas onde uma filial pode resolver a solicitação.
Estas etapas referem-se aos recursos identificados no código do aplicativo. Este material não foi validado em uma instância ativa; verifique a documentação e as opções da sua versão.
Como funciona, passo a passo
Um fluxo de trabalho tem estrutura explícita
Um nó é um estágio, uma aresta é uma transição e o estado carrega resultados entre os estágios. Um fluxo de trabalho possui um caminho definido pelo aplicativo, embora o modelo possa escolher algumas ramificações. Os sistemas agênicos incluem fluxos de trabalho e agentes de ação dinâmica. Nymrio oferece ReAct, Reflexão, Sequencial, Orquestrador, Roteador, Paralelo e Planejar e Executar. Cada um muda de coordenação; isso não torna automaticamente um modelo um especialista. Mais agentes significam mais chamadas e contratos entre funções. Comece com a solução mais simples que passa nos testes.
Uma instrução é um contrato
Um bom prompt especifica a tarefa, os dados disponíveis, o formato de saída e os critérios de sucesso. Separe a função dos dados e inclua um exemplo para casos ambíguos. “Seja preciso” é mais fraco do que “indique apenas o prazo na apólice fornecida; se faltar, peça esclarecimentos”. Poucas fotos significam alguns exemplos resolvidos, não uma lista interminável. O conteúdo do documento permanece como dados mesmo quando contém comandos. Os delimitadores ajudam, mas o software deve impor permissões e validação em vez de depender do prompt.
Defina o sucesso antes de otimizar
Prepare solicitações representativas e respostas ou propriedades esperadas. Inclui casos comuns, ambiguidade, dados faltantes e erros de ferramentas. Para RAG, meça a recuperação de evidências separadamente da correção da resposta. Recall@k mede a parcela de evidências relevantes encontradas nos primeiros k resultados; Precision@k mede a parcela de resultados retornados que são relevantes. Para agentes, rastreie também ações, permissões e paradas. Um LLM como juiz pode acelerar a avaliação, mas precisa de calibração em humanos. Não altere prompt, modelo e índice simultaneamente se quiser entender o que melhorou os resultados.
Laboratório detalhado
Classificação antes da delegação
Instrução ilustrativa do roteador: "Entrega para envio; produto para recursos e compatibilidade; devoluções para política de devolução. Se várias intenções não puderem ser resolvidas em uma filial, peça esclarecimentos." Os trabalhadores usam prompts e fontes especializadas.
Paráfrases de teste: “Onde está meu pacote?” e “Meu pacote não chegou” devem expressar a mesma intenção. Teste também uma solicitação não descoberta: “Preciso de uma fatura”. Não escolha automaticamente o primeiro ramo. Na implementação local o trabalhador selecionado responde e a execução termina; não assuma um retorno ao roteador como no Orchestrator.
O esquema explicativo
Siga as setas sólidas para o fluxo principal. As setas azuis tracejadas fornecem dados ou contexto; setas rosa tracejadas mostram feedback ou retorno de resultados. Cores e formas distinguem modelos, lojas, decisões e resultados. O roteamento seleciona um especialista; os três ramos são alternativos e não trabalhadores simultâneos. Em telas pequenas, role na horizontal para acompanhar o esquema completo.
Um exemplo completo
“Onde está meu pacote?” vai para entrega; “Como faço para instalar a peça?” vai para o suporte técnico. “Quero um retorno e uma parte nova” precisa de esclarecimento ou de uma arquitetura coordenada.
router: LunaDispatcher
route_1: DeliverySpecialist
route_2: TechnicalSpecialist
Experimente você mesmo
- Prepare dez solicitações e justifique cada rota selecionada.
- Registre a entrada, a fonte e o resultado esperado antes de executar o experimento. Use apenas os dados fictícios do exemplo.
- Siga as etapas do diagrama. A cada passo registre quais informações são recebidas e produzidas; não confunda o resultado intermediário com o resultado final.
- Repita após remover as informações necessárias ou tornar a entrada ambígua. Verifique se o sistema esclarece, interrompe ou inventa uma resposta.
- Compare com a solução explicada. Guarde a configuração, data, resultado e explicação das diferenças. Mude uma coisa e teste novamente.
Uma solução explicada
A rota corresponde à intenção; solicitações ambíguas não são impostas a um especialista inadequado. Um exercício bem-sucedido permite mostrar a conexão entre entradas, etapas e resultados. Quando falta informação, uma resposta cautelosa é mais útil do que detalhes inventados. Compare mais do que estilo: verifique também as condições, fontes e operações.
Quando esta abordagem ajuda e quais são seus limites
A validação local da UI e da API difere na nomenclatura do roteador/supervisor; se a poupança for rejeitada, use o exercício conceitual e relate o problema. Escolha esta abordagem quando ela melhorar uma necessidade medida. Mantenha uma linha de base simples e compare os resultados usando dados idênticos. Um exemplo de sucesso não estabelece confiabilidade em todas as situações.
Verifique o que aprendeu
O multiagente é um oitavo modelo?
Não. É uma categoria arquitetônica que pode utilizar diversos templates existentes.
Um prompt pode substituir o controle de acesso?
Não. Uma instrução não é um limite de autorização.
Que resultado este exercício deve produzir?
A rota corresponde à intenção; solicitações ambíguas não são impostas a um especialista inadequado.
Termos para lembrar
- Acenar: Um estágio em um gráfico de execução.
- Poucos tiros: Exemplos resolvidos fornecidos no contexto.
- Regressão / Regressão: uma alteração que quebra um caso anteriormente correto.
Fontes e sua próxima etapa
Para preparar: W05 — Orquestrador: coordenador e especialistas