Recursos · Integración n8n

Nodo Guardrails n8nConfigura Guardrails en n8n.

Guardrails coloca un filtro entre quien escribe y tus pasos de IA. El nodo Guardrails n8n trae 2 operaciones, un puerto Chat Model y una lista de 9 barreras, desde datos personales hasta intentos de saltarse el modelo. Útil en cuanto un flujo lee texto que no has escrito tú.

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

Por qué automatizar

¿Qué hace de verdad el nodo Guardrails n8n?

El nodo Guardrails funciona como un punto de control alrededor de un paso de IA. Lee un texto, lo pasa por las barreras que has activado y después manda el item a la rama Fail o devuelve una versión del mismo texto con las partes sensibles sustituidas. Todo ocurre dentro del flujo, sobre el item que acaba de llegar, y tú decides qué viene detrás.

Primer caso: una tienda que responde consultas llegadas por formulario. Antes de que el texto llegue al AI Agent, la operación Check Text for Violations se ejecuta con Jailbreak y Topical Alignment activados. Un mensaje que intenta desviar al asistente de su cometido sale por la rama Fail. Las dos barreras se apoyan en un modelo, es decir, en un subnodo de tipo modelo de chat conectado a la entrada Model.

Segundo caso: un buzón que alimenta una hoja de cálculo. El texto recogido en Gmail pasa por Sanitize Text con Personal Data (PII) y Secret Keys, y lo que aterriza en Google Sheets ya no lleva teléfonos, números de tarjeta ni claves de API a la vista: cada valor detectado se sustituye por un marcador. La fila sigue leyéndose bien, que es justo la gracia de enmascarar en vez de bloquear.

Tercer caso: el sentido contrario. Un borrador redactado por el modelo vuelve a pasar por el nodo antes de publicarse en Slack. Con URLs activo, cada enlace que no figure en Block All URLs Except cuenta como violación, y Block userinfo descarta los enlaces que llevan credenciales dentro.

Cuándo conviene otra cosa. Las barreras Keywords y Custom Regex comparan patrones, no razonan: muchas veces basta con una lista de palabras separadas por comas o con una expresión regular, y así no se envía nada a un proveedor de modelos. Las barreras Jailbreak, NSFW, Topical Alignment y Custom sí piden el puerto Chat Model, y ese proveedor factura sus llamadas de API según sus propias condiciones.

Los límites conviene verlos antes de montar nada. El nodo trabaja sobre texto, una cadena cada vez, tomada del campo Text To Check. Sanitize Text abre solo una parte de la lista: las barreras que detectan URL, expresiones regulares, claves secretas y datos personales. Los umbrales van de 0.0 a 1.0, así que una barrera devuelve un nivel de confianza y no una verdad absoluta: prueba con tus propios ejemplos antes de fijar un valor. Esta página describe la versión 2 del nodo, un flujo antiguo puede mostrar menos opciones. Si quieres una lectura externa de la plataforma, está nuestra Reseña n8n.

Conexiones

¿Qué se conecta al nodo?

Guardrails es un nodo raíz: se queda en el flujo principal y un subnodo se engancha a su puerto para poner el modelo. La conexión se dibuja en el lienzo, por eso el subnodo nunca aparece en el panel de parámetros.

Puertos (qué se conecta)

  • Chat Modelai_languageModelobligatorio
01Chat ModelEste puerto lleva el modelo que evalúa las barreras basadas en un LLM: Jailbreak, NSFW, Topical Alignment y Custom. Sin él, esas comprobaciones no tienen con qué juzgar el texto.

Este puerto lleva el modelo que evalúa las barreras basadas en un LLM: Jailbreak, NSFW, Topical Alignment y Custom. Sin él, esas comprobaciones no tienen con qué juzgar el texto.

Parámetros clave

  • Required: la operación Check Text for Violations necesita aquí un modelo de chat en cuanto se activa una barrera basada en un LLM.
  • OpenAI Chat Model o Anthropic Chat Model: lo más directo si ya tienes un credential con alguno, es decir, unas credenciales guardadas en n8n.
  • Ollama Chat Model: la vía cuando el texto revisado no debe salir de tus máquinas.
  • Google Gemini Chat Model: otra opción alojada, se conecta igual.
Casos de uso
un chat abierto al público donde la barrera de jailbreak revisa cada mensaje antes de redactar la respuesta.
Acciones

¿Qué sabe hacer el nodo con tu texto?

El nodo Guardrails expone 2 operaciones. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

01

Check text for violations

classify

Lo que ves en n8n

Notas y casos de uso

Pasa el conjunto de barreras sobre una cadena y clasifica el item: lo limpio sigue su camino, lo marcado sale por la rama Fail.

