Recursos · Integración n8n

Nodo Code Tool n8nConfigura Code Tool en n8n.

El nodo Code Tool n8n convierte unas líneas de JavaScript o Python en una herramienta que un agente de IA llama por su cuenta. Bastan cuatro parámetros: un nombre, una descripción que el modelo lee para decidir cuándo usarla, el lenguaje con su caja de código y un esquema de entrada opcional.

Probar el nodo Code Tool en n8nVer los 4 parámetros

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve el nodo Code Tool n8n?

Code Tool es un subnodo, es decir, un nodo pequeño que se engancha al puerto de otro más grande en lugar de ocupar un paso del flujo principal. Guarda un fragmento de JavaScript o de Python y se lo ofrece a un agente como herramienta invocable. Cuando el modelo decide que encaja con la petición, n8n ejecuta el fragmento con el texto que el modelo ha escrito y devuelve a la conversación la cadena resultante.

El primer uso claro es el cálculo que ningún modelo de lenguaje debería adivinar. Un descuento por tramos, un reparto de IVA, los días hábiles entre dos fechas. Lo escribes una vez en la caja de JavaScript, lo describes en una frase y el agente deja de inventar cifras. El código lee el texto del modelo en la propiedad query y devuelve una sola cadena, así que el intercambio mantiene una forma previsible.

El segundo uso es la normalización. Un agente montado sobre el nodo AI Agent recibe texto sucio muy a menudo y hay que limpiarlo antes de hacer nada con él: un teléfono con formato irregular, una referencia de producto escondida en una frase, una fecha que debe quedar en ISO. Para eso no existe ningún nodo dedicado. Diez líneas de Python lo resuelven y el agente solo las llama cuando le hacen falta.

El tercer uso es la entrada vigilada. Activa Specify Input Schema y el modelo queda obligado a mandar una estructura que n8n valida antes de ejecutar tu código. Eso es lo que permite poner una herramienta de código al lado de otras que escriben de verdad, una fila en Google Sheets o un mensaje en Slack.

Cambia de nodo cuando la necesidad no sea realmente código. Llamar a un servicio que ya tiene su propio nodo en n8n sale mejor enganchando ese nodo como herramienta. Y una transformación que debe aplicarse a cada item, no cuando al agente le parezca, pertenece al flujo principal. Si hay que rogarle al modelo para que llame a tu función, lo que falla es la descripción, casi nunca el código.

Dos límites antes de construir encima. Python está en beta en este nodo, y la herramienta devuelve una sola cadena, de modo que cualquier resultado estructurado lo serializa tu propio código. El proveedor del modelo que hay detrás del agente, OpenAI u otro, factura sus llamadas de API según sus condiciones y n8n no añade nada. Para ver el montaje completo, el Curso n8n recorre los agentes y sus subnodos.

Conexiones

¿Dónde se engancha el nodo Code Tool ?

n8n divide sus nodos de IA en dos: un nodo raíz vive en el workflow y recibe los items, y los subnodos se conectan a sus puertos. Code Tool es un subnodo: no tiene entrada principal y nunca se ejecuta por su cuenta.

Salida (dónde se conecta)

  • Toolai_tool
01ToolEs el único puerto del nodo. Arrastras su conector hasta el puerto de herramientas de un nodo raíz y, desde ese momento, el modelo puede verlo en su lista, elegirlo y llamarlo igual que a cualquier otra herramienta del mismo agente.

Es el único puerto del nodo. Arrastras su conector hasta el puerto de herramientas de un nodo raíz y, desde ese momento, el modelo puede verlo en su lista, elegirlo y llamarlo igual que a cualquier otra herramienta del mismo agente.

Parámetros clave

  • Required: mientras no haya nada conectado, el nodo se queda inerte. Un subnodo no funciona por separado.
  • AI Agent: el anfitrión habitual, un agente conversacional o ejecutor.
  • AI Agent Tool: un agente conectado a su vez como herramienta de otro agente.
  • MCP Server Trigger: cuando la herramienta debe quedar expuesta a un cliente externo.
Casos de uso
el mismo fragmento sirve a un agente de soporte y a un servidor MCP, sin copiar la función en ningún otro sitio.
Parámetros

¿Qué controlan los 4 parámetros del nodo Code Tool ?

El nodo Code Tool tiene 4 parámetros. Para cada uno: el nodo tal como lo configuras en n8n, qué cambia el parámetro y nuestras notas de campo.

01

Name

name

Lo que ves en n8n

Notas y casos de uso

Junto con la descripción, el nombre es lo que el modelo lee cuando repasa las herramientas que tiene a mano. Es una etiqueta para una máquina, no un titular para una persona, y el placeholder My_Tool marca el registro esperado: corto y sin espacios.

Parámetros clave

  • Name: un campo de texto y nada más detrás. Un compute_shipping le dice más a un modelo que una frase completa.
Casos de uso
en cuanto un agente lleva varias herramientas de código, hacen falta nombres imposibles de confundir; si no, el modelo agarra el de al lado y entrega un resultado creíble y equivocado.
02

Description

description

Lo que ves en n8n

Notas y casos de uso

Todo lo que el modelo sabe sobre cuándo llamar a esta herramienta cabe en este campo. El placeholder del nodo funciona como plantilla: anuncia el trabajo y después lo que debe contener la entrada, en ese orden.

