Nodos: Funciones y Herramientas en el Grafo

Nodos: Funciones y Herramientas en el Grafo

Los nodos son los pasos ejecutables de un grafo LangGraph: funciones Python, llamadas a LLM o herramientas externas. Dominar su implementación permite construir flujos de agente complejos y funcionales.

Funciones Python

Cada nodo se define como una función Python que recibe el estado y devuelve una actualización parcial del mismo. Esta firma simple mantiene el grafo predecible y fácil de probar. Escribir nodos pequeños y con una sola responsabilidad facilita el mantenimiento del flujo.

Estado que fluye

El nodo recibe una caja de estado por la arista de entrada y devuelve solo los campos que modifica. LangGraph fusiona esa actualización con el estado global según el reductor definido. Así se evita sobrescribir datos que otros nodos aún necesitan.

Herramientas externas

Un nodo puede envolver una herramienta externa, como una API o una base de datos, y exponerla al agente. La herramienta se invoca dentro de la función y su resultado se incorpora al estado. Conviene manejar errores y tiempos de espera para no romper el grafo.

Flujo encadenado

Los nodos se encadenan mediante aristas que determinan el orden de ejecución del flujo. Las aristas condicionales permiten elegir el siguiente nodo según el estado actual. Supervisar el grafo completo ayuda a detectar cuellos de botella y rutas sin salida.

Nodos y herramientas

Combinar nodos de función, de LLM y de herramienta cubre desde el razonamiento hasta la acción concreta. Cada tipo aporta una responsabilidad clara dentro del agente. Esta separación hace que el sistema sea modular, observable y fácil de extender.