Clase 03 · Módulo 11
Darle herramientas al agente
Darle herramientas al agente
Qué logras en esta clase
Le das a tu agente herramientas que usa bien, porque están acotadas y bien descritas.
- Eliges entre nodo, subflujo y llamada HTTP como herramienta.
- Decides qué parámetros fijas tú y cuáles rellena el modelo.
- Escribes nombres y descripciones que el modelo entiende.
02
El modelo no ve tu flujo
De cada herramienta el modelo solo lee tres cosas: su nombre, su descripción y los datos que pide. Con eso decide.
03
El recorrido de una llamada
El modelo nunca ejecuta nada. Pide; quien ejecuta es n8n, con tus credenciales. Por eso todo lo que conectes como herramienta queda al alcance de sus decisiones.
04
Tres formas de dar una herramienta
| Forma | Qué es | Ejemplo |
|---|---|---|
| Nodo como herramienta | Un nodo de aplicación conectado al agente | Leer filas de Google Sheets |
| Subflujo como herramienta | Otro flujo tuyo que el agente invoca | «Reservar hora» con sus validaciones |
| Llamada HTTP | Una petición a una API (módulo 5) | Consultar el estado de un despacho |
Qué nodos se pueden conectar como herramienta depende de tu versión: lo ves al pulsar el conector de herramientas del agente.
05
Nodo como herramienta: lo más directo
Sirve cuando la acción es una sola operación de un servicio que n8n ya integra.
- Pulsa el conector de herramientas del nodo AI Agent.
- Busca el servicio y elige la operación.
- Selecciona la credencial.
- Completa los parámetros que no deben cambiar.
- Escribe la descripción de la herramienta.
06
Fija todo lo que puedas
Cada parámetro que dejas en manos del modelo es una decisión más que puede salir mal. Deja libre solo lo que cambia en cada conversación.
07
Parámetros fijos y parámetros del modelo
| Parámetro | Quién lo define |
|---|---|
| Calendario a consultar | Tú, fijo en el nodo |
| Duración de la cita | Tú, fijo en el nodo |
| Fecha pedida | El modelo, según el mensaje |
n8n permite marcar un parámetro para que lo rellene el modelo; la documentación lo describe con la función $fromAI. Comprueba su forma de uso en la página del nodo AI Agent antes de escribirla a mano.
08
Subflujo como herramienta
Conviene cuando la acción tiene varios pasos o reglas que no quieres dejar al criterio del modelo: validar, registrar, pedir aprobación.
El subflujo parte con Execute Sub-workflow Trigger y debe estar publicado, como viste en el módulo 4, clase 4.
09
Por qué el subflujo da más control
- El agente pide una acción; el cómo queda escrito por ti, paso a paso.
- Puedes rechazar datos inválidos antes de tocar nada.
- Puedes dejar registro de cada llamada en una tabla.
- El mismo subflujo sirve a otros flujos y agentes.
10
Llamada HTTP como herramienta
Úsala cuando el servicio no tiene nodo propio pero sí API.
- Deja fija la dirección y el método; no le entregues «cualquier URL».
- La clave va en una credencial de n8n, nunca en la descripción.
- Limita la herramienta a una operación: una para consultar, otra distinta para crear.
Todo lo visto en el módulo 5 sobre códigos de respuesta y límites aplica igual aquí.
11
Cuál conviene
| Si la acción… | Usa |
|---|---|
| Es una operación de un servicio integrado | Nodo como herramienta |
| Tiene varios pasos, validaciones o aprobación | Subflujo |
| Es de una API sin nodo propio | Llamada HTTP |
| Ya la ofrece un servidor MCP | MCP Client Tool (clase 5) |
Ante la duda entre nodo y subflujo para una acción que modifica datos, elige subflujo.
12
Cómo describir una herramienta
Escribe la descripción como se lo explicarías a alguien nuevo en el negocio:
- Qué hace, en una frase.
- Cuándo usarla.
- Cuándo no usarla, si hay otra parecida.
- Qué datos necesita y en qué formato.
- Qué devuelve.
Dos o tres frases bastan. Lo que no esté escrito, el modelo lo supone.
13
Descripción mala contra buena
| Mala | Buena |
|---|---|
| «Agenda» | «Devuelve las horas libres de un día. Úsala antes de ofrecer una hora. Necesita la fecha en formato AAAA-MM-DD» |
| «Busca clientes» | «Busca un paciente por teléfono y devuelve nombre y última visita. Si no existe, devuelve vacío» |
La buena dice cuándo llamarla, qué pide y qué entrega.
14
El nombre también es instrucción
- Usa verbo y objeto:
consultar_horas_libres,crear_reserva. - Evita nombres casi iguales, como
agenda1yagenda2. - Si dos herramientas se parecen, explica la diferencia en ambas descripciones.
15
Pocas herramientas, bien separadas
Un agente con cuatro herramientas claras acierta más que uno con quince. Cada herramienta extra suma tokens y una forma más de equivocarse.
16
Qué devolverle al modelo
El resultado de la herramienta entra a la conversación y se paga en cada vuelta siguiente.
- Devuelve solo los campos que el agente necesita.
- Limita la cantidad de filas: diez resultados, no dos mil.
- Si algo falla, devuelve un texto claro: «no hay horas ese día», no un error técnico.
17
Herramienta de código: una nota
Existe una herramienta de código para que el agente ejecute una función escrita por ti. En JavaScript funciona con la configuración normal.
18
Probar herramienta por herramienta
- Ejecuta primero la herramienta sola, con datos escritos a mano.
- Conéctala al agente y haz una pregunta que la necesite.
- Haz una pregunta que no la necesite: no debería llamarla.
- Entrega un dato incompleto y mira si pregunta o inventa.
- Abre la ejecución y revisa con qué parámetros la llamó.
Agrega la siguiente herramienta solo cuando esta pasa las cinco.
19
Errores comunes
- Una herramienta «hacer de todo» con un parámetro de acción libre.
- Dar escritura cuando el caso solo pedía lectura.
- Devolver la tabla completa y gastar la ventana de contexto en una consulta.
- Describir el funcionamiento interno en vez de cuándo usarla.
20
Lo que te llevas
- El modelo elige con el nombre, la descripción y los parámetros: escríbelos tú.
- Nodo para una operación simple, subflujo para acciones con reglas, HTTP para API sin nodo.
- Fija los parámetros que no cambian y deja libres los mínimos.
- Devuelve resultados cortos y errores legibles.
- Pocas herramientas, probadas una por una.
21
Hazlo ahora
Quince minutos, sobre el agente de la clase anterior.
- Reescribe el nombre y la descripción de su herramienta con los cinco puntos.
- Agrega una segunda herramienta como subflujo: recibe un nombre y un teléfono y los anota en una hoja de prueba.
- Fija en el subflujo todo salvo esos dos datos.
- Pide al agente algo que requiera ambas herramientas y revisa en la ejecución el orden y los parámetros que usó.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026