Saltar al contenido
Volver a Construye tus primeros agentes

Construye tus primeros agentes · Capítulo 6 de 8

El ciclo del agente: un agente ReAct mínimo

Un nodo de modelo, un nodo de herramientas y una arista condicional: el ciclo entero del agente como un grafo de LangGraph.

20 minutos0 de 3 objetivos hechos

Objetivos

  • Avanza el agente un superstep a la vez hasta que responda.Pendiente
  • Cuenta cuántas veces se ejecutó el modelo.Pendiente
  • Ordena la ejecución.Pendiente

Paso 1 de 4: La lectura

Razonar, actuar, observar, repetir

ReAct (razonar y actuar) es un patrón para agentes: el modelo lee la conversación y o bien pide herramientas o bien responde. Cuando pide, tu código ejecuta las herramientas y agrega sus resultados a la conversación, y el modelo vuelve a leer. El ciclo termina cuando el modelo responde sin pedir ninguna herramienta.

El ciclo como grafo

En LangGraph el ciclo son dos nodos sobre MessagesAnnotation, el estado que contiene la lista de mensajes. El nodo agent llama al modelo, con las herramientas vinculadas, sobre state.messages y devuelve su respuesta. El nodo tools es ToolNode de @langchain/langgraph/prebuilt: ejecuta cada llamada a herramienta del último AIMessage y agrega un ToolMessage por llamada. Los argumentos inválidos se convierten en ToolMessages de error, como en el capítulo 5.

toolsCondition es el router después del nodo agent: devuelve "tools" cuando el último mensaje tiene tool_calls y END cuando no tiene. Una arista lleva de tools de vuelta a agent. Ese es el agente entero, unas 25 líneas.

LangGraph ejecuta un grafo en supersteps: en cada uno, los nodos que tocan se ejecutan una vez. En este grafo solo toca un nodo a la vez, así que cada superstep es una ejecución de un nodo, y graph.stream(input, { streamMode: "updates" }) entrega una actualización por superstep. Puedes ver girar el ciclo.

Listo para usar, y con límite

createReactAgent de @langchain/langgraph/prebuilt construye el mismo grafo; está obsoleto en favor de createAgent del paquete langchain. Constrúyelo a mano una vez y sabrás qué hacen esos atajos.

Un ciclo puede seguir para siempre si el modelo sigue pidiendo herramientas. recursionLimit en la config de la ejecución limita los supersteps (25 por defecto); cuando se alcanza, LangGraph lanza GraphRecursionError. Prueba abajo un límite de 4: esta ejecución necesita 5 supersteps.

Paso 2 de 4: Pruébalo: El ciclo, un paso a la vez

El ciclo, un paso a la vez

Tres pasos, una acción cada uno, y un cuarto opcional: envía el ticket T-48213, avanza el ciclo hasta que el agente responda, cuenta las llamadas al modelo y luego limita el ciclo con recursionLimit.

Modo:RealSimuladoReal: el runtime de LangGraph.js, ToolNode, toolsCondition y el límite de recursión se ejecutan en esta página. Simulado: el modelo sigue un guion (su plan es model-script.js, en el panel de código) y, en la ejecución paso a paso, solo responde cuando pulsas Avanzar; los datos del ticket son ficticios.

Paso 3 de 4: Comprobación

Comprobación

Ordena la ejecución del ticket T-48213.

Arrastra los elementos, o usa los botones de flecha, para ponerlos en orden.

  1. Posición 1: El nodo agent envía la tarea al modelo.
  2. Posición 2: El modelo responde sin llamadas a herramientas.
  3. Posición 3: ToolNode ejecuta get_ticket y agrega un ToolMessage.
  4. Posición 4: ToolNode ejecuta list_charges y agrega un ToolMessage.
  5. Posición 5: El modelo lo lee y pide list_charges.
  6. Posición 6: El modelo pide get_ticket.
  7. Posición 7: toolsCondition enruta a END.

Paso 4 de 4: Lo que ya puedes hacer

Lo que ya puedes hacer

  • Construir un agente ReAct como grafo con ToolNode y toolsCondition.
  • Seguir una ejecución mensaje por mensaje con streamMode "updates".
  • Explicar por qué todo ciclo de agente necesita un límite de recursión.