Parámetros clave

  • Text To Check: la cadena examinada, normalmente traída de un nodo anterior con una expresión como {{ $json.message }}.
  • Jailbreak: detecta intentos de saltarse las medidas de seguridad del modelo, con un Threshold entre 0.0 y 1.0 donde cuanto más alto, más estricto.
  • Topical Alignment: un Prompt describe el ámbito permitido y se marca todo lo que se sale de ahí.
  • Keywords: una lista de palabras separadas por comas, comparada sin llamar a ningún modelo.
Casos de uso
revisar cada consulta de un formulario abierto antes de que un asistente la conteste.
02

Sanitize text

sanitize

Lo que ves en n8n

Notas y casos de uso

Deja que el item siga y reescribe las partes delicadas en lugar de frenarlas: cada valor detectado pasa a ser un marcador y el texto sigue sirviendo más adelante.

Parámetros clave

  • Text To Check: la cadena que se enmascara, a menudo el cuerpo de un mensaje recogido antes en la ejecución.
  • Personal Data (PII): con Type en All se rastrean todas las entidades, con Selected eliges de una lista, por ejemplo CREDIT_CARD, EMAIL_ADDRESS o PHONE_NUMBER.
  • Secret Keys: Permissiveness ajusta cuánto aprieta la detección, Strict, Balanced o Permissive.
  • Custom Regex: el Name que le pongas al patrón es el marcador que se escribe en su lugar.
Casos de uso
limpiar correos de soporte antes de archivarlos en una hoja compartida.
Necesitas ayuda

¿Necesitas ayuda para automatizar Guardrails con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Preguntas frecuentes sobre Guardrails en n8n

01¿El nodo Guardrails viene incluido en n8n, en Cloud y en autoalojado?
Sí. Guardrails forma parte del paquete de IA que se entrega con n8n: no hay nada que instalar ni nada extra que pagar por el lado de n8n, tanto en n8n Cloud como en una instancia que alojes tú. El flujo se comporta igual en los dos sitios. El único coste que puede aparecer no es de n8n: las barreras basadas en un modelo envían una petición al proveedor conectado al puerto Chat Model, y ese proveedor factura sus propias llamadas de API según sus condiciones. Las barreras que se apoyan en palabras clave o en una expresión regular no llaman a ningún modelo, así que por ahí no hay gasto.
02¿Qué hace falta configurar antes de usar el nodo Guardrails n8n?
Nada del lado de la cuenta. El nodo no tiene credential, es decir, un juego de credenciales guardado en n8n, ni selector de autenticación: no hay clave que pegar antes de la primera ejecución. Lo que sí necesita depende de las barreras activadas. Keywords y Custom Regex funcionan por su cuenta. Jailbreak, NSFW, Topical Alignment y Custom se apoyan en un modelo, así que hay que conectar un subnodo de tipo modelo de chat a la entrada Model, y es ese subnodo el que lleva las credenciales del proveedor. Conectado una vez, lo usan todas las barreras basadas en un LLM.
03¿Qué límites tiene el nodo Guardrails?
Trabaja sobre texto, una cadena cada vez, tomada del campo Text To Check, así que lo que quieras revisar tiene que mapearse ahí primero. Sanitize Text no abre la lista entera: cubre las barreras que detectan URL, expresiones regulares, claves secretas y datos personales, y sustituye lo que encuentra por marcadores en vez de detener el item. Las comprobaciones basadas en un modelo devuelven un nivel de confianza que se compara con un Threshold entre 0.0 y 1.0, de modo que un texto fronterizo puede pasar o no según dónde dejes ese valor. Esta página describe la versión 2 del nodo.
04¿Qué hay que conectar como mínimo y con qué subnodo empezar?
Como mínimo, un modelo de chat en la entrada Model, en cuanto haya una barrera basada en un LLM activa. Un subnodo es un nodo pequeño que nunca se ejecuta solo: solo trabaja mientras corre el nodo al que está enganchado. OpenAI Chat Model y Anthropic Chat Model son los arranques más sencillos si ya tienes credenciales con alguno de los dos. Google Gemini Chat Model se conecta igual. Si el texto no debe salir de tu infraestructura, Ollama Chat Model mantiene la evaluación en local. Activa una barrera, mira el resultado con tus ejemplos y añade las demás después.
05¿n8n o Make para poner barreras en un flujo de IA?
La decisión va de alojamiento y de forma del coste. Make solo corre en su plataforma alojada y cobra por operación, algo previsible y que no pide servidor por tu parte. n8n corre en n8n Cloud o en tus propias máquinas, así que la revisión de un texto sensible puede quedarse dentro de tu red, y con un modelo local en el puerto Chat Model no sale nada de ahí. Los dos se construyen de forma visual. Si ya tienes n8n montado, Guardrails es un nodo más en el mismo lienzo, justo al lado del paso que protege.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.