Pular para o conteúdo
Voltar para Construa seus primeiros agentes

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.

20 minutos0 de 3 objetivos concluídos

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.

  1. Posição 1: O nó agent envia a tarefa ao modelo.
  2. Posição 2: O modelo responde sem chamadas de ferramenta.
  3. Posição 3: O ToolNode executa get_ticket e adiciona um ToolMessage.
  4. Posição 4: O ToolNode executa list_charges e adiciona um ToolMessage.
  5. Posição 5: O modelo o lê e pede list_charges.
  6. Posição 6: O modelo pede get_ticket.
  7. 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.