Aresta Condicional
Ir para notas que citam estaAresta condicional é a ligação do LangGraph cujo destino não é fixo: uma função lê o estado do grafo e devolve o nome do próximo nó a executar.
Numa aresta comum, terminar um nó significa passar obrigatoriamente ao nó seguinte. Isso basta para fluxos em linha reta, mas não para um Grafo de Agentes em que a mensagem do usuário pode pedir coisas diferentes. A aresta condicional é o ponto em que o grafo bifurca: funciona como um switch ou um if, e é a forma como o roteamento por intenção de um Agente Roteador vira código. O roteador classifica; a aresta condicional lê essa classificação e escolhe o caminho.
Por que o fluxo fixo não basta
Com um identificador de intenção e um agente de saudação ligados por aresta fixa (início, identificador, saudação, fim), qualquer mensagem termina na saudação, seja um cumprimento, uma dúvida técnica ou um pedido de código. O identificador até classifica corretamente, mas ninguém consome a classificação. E com um único destino possível não há como perceber diferença entre fluxo fixo e condicional, mesmo enviando mensagens de tipos diferentes. Por isso demonstrar o desvio exige pelo menos um segundo destino real, como um agente de esclarecimento de dúvidas.
Como a aresta é montada
No lugar do add_edge que saía do identificador entra add_conditional_edges, que recebe o nó de origem e a função de decisão. Essa função segue o mesmo formato dos nós de agente: recebe o estado, lê a chave em que o identificador gravou sua resposta e guarda a intenção numa variável. A partir daí, um match/case do Python, o equivalente ao switch, associa cada valor possível a um destino: saudação leva ao nó de saudação, dúvida leva ao nó de consulta de dúvidas.
Os valores comparados no case são exatamente as opções válidas definidas no prompt do identificador; no projeto de exemplo, saudação, dúvida e código. Prompt do classificador e função de decisão formam um contrato: se o prompt passa a aceitar uma nova categoria, a função precisa de um novo case e o grafo precisa de um nó para recebê-la.
O retorno é o nome do nó
A função não devolve uma função Python nem um objeto, e sim o identificador dado ao nó no add_node. O LangGraph usa esse nome como um ID. Se outro nó tivesse o identificador retornado, o fluxo seguiria para ele, qualquer que fosse a função Python executada lá dentro.
Daí vem o risco principal: um retorno que não corresponde a nenhum nó registrado não leva a destino válido. A proteção é o caso padrão.
Sem um caso padrão, uma intenção não mapeada fica sem rota. A escolha adotada é retornar END, encerrando o grafo em vez de deixá-lo sem saída ou rodando indefinidamente. Enquanto o agente de código ainda não existe, um pedido de código cai justamente nesse padrão e a execução termina sem resposta de especialista.
O que acontece depois do desvio
Cada ramo escolhido pela aresta condicional segue com arestas comuns até o fim. Numa versão mais completa do mesmo projeto, três caminhos saem do identificador: saudação e fim; consulta de dúvidas, validador e fim; gerador de plano de código, gerador de código, avaliador de código e fim. Inserir um nó no meio de um ramo significa redirecionar a aresta que ia ao fim para o novo nó e criar outra aresta dele em diante. Quanto mais categorias o identificador reconhece, maior fica o leque de destinos da aresta condicional.