Saltar al contenido
Volver a Construye tus primeros agentes

Construye tus primeros agentes · Capítulo 4 de 8

Tu primer grafo

Construir un StateGraph con nodos y aristas, enrutar con una arista condicional y ejecutarlo paso a paso.

20 minutos0 de 3 objetivos hechos

Objetivos

  • Conecta START, classify, las dos áreas y END en un grafo que compile.Pendiente
  • Ejecuta el grafo de modo que cada rama se tome una vez.Pendiente
  • Predice cómo se ejecuta el grafo.Pendiente

Paso 1 de 4: La lectura

Nodos y aristas

Un StateGraph parte de una definición de estado, como Annotation.Root({ … }) o el MessagesAnnotation del capítulo 3. addNode(name, fn) agrega un nodo: una función que lee el estado y devuelve una actualización, que los reducers del estado combinan. addEdge(a, b) dice que b se ejecuta después de a. START y END son la entrada y la salida del grafo: una arista desde START elige el primer nodo, y una arista hacia END termina la ejecución.

Ramas

addConditionalEdges(from, router, targets) pone una decisión después de un nodo. El router es una función del estado que devuelve el nombre del siguiente nodo, y targets lista los nodos que puede devolver. Así es como un grafo envía una petición de reembolso a un área y una pregunta a otra. Sin router, dos aristas simples que salen de un mismo nodo se ejecutan las dos.

Compilar, luego ejecutar

compile() revisa la estructura y devuelve un grafo que puedes invoke() o stream(). Lanza un error si algo está mal, por ejemplo un nodo al que no llega ninguna arista (UnreachableNodeError). No exige que cada nodo llegue a END: un nodo sin arista de salida simplemente termina la ejecución ahí.

Una ejecución avanza en supersteps. En cada uno, todos los nodos que están listos se ejecutan, juntos; luego sus actualizaciones se combinan en el estado, y las aristas deciden qué nodos quedan listos después. stream() informa la actualización de cada nodo a medida que ocurre. Si dos nodos de un mismo superstep escriben la misma clave, esa clave necesita un reducer que las combine, o LangGraph lanza un error.

Paso 2 de 4: Pruébalo: Conecta un grafo

Conecta un grafo

Dibuja las cinco aristas de START a END; LangGraph compila el grafo después de cada una. Luego ejecuta los dos tickets de ejemplo y mira cada superstep.

Modo:RealSimuladoReal: LangGraph.js construye, revisa y ejecuta tu grafo en esta página. Si cambias el código a Python, LangGraph para Python hace lo mismo, sobre Pyodide (Python compilado a WebAssembly). Simulado: el servicio de soporte. No se usa ningún modelo: classify busca palabras de reembolso con un patrón, y cada área devuelve una respuesta fija.

Paso 3 de 4: Comprobación

Comprobación

Código
new StateGraph(State)
  .addNode("a", a).addNode("b", b).addNode("c", c)
  .addEdge(START, "a")
  .addEdge("a", "b").addEdge("a", "c")
  .addEdge("b", END).addEdge("c", END)
  .compile();
¿Cómo se ejecuta este grafo?

Paso 4 de 4: Lo que ya puedes hacer

Lo que ya puedes hacer

  • Construir y compilar un StateGraph con nodos, aristas, START y END.
  • Enrutar con addConditionalEdges.
  • Explicar los supersteps y cuándo los nodos se ejecutan en paralelo.