Construa seus primeiros agentes · Capítulo 6 de 8
O loop do agente: um agente ReAct mínimo
Um nó de modelo, um nó de ferramentas e uma aresta condicional: o loop inteiro do agente como um grafo LangGraph.
Objetivos
- Avance o agente um superstep por vez até ele responder.A fazer
- Conte quantas vezes o modelo rodou.A fazer
- Coloque a execução em ordem.A fazer
Passo 1 de 4: A leitura
Raciocinar, agir, observar, repetir
ReAct (reason and act, raciocinar e agir) é um padrão para agentes: o modelo lê a conversa e pede ferramentas ou responde. Quando ele pede, seu código executa as ferramentas e adiciona os resultados à conversa, e o modelo lê de novo. O loop termina quando o modelo responde sem pedir uma ferramenta.
O loop como um grafo
No LangGraph o loop são dois nós sobre MessagesAnnotation, o estado que guarda a lista de mensagens. O nó agent chama o modelo, com as ferramentas vinculadas, sobre state.messages e devolve sua resposta. O nó tools é o ToolNode de @langchain/langgraph/prebuilt: ele executa cada chamada de ferramenta do último AIMessage e adiciona um ToolMessage por chamada. Argumentos inválidos viram ToolMessages de erro, como no capítulo 5.
toolsCondition é o router depois do nó agent: ele devolve "tools" quando a última mensagem tem tool_calls e END quando não tem. Uma aresta leva de tools de volta a agent. Esse é o agente inteiro, cerca de 25 linhas.
O LangGraph executa um grafo em supersteps: em cada um, os nós da vez rodam uma vez. Neste grafo só um nó é da vez de cada vez, então cada superstep é a execução de um nó, e graph.stream(input, { streamMode: "updates" }) entrega uma atualização por superstep. Você pode ver o loop girar.
Pronto, e com limite
createReactAgent, em @langchain/langgraph/prebuilt, constrói o mesmo grafo; ele está obsoleto em favor de createAgent, do pacote langchain. Construa-o à mão uma vez e você vai saber o que esses atalhos fazem.
Um loop pode rodar para sempre se o modelo continuar pedindo ferramentas. recursionLimit, na config da execução, limita os supersteps (25 por padrão); quando ele é atingido, o LangGraph lança GraphRecursionError. Experimente um limite de 4 abaixo: esta execução precisa de 5 supersteps.
Passo 2 de 4: Experimente: O loop, um passo por vez
O loop, um passo por vez
Três passos, uma ação cada, e um quarto opcional: envie o chamado T-48213, avance o loop até o agente responder, conte as chamadas ao modelo e depois limite o loop com recursionLimit.
Modo:RealSimuladoReal: o runtime do LangGraph.js, o ToolNode, o toolsCondition e o limite de recursão rodam nesta página. Simulado: o modelo é roteirizado (seu plano é model-script.js, no painel de código) e, na execução passo a passo, só responde quando você clica em Avançar; os dados do chamado são fictícios.
Passo 3 de 4: Verificação
Verificação
Coloque em ordem a execução do chamado T-48213.
Arraste os itens, ou use os botões de seta, para colocá-los em ordem.
- Posição 1: O nó agent envia a tarefa ao modelo.
- Posição 2: O modelo responde sem chamadas de ferramenta.
- Posição 3: O ToolNode executa get_ticket e adiciona um ToolMessage.
- Posição 4: O ToolNode executa list_charges e adiciona um ToolMessage.
- Posição 5: O modelo o lê e pede list_charges.
- Posição 6: O modelo pede get_ticket.
- Posição 7: toolsCondition encaminha para END.
Passo 4 de 4: O que você já sabe fazer
O que você já sabe fazer
- Construir um agente ReAct como um grafo com ToolNode e toolsCondition.
- Acompanhar uma execução mensagem por mensagem com streamMode "updates".
- Explicar por que todo loop de agente precisa de um limite de recursão.