Qué es un agente de IA y cómo probar uno sin programar
Un agente es un modelo que puede decidir usar una herramienta. Se arma en n8n conectando cuatro cajas, corre entero en tu computadora, y en nuestra prueba se equivocó lo suficiente como para que valga la pena mirarlo de cerca.
CEO
Resultado esperado
Un agente andando en tu computadora al que le podés hacer una pregunta y ver, en el registro de la ejecución, si usó la herramienta que le conectaste, con qué se la llamó y qué le devolvió. No un asistente listo para producción: un banco de pruebas para entender qué hace un agente y dónde se rompe.
Necesitás
- Una computadora con unos 8 GB libres: entre n8n y los dos modelos se va casi todo
- Node.js instalado, que es lo que n8n necesita para arrancar
- Estar dispuesto a escribir dos comandos en la Terminal: uno para instalar n8n y otro para descargar el modelo. El resto es una pantalla con cajas
- Nada de cuentas de pago ni claves de API: el modelo corre local
Pasos
- Instalá Ollama y descargá dos modelos
- Instalá n8n y abrilo
- Creá el flujo y ponele el disparador
- Agregá el agente y escribile la pregunta
- Conectá el modelo local
- Conectá la herramienta
- Ejecutá y mirá el registro
- Cambiá el modelo y volvé a probar
- Probá una pregunta que no necesite la herramienta
- Errores comunes
- Preguntas frecuentes
La diferencia entre un chat y un agente cabe en una frase: el chat responde con lo que sabe, el agente puede decidir usar una herramienta y responder con lo que esa herramienta le devuelve. Si querés la definición completa, está en el glosario. Acá vamos a armar uno.
Se hace conectando cuatro cajas en una pantalla, sin escribir código, y corriendo el modelo en tu propia computadora. Toma unos 25 minutos.
Lo probamos antes de escribirlo, y el resultado más útil no fue que funcionara: fue verlo fallar. En una de las cuatro corridas el agente llamó a la herramienta con el formato equivocado, la herramienta no respondió, y el agente hizo la cuenta por su cuenta y la hizo mal, sin avisar. Ese es el motivo por el que el último paso de este tutorial es comprobar qué pasó de verdad.
Instalá Ollama y descargá dos modelos
Ollama es el programa que ejecuta modelos de lenguaje en tu equipo. Descargalo desde su sitio oficial e instalalo. Después, desde la Terminal:
ollama pull llama3.2:3b
ollama pull qwen2.5:7b
Son 2,0 GB y 4,7 GB. Bajamos los dos a propósito: más adelante vas a ver que el agente se comporta distinto según cuál uses, y esa comparación es media clase.
Instalá n8n y abrilo
n8n es una herramienta para conectar cosas entre sí. Se instala con un comando:
npx n8n
La primera vez descarga bastante y tarda unos minutos. Cuando termina, deja el programa escuchando en http://localhost:5678. Abrí esa dirección en el navegador.
La primera pantalla te va a pedir crear una cuenta de propietario con un correo y una contraseña. Es una cuenta de tu propia instalación, que vive en tu computadora: no se registra en ningún servicio.
Creá el flujo y ponele el disparador
Un flujo en n8n arranca siempre por un disparador: lo que decide cuándo se ejecuta. Al crear uno nuevo, n8n pregunta “What triggers this workflow?”.
Elegí “Trigger manually”. Es el más simple: el flujo corre cuando vos apretás un botón, que es justo lo que querés mientras probás.
Para agregar cualquier otra caja, abrís el panel de nodos y buscás por nombre en “Search nodes...”.
Agregá el agente y escribile la pregunta
Buscá y agregá el nodo “AI Agent”, y conectalo a la salida del disparador.
Adentro tiene un campo llamado “Source for Prompt (User Message)” con tres opciones: “Connected Chat Trigger Node”, “Connected Guardrails Node” y “Define below”. Elegí la última: te habilita un campo “Prompt (User Message)” donde escribís la pregunta a mano.
Escribí esta, que es la que usamos en la prueba:
Si tengo 17 cajas a 24 cada una y resto 39, ¿cuánto queda?
La respuesta correcta es 369. Anotala, porque el punto de todo esto es verificar.
Conectá el modelo local
El nodo del agente tiene, por debajo, puntos de conexión para piezas auxiliares. Uno es para el modelo de lenguaje. Agregá ahí el nodo “Ollama Chat Model”.
Ese nodo pide una credencial llamada “Ollama”. Tiene un solo campo que importa: “Base URL”, y ya viene con el valor correcto, http://localhost:11434. La casilla de API Key se deja vacía: un Ollama local no pide clave.
Después, en el campo “Model” del nodo, elegí llama3.2:3b. El desplegable lee los modelos que ya descargaste.
Conectá la herramienta
En el punto de conexión de herramientas del mismo nodo agente, agregá “Calculator”. n8n la describe así: “Make it easier for AI agents to perform arithmetic”.
No tiene ningún campo para configurar. Se conecta y listo. Elegimos esta a propósito: hace una sola cosa, el resultado se verifica de memoria, y no sale de tu equipo.
Con esto el flujo queda armado:
- Trigger manually le dice al agente cuándo arrancar.
- AI Agent es el que decide: recibe la pregunta y elige si responder solo o pedirle algo a una herramienta.
- Ollama Chat Model es el que piensa: el modelo que corre en tu máquina.
- Calculator es la herramienta: hace la cuenta cuando el agente se la pide.
Ejecutá y mirá el registro
Apretá “Execute workflow”. El flujo corre y devuelve una respuesta.
Y acá viene la parte que importa. La respuesta sola no te dice si la herramienta se usó: para eso está el panel “Logs”, que cuando no hay nada muestra el texto “Nothing to display yet. Execute the workflow to see execution logs.”. Ahí ves, ejecución por ejecución, qué nodo corrió y cuántas veces. También queda registrado en “Executions”, en el menú lateral.
Lo que tenés que buscar son dos señales:
- Que Calculator aparezca en el registro. Si no está, el agente contestó de memoria.
- Que el modelo haya corrido dos veces y no una. Dos pasadas es la firma del agente: la primera para decidir y pedir la herramienta, la segunda para redactar con lo que la herramienta devolvió.
En nuestra corrida con llama3.2:3b eso fue exactamente lo que pasó: el modelo corrió dos veces, la calculadora se llamó una, recibió **17*24-39 y devolvió 369**. El agente respondió “La respuesta a tu pregunta es: 369”. Tres segundos y medio.
Cambiá el modelo y volvé a probar
Ahora, sin tocar nada más, andá al nodo “Ollama Chat Model” y cambiá “Model” a qwen2.5:7b. Misma pregunta, mismo flujo, misma herramienta.
Esto es lo que nos pasó, y es el motivo por el que este tutorial existe:
- El modelo corrió cinco veces y llamó a la calculadora cuatro.
- Las cuatro veces le pasó el dato con el nombre equivocado: mandó expression donde la herramienta espera input. La expresión era correcta —**17*24-39**— pero llegaba en el envoltorio incorrecto.
- Las cuatro veces la calculadora respondió “I don't know how to do that.”.
- La respuesta final salió rota: mezcló el texto con la sintaxis interna de la llamada a la herramienta.
Y en una corrida anterior con ese mismo modelo, ante la misma pregunta, la calculadora falló igual pero el agente hizo la cuenta por su cuenta y respondió 405. La respuesta correcta es 369. No dio ningún aviso de que la herramienta había fallado.
Probá una pregunta que no necesite la herramienta
Última prueba, y sirve para desarmar una idea equivocada. Cambiá la pregunta por:
¿Cuál es la capital de Uruguay?
Con qwen2.5:7b pasó lo esperable: el modelo corrió una sola vez, la calculadora no apareció en el registro, y contestó “La capital de Uruguay es Montevideo”. El agente evaluó que no le hacía falta la herramienta y no la tocó. Esa es la decisión, y ahí se ve.
Con llama3.2:3b, en cambio, sí llamó a la calculadora, y le pasó la palabra “Montevideo”. La herramienta devolvió el mismo error de siempre. La respuesta final fue correcta igual, pero el agente había hecho una llamada que no tenía ningún sentido.
O sea: que un agente tenga herramientas no garantiza que las use cuando corresponde ni que se abstenga cuando no corresponde. Es una decisión del modelo, y los modelos se equivocan en las dos direcciones.
Errores comunes
El desplegable “Model” aparece vacío
n8n no está viendo a Ollama. Abrí http://localhost:11434 en el navegador: si no responde, Ollama no está corriendo. Comprobá también que la credencial “Ollama” tenga http://localhost:11434 en “Base URL”, que es el valor por defecto.
La calculadora devuelve “I don't know how to do that.”
El agente le pasó el dato con el nombre equivocado. La herramienta espera la clave input y algunos modelos mandan expression. No es algo que puedas configurar en la pantalla: depende del modelo. Nos pasó con qwen2.5:7b y no con llama3.2:3b. Si te ocurre, cambiá de modelo antes que dar el flujo por perdido.
El agente responde un número, pero está mal
Es lo más peligroso porque no se nota. Cuando la herramienta falla, el modelo suele hacer la cuenta él mismo y darla como buena. Abrí el panel “Logs” y fijate qué devolvió la calculadora: si dice “I don't know how to do that.”, el número que te dieron no salió de ninguna herramienta.
La ejecución dice “success” y aun así el resultado es incorrecto
“Success” significa que el flujo terminó sin romperse, no que la respuesta sea buena. En nuestras pruebas las corridas con respuesta rota y con cifra equivocada figuraron las dos como exitosas. El estado de la ejecución y la calidad del resultado son dos cosas distintas.
El agente llama a la herramienta cuando no hace falta
También pasa. llama3.2:3b le pasó “Montevideo” a una calculadora. No siempre rompe la respuesta, pero es una señal de que el modelo no está eligiendo bien. Con preguntas que no necesitan herramienta, revisá si el registro muestra llamadas que no deberían estar.
npx n8n tarda muchísimo la primera vez
Es normal: descarga el programa entero. Dejalo terminar. Las veces siguientes arranca en segundos.