Saltar al contenido

Lección 5 de 20 · Lectura y práctica

Quiz: Evaluación de conceptos de arquitectura

Tipo de lección: QuizConcepto claveLa arquitectura de agentes con LangGraph se basa en la construcción de grafos dirigidos donde los nodos representan estados o acciones, y las aristas definen transiciones condicionales. A.

Del concepto a la práctica

Taller de esta lección

Este repaso evalúa si puedes predecir un recorrido leyendo el estado, no si recuerdas definiciones aisladas. Observa qué campo modifica cada nodo y qué condición usa la arista. Una tabla de trazas hace visible la diferencia entre entrada, transformación y ruta.

Ejemplo resuelto

python
traza = []
def validar(s):
    traza.append("validar")
    return {"valida": bool(s["texto"].strip())}
def decidir(s):
    traza.append("decidir")
    return "responder" if s["valida"] else "pedir_dato"

s = {"texto": ""}
s.update(validar(s))
print(decidir(s), traza)
# pedir_dato ['validar', 'decidir']

Aquí traza es una variable local de la demostración, no memoria aislada para varias sesiones. En el grafo conserva la lista como campo de estado y devuelve updates; un nodo también puede tomar decisiones, y una función de herramienta puede envolverlas, pero asigna responsabilidades explícitas. La regla de diseño no significa que el framework prohíba nodos con herramientas o decisiones.

Pruébalo

  1. Escribe una pregunta con texto y otra vacía.

  2. Anota los campos tras cada nodo.

  3. Predice la ruta antes de ejecutar.

  4. Compara predicción y traza real.

Un error frecuente es considerar que una herramienta es un nodo de decisión. Corrígelo: la herramienta produce datos; otro nodo interpreta esos datos.

Comprueba tu resultado

Restablece traza=[] antes de cada caso independiente. La entrada vacía debe producir pedir_dato y dos eventos. La entrada "hola" debe producir responder, también con la secuencia validar, decidir.

Bucle de estado, herramienta y resultado, con revisión humana antes de una acción de alto impacto.
CursaloMapa de práctica
Un agente necesita límites

Un agente mantiene un estado y utiliza herramientas dentro de límites definidos. El resultado de cada herramienta actualiza ese estado para decidir el siguiente paso. Las acciones de alto impacto deben pasar por una revisión humana antes de ejecutarse.

Ver la infografía en tamaño completo ↗

Tipo de lección: Quiz

Concepto clave

La arquitectura de agentes con LangGraph se basa en la construcción de grafos dirigidos donde los nodos representan estados o acciones, y las aristas definen transiciones condicionales. A diferencia de los flujos lineales tradicionales, esta arquitectura permite que los agentes tomen decisiones basadas en el contexto, utilizando memoria para mantener el estado entre interacciones y herramientas para ejecutar funciones externas. Imagina un director de orquesta que no solo sigue una partitura, sino que ajusta el tempo según la reacción del público y los instrumentos disponibles.

En el contexto avanzado, el grafo se convierte en un sistema dinámico donde cada nodo puede evaluar condiciones para decidir el siguiente paso, creando bucles de retroalimentación que simulan razonamiento. La memoria actúa como el "libro de notas" del agente, almacenando conversaciones pasadas, resultados de herramientas y preferencias del usuario, mientras que las herramientas son como "asistentes especializados" que el agente puede invocar para tareas específicas, como consultar una base de datos o generar código.

Cómo funciona en la práctica

Para implementar un agente con LangGraph, sigue estos pasos clave:

  1. Define los nodos del grafo: cada nodo representa una función, como "procesar entrada", "evaluar memoria" o "ejecutar herramienta".
  2. Configura las aristas: especifica las transiciones entre nodos basadas en condiciones, por ejemplo, si una herramienta devuelve éxito, ir al nodo de actualización de memoria; si falla, ir al nodo de manejo de errores.
  3. Integra memoria: utiliza un sistema de almacenamiento, como un vector store o base de datos, para persistir el estado entre ejecuciones.
  4. Añade herramientas: registra funciones externas que el agente pueda llamar, asegurándote de que estén documentadas y tengan manejo de errores.

Ejemplo de un nodo simple en código:

def procesar_entrada(estado):
    # Estado incluye memoria y entrada actual
    memoria = estado['memoria']
    entrada = estado['entrada']
    # Lógica para procesar
    return {'memoria_actualizada': memoria + [entrada]}

Caso de estudio

