🧩 Nodos, aristas y estado

Un nodo puede ser un agente de IA, una llamada a un modelo, un fragmento de código común o incluso una decisión humana en medio del flujo. La pregunta que debes hacerte antes de diseñar cualquier nodo es sencilla: ¿esto necesita IA de verdad? La respuesta no siempre es sí.

Uno en el determinista — uno if, una consulta a una base de datos, un script que solo da formato a los datos: es más barato, rápido y confiable que dejarle todo al modelo. La regla en la que ha convergido la industria: el código controla el enrutamiento predecible; el modelo se encarga de lo que requiere interpretación o criterio.

Qué observar: las cinco cajitas cian dentro del nodo. Cada una puede ser diferente en cada nodo de tu grafo — y por eso quedan dentro de la caja, no dispersas por el sistema. Las dos flechas de salida ya muestran lo que el tema 2 va a desglosar: es ahí, en la arista, donde reside la condición.

Una arista condicional — la que lleva un «si» — y donde vive el enrutamiento: «si se aprueba, sigue; si se rechaza, vuelve». Eso es exactamente lo que distingue un grafo de una cola. Si todas tus aristas son incondicionales (siempre van al mismo lugar siguiente), no escribiste un grafo: escribiste un pipeline disfrazado.

Qué observar: las dos flechas que salen del validador van a lugares diferentes, según una condición. Y es esta bifurcación — no la cantidad de nodos — lo que hace que este dibujo sea un grafo. Si solo existiera la flecha verde, sería solo un pipeline de tres pasos.

¿Qué pasa exactamente de un nodo a otro? Esa pregunta parece pequeña, pero define la mitad del éxito de tu grafo. El esquema de estado — el formato acordado de lo que viaja por las aristas — es un contrato, y los contratos se escriben, no se improvisan.

Pasar toda la conversación de un nodo al otro parece seguro, pero anula la ganancia de contexto limpio: el siguiente nodo vuelve a ver cómo el trabajo se hizo, no solo qué se produjo — y eso llena su contexto de ruido. Pasar menos hace que el siguiente nodo trabaje a ciegas, sin el dato que necesitaba.

Modelo, herramientas, permisos, instrucciones y límite de costo (el límite máximo que ese nodo puede gastar antes de que lo interrumpan) pueden ser diferentes en cada nodo. Modelo potente en el paso difícil y barato en el fácil; herramienta de escritura solo en el nodo que escribe; acceso a internet solo para quien investiga.

Esta configuración por nodo es lo que le da valor económico real al grafo — y donde el costo realmente baja. Un sistema que usa el mismo modelo caro en cada paso, solo porque «es más sencillo configurarlo una vez», está quemando dinero en pasos que un modelo barato resolvería igual.

Un grafo de un solo nodo, con todas las herramientas y todas las instrucciones, ejecutándose hasta agotarse: eso es un loop reinventado, y la estructura de grafo no está haciendo nada por ti. Pagaste la complejidad de "pensar en grafo" y no obtuviste ninguno de los beneficios — configuración por nodo, costo diferenciado, enrutamiento condicional.

Prueba práctica: si no puedes asignar configuraciones diferentes a dos nodos de tu diseño, probablemente no necesitabas dos nodos. Únelos. Un grafo degenerado de este tipo no está «mal»: simplemente no es un grafo, sino un loop con un diseño bonito encima.

Qué observar: la ecuación no tiene "menos loop" en ninguna parte: tiene loop más loop más un ingrediente nuevo: el estado explícito que viaja entre ellos (lo que viste en el tema 3). Un grafo de un solo nodo, sin esa composición, es solo un bucle que se hace pasar por un grafo.

Demasiado grande y el grafo no ayuda en nada: volviste a la caja negra de un orquestador único que hace todo. Si es demasiado pequeño, pagas un costo de coordinación que supera el trabajo trivial: más aristas, más estado que pasar, más posibilidades de error, sin ninguna ganancia.

Regla práctica: un nodo por cambio de contexto, herramienta o responsabilidad. Si dos pasos usan el mismo contexto y las mismas herramientas, probablemente son un solo nodo. Si un paso cambia de «escribir» a «validar», es un cambio de responsabilidad: son dos nodos.

{
  "nos": {
    "escritor": {
      "modelo": "<modelo-medio>",
      "ferramentas": ["escrever_arquivo"],
      "teto_custo_usd": 0.05
    },
    "validador": {
      "modelo": "<modelo-forte>",
      "ferramentas": [],
      "teto_custo_usd": 0.02
    },
    "formatador": {
      "modelo": null,
      "ferramentas": ["script_deterministico"],
      "teto_custo_usd": 0.00
    }
  },
  "arestas": [
    { "de": "escritor", "para": "validador", "quando": "sempre" },
    { "de": "validador", "para": "formatador", "quando": "resultado_valido == true" },
    { "de": "validador", "para": "escritor", "quando": "resultado_valido == false" }
  ]
}