LangGraph sirve cuando el flujo de IA no es un solo prompt sino un proceso con estado: extraer, recuperar, redactar, revisar, rutear, reintentar y detenerse cuando una persona debe decidir.
Lo usamos cuando el workflow tiene que ser inspeccionable. Si un comprador, ingeniero o revisor no puede responder "qué paso corrió, qué tool se llamó, por qué se detuvo y qué estado llevó adelante," el agente es demasiado opaco para producción.
Dónde encaja LangGraph
- Flujos de varios pasos con estado explícito, retries y puntos de aprobación humana.
- Rutas de agente que necesitan observabilidad y repetibilidad más que autonomía llamativa.
- Productos donde el grafo también entra a la evaluación: qué ruta corrió, qué herramienta se llamó, qué nodo falló.
- Workflows donde el resultado correcto depende de detenerse, no de continuar: aprobación de experto, pedido inseguro, fuente faltante, verificador fallido o efecto secundario irreversible.
Qué miramos de cerca
- Sprawl del grafo. Si cada excepción se vuelve una rama nueva, el sistema termina siendo más difícil de evaluar que el prompt que reemplazó.
- Checkpoints humanos. La aprobación debe ser parte del diseño del grafo, no algo pegado después en la UI.
- Replayability. Un grafo que no puede reproducir una ejecución fallida con el mismo estado es difícil de depurar y de confiar.
Decisiones que solemos tomar
- Mantener nodos aburridos: inputs chicos, outputs chicos, estado tipado y ownership claro.
- Loguear transiciones de estado para que producto e ingeniería puedan leerlas juntos.
- Hacer rutas de rechazo y escalación tan explícitas como las rutas exitosas.
- Usar la evaluación para decidir cuándo un agente puede seguir y cuándo debe pedir ayuda humana.
Qué incluimos en el handover
- Topología del grafo y schema de estado.
- Owners por nodo y modos de falla.
- Instrucciones de replay para runs fallidos.
- Casos de evaluación que validan la ruta correcta, no solo la respuesta final.
- Logs de tool calls conectados con la acción de usuario que los disparó.
Cuándo lo evitamos
LangGraph no es un premio para toda función de IA. Si el workflow es un solo paso de retrieval, un clasificador simple o un asistente de redacción sencillo, un grafo puede sumar ceremonia sin reducir riesgo. Lo usamos cuando estado, ramas, retries y checkpoints humanos son requisitos reales del producto.
Trabajo relacionado
BidGenie usa el patrón para flujos de documentos con gates de revisión. Microstax usa primitivos listos para agentes donde el entorno también tiene que estar gobernado.