- Gratis
- 1 página
- 10 minutos
Tu agente en TypeScript no necesita los dos frameworks. Necesita uno.
Una página para decidir entre LangGraph y Mastra, más el contrato mínimo que el agente tiene que cumplir antes de elegir.
- 01Entrada
- 02Salida estructurada
- 03Una herramienta, con tope
- 04Una pausa humana
- 05Un tope de vueltas
“Voy a probar los dos repos.” Y no terminas ninguno.
Si estás leyendo esto, ya estás eligiendo herramienta. El problema no es que LangGraph o Mastra sean malos. Es que los dos te van a gustar mientras tu agente no tenga claro qué tiene que hacer.
La hoja pone eso primero. El framework, después. Pero antes, qué es cada uno.
¿Qué es LangGraph?
Una librería del equipo de LangChain para construir agentes como grafos con estado. Tú defines los pasos (nodos), cómo se pasa de uno a otro (aristas) y qué datos viajan entre ellos (el estado).
En TypeScript se usa con LangGraph.js. La idea de fondo: el flujo del agente no vive escondido en un prompt, lo dibujas tú y lo puedes leer de arriba abajo.
En una frase: tú llevas el mapa.
StateGraphEl grafo: el estado compartido más los nodos y aristas que lo transforman.
arista condicionalDecide el siguiente nodo según el estado. Así se ramifica el flujo.
checkpointerGuarda el estado en cada paso, por hilo (thread_id). MemorySaver es el de memoria.
interrupt() + CommandPausa el grafo dentro de un nodo y lo reanuda con la respuesta humana.
¿Qué es Mastra?
Un framework de código abierto, escrito en TypeScript, para construir agentes de IA. Trae en el mismo paquete el agente, los workflows, la memoria, las herramientas y los evals.
Piensas en “un agente que hace X” y Mastra pone la estructura alrededor. Con mastra dev tienes un entorno local para probar agentes y workflows.
En una frase: la librería lleva el mapa.
new Agent()Instrucciones, modelo y herramientas en un objeto. Es la pieza central.
createWorkflow + createStepPasos tipados que se encadenan cuando el orden sí importa.
suspend() / resume()Un paso del workflow se detiene a esperar aprobación y sigue después.
memoria + evalsRecordar conversaciones y medir la calidad de las respuestas, sin montarlo aparte.
Las palabras que vas a leer en la hoja
- Agente
- Un modelo que decide qué hacer en cada paso y puede llamar a herramientas, en vez de responder una sola vez.
- Workflow
- Una secuencia de pasos fija que escribes tú. El agente improvisa; el workflow no.
- Nodo y arista
- El nodo es un paso (clasificar, buscar, redactar). La arista dice a qué paso se va después.
- Estado
- Los datos que viajan por el flujo: la incidencia, su tipo, el borrador de respuesta.
- Checkpoint
- Una foto del estado guardada. Permite reanudar aunque el proceso se reinicie.
- Pausa humana
- El agente se detiene hasta que alguien aprueba, edita o rechaza. En inglés, human in the loop.
- Salida estructurada
- El modelo devuelve un objeto con forma fija (tipo, severidad), no un párrafo que luego hay que adivinar.
- Evals
- Pruebas que puntúan las respuestas del agente para saber si un cambio lo mejora o lo empeora.
El contrato, antes del framework
Un agente de soporte que publica solo no es un agente. Es un incidente. Este es el mínimo, en cualquier stack.
Entrada
Un texto: la incidencia.
Salida estructurada
Tipo y severidad. Si el modelo devuelve prosa, no cuenta.
Una herramienta
Buscar en tu documentación. Con tope de llamadas.
Una pausa humana
No publica hasta que alguien aprueba, edita o rechaza.
Un tope de vueltas
Si se pasa, se detiene. No reintenta hasta fundir la API.
Para quién es la hoja (y para quién no)
Si alguna línea en rojo eres tú, ahórrate el email.
- Sí: Vas a construir un agente en TypeScript este mes.
- Sí: Ya miraste los dos repos y no te decides.
- Sí: Tu agente va a tocar algo real: clientes, tickets, publicaciones.
- No: Tu stack es Python. Mastra no existe ahí, así que la pregunta tampoco.
- No: Buscas un tutorial de instalación.
- No: Quieres un chatbot sin herramientas.
La diferencia es quién lleva el mapa: tú o la librería
Cuándo LangGraph
El camino es un grafo que tú dibujas:
clasificar → buscar → redactar → parar → publicar- Quieres ver cada nodo y cada arista.
- La pausa tiene que sobrevivir a reiniciar el proceso.
- El equipo discute el flujo en una pizarra, no en un prompt.
Cuándo Mastra
Quieres el agente, el workflow, la memoria y los evals en el mismo sitio.
agente + workflow + memoria + evals- El producto es el agente, no el diagrama.
- Vas a medir calidad desde la primera semana.
- Quieres cambiar de modelo sin reescribir el grafo.
En la hoja: cuándo no te conviene cada uno, y la tabla comparativa con la fila que nadie pone.
Los dos tienen un riesgo. Mejor saberlo antes.
| Aspecto | LangGraph | Mastra |
|---|---|---|
| Tú controlas | Cada nodo | El agente y el workflow |
| Pausa humana | Interrupt + checkpoint | Suspend / aprobación en el workflow |
| Riesgo | La fila que nadie pone está en la hoja → | |
Ninguno sustituye el contrato. Los dos lo implementan.
Sin humo
- No instala nada.
- No elige el modelo por ti.
- No es un curso de RAG.
¿Y si quieres escribir los dos?
El curso hace exactamente eso: el mismo agente de Triaje, en TypeScript, primero en LangGraph y luego en Mastra. Te aviso con un solo correo cuando esté listo.
Léela antes de hacer pnpm add de nada.
Quiero la hojaGratis. Una página. Un aviso el 20 de noviembre y nada más.