Parámetros clave

  • Description: texto libre. Escribe la condición que la dispara y la forma de la entrada esperada, por ejemplo una frase que diga que la herramienta devuelve un color al azar y que la entrada es una lista de colores a excluir separados por comas.
Casos de uso
una herramienta que nunca se llama suele venir de aquí. Nombrar la situación que debe activarla arregla más casos que reescribir el código.
03

Language

language

Lo que ves en n8n

Notas y casos de uso

Este selector decide qué caja de código aparece debajo y cambia la manera en que tu fragmento lee la entrada del agente. Elígelo antes de escribir, porque cambiarlo después obliga a rehacer el acceso al valor.

Parámetros clave

  • Language: dos opciones, javaScript (JavaScript) y python (Python (Beta)).
  • JavaScript: la caja de código de la primera opción. La entrada llega en la propiedad query y el fragmento debe devolver una única cadena.
  • Python: la caja de la segunda. Mismo contrato, salvo que la entrada se lee en _query.
Casos de uso
pasar un texto a mayúsculas es la línea suelta que confirma el cableado antes de meter la lógica real.
04

Specify Input Schema

specifyInputSchema

Lo que ves en n8n

Notas y casos de uso

Desactivado, la herramienta traga la cadena que el modelo haya escrito. Activado, n8n le exige al modelo un formato declarado y lo valida contra el esquema antes de ejecutar el código.

Parámetros clave

  • Specify Input Schema: el interruptor en sí. Hace aparecer los tres campos siguientes.
  • Schema Type: fromJson (Generate From JSON Example) deduce el esquema de un objeto de ejemplo, manual (Define using JSON Schema) te lo hace escribir.
  • JSON Example: el objeto de ejemplo que lee el primer modo.
  • Input Schema: el esquema, en formato JSON Schema. La sintaxis $refs no está soportada.
Casos de uso
una herramienta que espera un identificador de pedido aguanta mucho mejor con esquema.
Necesitas ayuda

¿Necesitas ayuda para automatizar Code Tool con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Code Tool , las preguntas que vienen después

01¿El nodo Code Tool es gratis dentro de n8n?
Sí. Forma parte del paquete de IA de n8n y viene incluido con n8n: no hay nada que instalar ni coste adicional por el lado de n8n, tanto en n8n Cloud como en una instancia autoalojada con la Community Edition y su licencia Sustainable Use. Un workflow se comporta igual tanto si corre con Docker, con npm o sobre la oferta alojada por n8n. Lo que sí puede costar dinero está en otro sitio: el agente al que se engancha esta herramienta necesita un modelo de chat, y el proveedor de ese modelo factura sus propias llamadas de API según sus condiciones. n8n no añade nada encima.
02¿Hace falta alguna credencial para que funcione?
No, ninguna. Este nodo no tiene credential, o sea unas credenciales guardadas dentro de n8n, ni selector Authentication, y por eso la página no lleva sección de conexión. La parte de cuentas se juega en el subnodo de modelo de chat conectado al mismo agente: ahí va la credencial del proveedor y es el único sitio donde se escribe una clave. Aquí la configuración se reduce a tres cosas: la caja de código, la descripción y el conector arrastrado hasta un nodo raíz. Si tu herramienta se ejecuta pero el agente no responde, mira el modelo y su clave, no este nodo.
03¿Qué límites tiene el nodo Code Tool n8n?
Tres que conviene prever. Python figura como beta en este nodo, así que JavaScript es la apuesta tranquila para lo que no quieras volver a tocar. El intercambio es de texto: el fragmento lee la entrada del modelo en una sola propiedad y tiene que devolver una única cadena, de modo que un resultado estructurado pasa por una serialización propia. Y la entrada solo se valida si Specify Input Schema está activado, con la sintaxis $refs de JSON Schema sin soporte incluso entonces. Esta página describe la versión 1 del nodo, la más alta del catálogo; un workflow antiguo puede mostrar una anterior, con menos opciones.
04¿Qué hay que conectar y por dónde se empieza?
Como mínimo, un nodo raíz. Code Tool es un subnodo con un solo puerto Tool y sin entrada principal, así que no hace nada mientras su conector no llegue a un AI Agent, a un AI Agent Tool o a un MCP Server Trigger. Ese nodo raíz necesita a su vez un modelo de chat conectado, con la credencial del proveedor puesta en ese subnodo. El primer montaje conviene hacerlo pequeño a propósito: un agente, un modelo de chat y una herramienta de código que pase a minúsculas lo que reciba, con la descripción escrita como una frase de disparo. Cuando el agente la llame sin dudar, cambia el fragmento por la lógica de verdad.
05¿n8n o Make para una herramienta de agente propia?
Depende de tres criterios. El alojamiento: n8n se instala en tus propios servidores con Docker o npm, o se usa en n8n Cloud, mientras que Make solo existe alojado, y eso ya decide por un equipo obligado a controlar dónde viven sus datos. El modelo de coste: Make factura por operación, algo que merece una simulación cuando un agente llama a sus herramientas en bucle. Y la lógica visual: una herramienta de código significa que la función en JavaScript o Python es tuya y vive en el workflow, lo que pide cierta soltura escribiéndola. Si lo que manda es no tocar código, esa soltura pesa menos. Las dos plataformas son serias y la respuesta la marcan tus condiciones.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.

Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones