Sistemas de agentes y estándares · Capítulo 5 de 8
Orquestación: supervisores, fan-out, subgrafos
Patrones para varios agentes en un solo grafo de LangGraph: un supervisor que enruta, Send para trabajo en paralelo, subgrafos y el checkpoint que guarda cada superstep.
Objetivos
- Mira a dos especialistas ejecutarse en el mismo superstep.Pendiente
- Abre la ejecución de un subgrafo anidado.Pendiente
- Ejecuta el mismo trabajo con un agente y con un supervisor.Pendiente
- Predice el fan-out.Pendiente
Paso 1 de 4: La lectura
Supersteps
LangGraph ejecuta un grafo en supersteps. En cada superstep, todos los nodos que tocan se ejecutan, en paralelo; luego sus actualizaciones se combinan en el estado con el reducer de cada clave, y las aristas deciden qué nodos se ejecutan después. Los mensajes usan un reducer que agrega al final, así que dos nodos pueden agregar mensajes en un mismo superstep.
Hilos y checkpoints
Compila un grafo con un checkpointer, como MemorySaver, y pasa un thread_id al ejecutarlo. LangGraph guarda un checkpoint de todo el estado bajo ese hilo: uno para la entrada y luego uno al final de cada superstep. getState({ configurable: { thread_id } }) lee el último: los valores, el número de paso y next, los nodos que faltan por ejecutarse. Una ejecución posterior en el mismo hilo empieza desde ese estado.
Supervisor, fan-out, subgrafos
Un supervisor es un agente que decide qué especialista trabaja después. Aquí un traspaso es una llamada a herramienta como transfer_to_customer_support, así que el modelo lo elige como cualquier otra herramienta.
El fan-out ejecuta trabajo en paralelo. Una arista condicional puede devolver una lista de objetos Send en lugar de nombres de nodos. Cada Send inicia una ejecución de un nodo con su propia entrada, todas en el siguiente superstep, y el reducer combina lo que devuelven.
Un subgrafo es un grafo compilado usado dentro de un nodo. Tiene su propio estado y su propio namespace de checkpoints, y sus ejecuciones se anidan bajo el nodo que lo llamó. En este laboratorio el Financial Analyst llama a un subgrafo Data Engineer propio. Los traspasos con Command y los subgrafos que comparten estado llegan más adelante, en la ruta Agentes avanzados.
Cuándo basta un agente
Cada agente agrega llamadas al modelo, checkpoints y traspasos, y un lugar más donde fallar. Divide el trabajo cuando sus partes son independientes, cuando un solo contexto crecería demasiado, o cuando una parte necesita otras herramientas o instrucciones. Si no, empieza con un agente.
En este laboratorio, el equipo de soporte de Halden atiende el ticket T-48213, un cliente al que le cobraron dos veces el pedido 48213. Ejecútalo de las dos formas y compara lo que miden las trazas.
Paso 2 de 4: Pruébalo: Un cielo de agentes
Un cielo de agentes
Tres pasos: ejecuta el trabajo como supervisor y mira cómo cada superstep guarda un checkpoint, abre un subgrafo en el árbol de ejecuciones, y luego ejecuta el mismo trabajo con un agente y compara.
Modo:RealSimuladoReal: LangGraph.js ejecuta en esta página los grafos, el fan-out con Send, los subgrafos y los checkpoints, getState vuelve a leer el hilo, y el tracer de LangChain registra cada ejecución. Simulado: los modelos siguen un guion y los datos son ficticios.
Paso 3 de 4: Comprobación
Comprobación
new StateGraph(State)
.addNode("lookup", s => ({ results: [s.id * 10] }))
.addConditionalEdges(START, () => [new Send("lookup", { id: 1 }), new Send("lookup", { id: 2 })], ["lookup"])
.addEdge("lookup", END)
.compile()
.invoke({});Paso 4 de 4: Lo que ya puedes hacer
Lo que ya puedes hacer
- Construir un supervisor que enruta a agentes especialistas con llamadas a herramientas de traspaso.
- Hacer fan-out con Send y combinar resultados con un reducer.
- Usar un grafo compilado como subgrafo, y decir cuándo basta un agente.
- Ejecutar un grafo en un hilo y leer su último checkpoint con getState.