Un grafo con 40 nodos en un solo archivo es imposible de mantener. La respuesta de LangGraph no es "menos nodos" — es agruparlos en subgrafos que se comportan como cajas negras reutilizables.
Los subgrafos te dejan anidar un grafo compilado dentro de otro como un nodo reutilizable de caja negra, con su propio estado privado — cada subgrafo es testeable de forma independiente, componible de forma independiente, y mantiene sus internals completamente ocultos del grafo padre.
Un CompiledStateGraph producido por `StateGraph.compile()` implementa el PregelProtocol y se puede pasar directamente como un nodo a `StateGraph.add_node()`. El grafo padre entonces trata al subgrafo como un nodo opaco: llama al `invoke`/`ainvoke` del subgrafo durante la ejecución, y el subgrafo corre su propio loop Pregel completo — internamente es un grafo completo, externamente se ve como un solo nodo.
LangGraph soporta arquitecturas multi-agente nativamente a través de subgrafos — cada agente es en sí mismo un nodo de grafo que se puede componer jerárquicamente. Podés construir agentes supervisores que delegan a agentes especialistas, equipos de agentes paralelos que colaboran en distintos aspectos de una tarea, o workflows en cascada donde el output de un agente alimenta el input de otro.
El subgrafo devuelve valores desde su `output_schema`. Cada clave devuelta se escribe de vuelta en el estado del grafo padre — es un contrato explícito de qué información cruza la frontera entre subgrafo y grafo padre, en vez de compartir todo el estado interno sin control.
A medida que la complejidad del grafo crece, los subgrafos la mantienen manejable descomponiendo la lógica en módulos enfocados y testeados por separado. La señal de que es momento de dividir: cuando un solo archivo de grafo empieza a mezclar responsabilidades claramente distintas (por ejemplo, investigación + redacción + revisión), cada una de esas responsabilidades es candidata a convertirse en su propio subgrafo testeable de forma aislada. ===ARTICLE_END">
Carlos Montiel es arquitecto de soluciones IA empresarial. Implementa LLMs, Agentes, RAG y orquestadores en empresas de Guatemala y Latinoamérica. Contáctalo para una consultoría.
Contactar a Carlos Montiel