Considera un agente de soporte técnico para una empresa de software. Este agente usa LangGraph para manejar tickets de usuarios con las siguientes características:

  • Memoria: Almacena el historial de interacciones por usuario, permitiendo referirse a problemas anteriores.
  • Herramientas: Incluye funciones como "buscar en base de conocimientos", "escalar a ingeniero" y "generar informe".
  • Decisiones condicionales: Basado en la severidad del problema (e.g., crítico vs. menor), el grafo dirige el flujo a diferentes nodos.

Tabla de flujo de decisiones:

CondiciónNodo destinoAcción
Problema resueltoActualizar memoriaCerrar ticket
Necesita escalaciónEjecutar herramienta de escalaciónNotificar equipo
Requiere más infoSolicitar detallesPreguntar al usuario
En pruebas reales, este agente redujo el tiempo de respuesta en un 40% al automatizar decisiones basadas en memoria acumulada.

Errores comunes

  • Grafo sobrecomplicado: Añadir demasiados nodos y condiciones puede hacer el sistema difícil de depurar. Solución: Mantén el grafo minimalista, agrupando lógica similar en nodos.
  • Memoria no persistente: Olvidar configurar almacenamiento persistente resulta en pérdida de contexto entre sesiones. Solución: Usa bases de datos o sistemas como Redis para memoria a largo plazo.
  • Herramientas mal definidas: Herramientas sin manejo de errores o documentación clara causan fallos en cadena. Solución: Valida entradas y salidas, y prueba cada herramienta aisladamente.
  • Condiciones ambiguas: Condiciones en las aristas que no cubren todos los casos pueden llevar a bucles infinitos. Solución: Define condiciones exhaustivas y añade un nodo de fallback.
  • Ignorar escalabilidad: No planificar para alto tráfico puede saturar el sistema. Solución: Diseña con concurrencia en mente, usando colas o procesamiento asíncrono.

Checklist de dominio

  • ¿Puedes diseñar un grafo con al menos 5 nodos que incluya bucles condicionales?
  • ¿Has integrado un sistema de memoria que persista entre múltiples ejecuciones del agente?
  • ¿Sabes registrar y llamar a 3 herramientas externas desde tu agente?
  • ¿Puedes depurar un grafo identificando nodos problemáticos con logs?
  • ¿Has optimizado el rendimiento del agente para manejar 100+ solicitudes por minuto?
  • ¿Entiendes cómo las decisiones condicionales afectan el flujo de estado en tiempo real?
  • ¿Puedes documentar la arquitectura para que otros ingenieros la mantengan?

Construye un agente de recomendación de libros con memoria y herramientas

En este ejercicio, crearás un agente que recomienda libros basado en preferencias del usuario, usando LangGraph para manejar memoria y herramientas. Sigue estos pasos:

  1. Configura un entorno Python con LangGraph instalado y define un grafo básico con nodos para "recibir entrada", "consultar memoria", "llamar herramienta de recomendación" y "actualizar memoria".
  2. Implementa un sistema de memoria simple que almacene los libros que el usuario ha leído y sus calificaciones en un diccionario persistente (puedes simularlo con un archivo JSON).
  3. Crea una herramienta que, dado un género preferido, consulte una base de datos simulada (e.g., una lista de libros con géneros) y devuelva 3 recomendaciones.
  4. Añade condiciones al grafo: si el usuario ya leyó un libro recomendado, el agente debe saltar a un nodo que sugiera alternativas.
  5. Prueba el agente con al menos 3 interacciones diferentes, verificando que la memoria se actualice y las decisiones condicionales funcionen.
Pistas
  • Usa el estado del grafo para pasar datos entre nodos, incluyendo la memoria y la entrada actual.
  • Para la herramienta de recomendación, simula una base de datos con una lista de diccionarios que incluyan título, género y popularidad.
  • Asegúrate de que las condiciones en las aristas evalúen correctamente los valores del estado, como comparar títulos en memoria.

Evalua tu comprension

Completa el quiz interactivo de arriba para ganar XP.

Sigue con LangGraph para Automatización: Memoria, Estado y Decisiones

Esta lección forma parte de un curso de Cursalo. Revisa su programa y elige entre la compra individual o el acceso a toda la escuela.

Si ya tenías acceso a este curso, entra con tu cuenta: tus derechos y tu progreso se conservan. No necesitas comprarlo de nuevo.

01 / ELEGIR UNA RUTA

El próximo paso

Aprende IA mientras construyes algo que sí necesitas.

Empieza por el curso inicial o explora el catálogo para encontrar una práctica alineada con tu trabajo.