Saltar al contenido
Volver a Construye tus primeros agentes

Construye tus primeros agentes · Capítulo 1 de 8

Las librerías, y qué se ejecuta aquí

Qué paquetes de LangChain.js y LangGraph.js necesita un agente, qué hace cada uno y cómo se ejecutan en un navegador.

15 minutos0 de 3 objetivos hechos

Objetivos

  • Abre los seis paquetes del mapa y lee lo que te da cada uno.Pendiente
  • Ejecuta el hello-world en esta página y lee la respuesta.Pendiente
  • Supera la comprobación.Pendiente

Paso 1 de 4: La lectura

Los paquetes

LangChain.js y LangGraph.js son librerías de JavaScript de código abierto para construir con modelos de lenguaje. Vienen como paquetes separados, así que instalas solo lo que usas.

@langchain/core contiene las piezas compartidas: los mensajes, la interfaz de modelo de chat, las herramientas y los callbacks. @langchain/langgraph es el runtime para agentes como grafos: estado, nodos, aristas, checkpoints y pausas para aprobación. Un paquete de proveedor como @langchain/anthropic o @langchain/openai te da la clase de modelo de chat para la API de un proveedor; la misma clase ChatOpenAI también habla con servicios compatibles con OpenAI como OpenRouter, Hugging Face y NVIDIA. zod describe y valida la entrada de tus herramientas; LangChain convierte un esquema de zod en el JSON Schema que lee el modelo. langsmith es opcional y registra trazas de cada ejecución.

Por qué una librería de grafos

Puedes escribir un ciclo de agente a mano: llamas al modelo, ejecutas las herramientas que pide y repites. El capítulo 6 construye ese ciclo como un grafo de dos nodos. LangGraph agrega lo que le falta a un ciclo escrito a mano: estado guardado después de cada paso, para que una ejecución pueda pausarse por una persona y reanudarse después; ramas que se ejecutan en paralelo; y una estructura que puedes inspeccionar y dibujar.

El paquete langchain se apoya en LangGraph y ofrece createAgent, un agente listo para usar con middleware. Esta ruta primero construye el grafo a mano, para que después sepas qué hacen por ti esos atajos.

Instalación

En tu propio proyecto: npm install @langchain/core @langchain/langgraph @langchain/anthropic zod. Esta ruta usa @langchain/core 1.2.18, @langchain/langgraph 1.5.1 y zod 4.6.7. Fija versiones exactas en proyectos reales: estas librerías cambian rápido.

Qué cambia en un navegador

Todo en esta ruta se ejecuta en tu navegador, así que importa LangGraph desde @langchain/langgraph/web. El punto de entrada principal pasa la configuración a las llamadas anidadas con AsyncLocalStorage, que los navegadores no tienen. Con /web pasas config explícitamente a las llamadas anidadas y pausas las ejecuciones con breakpoints (interruptBefore) en lugar de interrupt(). El resto de la API es igual.

El modelo sigue un guion por defecto, así que no necesitas clave y cada ejecución da el mismo resultado. En este capítulo es el propio FakeListChatModel de LangChain, que devuelve las respuestas que le das. Desde el capítulo 2 puedes conectar un modelo real con tu propia clave.

Paso 2 de 4: Pruébalo: Los paquetes

Los paquetes

Abre cada paquete del mapa para ver lo que te da, la versión que se usa aquí y cómo importarlo. Luego ejecuta el hello-world.

Cargando la visualización…

Modo:RealSimuladoReal: las versiones del mapa son las que están instaladas aquí, y @langchain/core ejecuta el hello-world en esta página. Simulado: el modelo es el FakeListChatModel de LangChain, que devuelve una respuesta fija, así que no se llama a ninguna IA y nada sale de tu navegador.

Paso 3 de 4: Comprobación

Comprobación

Pregunta 1 de 4¿Qué paquete define HumanMessage, AIMessage y tool()?

Siguiente: Pregunta 2 de 4

Pregunta 2 de 4Ejecutas un grafo de LangGraph en un navegador. ¿Desde dónde importas StateGraph?
Pregunta 3 de 4¿Qué hace zod en un agente de LangChain?
Pregunta 4 de 4¿Por qué el hello-world usa FakeListChatModel?

Paso 4 de 4: Lo que ya puedes hacer

Lo que ya puedes hacer

  • Elegir los paquetes para un agente de LangGraph.js y decir qué hace cada uno.
  • Instalarlos con versiones fijas.
  • Explicar qué cambia cuando LangGraph se ejecuta en un navegador.
  • Ejecutar código de LangChain con un modelo falso, sin necesidad de clave.