GuidesOneMux

Crea un flujo de trabajo en n8n con validación, aprobación humana y gestión útil de errores

Un diseño práctico en n8n para validar solicitudes con datos de usuario, mantener las credenciales fuera de las instrucciones para la IA, exigir aprobación para acciones sensibles y dirigir los errores al siguiente paso adecuado.

AI

Resumen · TL;DR

Usa n8n para validar los datos entrantes antes de que lleguen a un AI Agent, exigir revisión humana para las llamadas a herramientas con consecuencias y ofrecer respuestas útiles cuando falle la validación, la aprobación o la ejecución. Guarda las credenciales en el sistema de credenciales de n8n en lugar de incluirlas en las instrucciones o los mensajes de aprobación.

Puntos clave

  • Valida y minimiza los datos entrantes antes de enviar cualquier campo a un AI Agent.
  • Usa la revisión humana de forma selectiva en acciones como enviar mensajes o modificar registros.
  • Muestra a quienes revisan la acción propuesta y el contexto necesario, no secretos ni datos personales innecesarios.
  • Trata la denegación, los datos no válidos y los errores de herramientas como resultados distintos, cada uno con pasos siguientes claros.
  • Prueba todas las rutas de aprobación y error con datos sintéticos antes de activar el flujo de trabajo.
En esta página (10)

Resumen del diseño

Un flujo de trabajo en n8n diseñado para proteger la privacidad no debería enviar todos los campos recibidos a un AI Agent y confiar en que el resultado será seguro. Empieza por validar y minimizar los datos, guarda las credenciales en la configuración de credenciales de n8n y pausa el flujo antes de usar herramientas que puedan afectar a una persona o a un sistema externo.

Una secuencia útil sería:

  1. Recibir una solicitud.
  2. Validar los campos obligatorios y los valores permitidos.
  3. Crear un registro con los datos mínimos necesarios para el paso de IA.
  4. Permitir que la IA proponga una acción, pero exigir revisión humana antes de ejecutar una herramienta con consecuencias.
  5. Gestionar la aprobación, la denegación y los errores de ejecución como resultados distintos.

El comportamiento de aprobación que se describe aquí sigue la documentación de n8n sobre revisión humana para herramientas. La estructura del flujo de trabajo y el ejemplo de validación que aparecen a continuación son ilustrativos; no constituyen una exportación probada ni garantizan el funcionamiento en todas las versiones de n8n o integraciones.

Requisitos previos y límites para los datos

Necesitarás un flujo de trabajo en n8n, una fuente de datos de entrada definida y credenciales configuradas para los servicios a los que se conecte el flujo. Si usas un AI Agent, añádele solo las herramientas que necesite. Elige un canal de aprobación disponible en tu configuración de n8n, como Slack, correo electrónico o la interfaz de n8n Chat.

Antes de empezar, decide lo siguiente:

  • ¿Qué campos son obligatorios para procesar una solicitud?
  • ¿Qué campos se pueden eliminar, enmascarar o sustituir por una referencia interna?
  • ¿Qué acciones requieren la aprobación de una persona?
  • ¿Quién está autorizado para aprobar y qué debe ocurrir si nadie responde?

No incluyas claves de API, contraseñas, tokens de sesión ni otras credenciales en las instrucciones, los parámetros de las herramientas o el mensaje de aprobación. Configura las credenciales de los servicios mediante los ajustes de credenciales de n8n. Una solicitud de aprobación debe ofrecer suficiente contexto para evaluar una acción sin revelar datos personales que no vienen al caso.

Crea el flujo de trabajo

1. Valida los datos antes de llamar a la IA

Empieza con el activador y, antes de cualquier nodo de IA o acción externa, añade un paso de validación. Por ejemplo, rechaza una solicitud si falta la referencia obligatoria del usuario, si la acción solicitada no está en una lista de permitidas o si un campo de texto libre supera la longitud aceptada.

Un ejemplo ilustrativo de comprobación en un nodo Code para una solicitud JSON pequeña podría ser:

const input = $json;
const errors = [];

if (typeof input.userRef !== 'string' || input.userRef.trim() === '') {
  errors.push('A user reference is required.');
}

const allowedActions = ['request_update', 'send_notice'];
if (!allowedActions.includes(input.action)) {
  errors.push('The requested action is not supported.');
}

if (typeof input.requestText !== 'string' || input.requestText.length > 1000) {
  errors.push('Request text must be provided and no longer than 1000 characters.');
}

return [{
  json: {
    valid: errors.length === 0,
    errors,
    userRef: input.userRef,
    action: input.action,
    requestText: input.requestText
  }
}];

Conecta el resultado a un nodo IF: las solicitudes válidas continúan; las no válidas pasan a una respuesta o una ruta de revisión que explique qué hay que corregir. Adapta los nombres de los campos, los límites y la gestión de los valores devueltos a tu activador y a tu versión de n8n. No uses este ejemplo como sustituto de la validación de tu esquema de entrada real.

2. Reduce al mínimo los datos que recibe la IA

Antes del AI Agent, usa un paso de asignación de campos para crear un objeto específico para la tarea. Conserva solo la referencia del usuario, el texto de la solicitud permitido y los campos necesarios para decidir la siguiente acción. Si la IA no necesita un nombre, una dirección de correo electrónico o el registro completo, no los incluyas.

En las instrucciones del Agent, define las acciones permitidas y aclara que no debe inventar datos que falten. Si falta un valor, debe pedir una aclaración o detenerse de forma segura, no dar por supuesto un valor. Mantén los secretos fuera tanto de las instrucciones del sistema como del mensaje del usuario.

3. Exige aprobación para las herramientas con consecuencias

En el panel Tools del AI Agent, configura un paso de revisión humana y conecta las herramientas que requieren aprobación. n8n documenta la posibilidad de exigir aprobación para herramientas seleccionadas o para todas las herramientas conectadas a un Agent. Cuando se llama a una herramienta sujeta a revisión, el flujo se pausa; quien revisa puede aprobar los parámetros propuestos o denegarlos. La aprobación permite que la herramienta se ejecute con los parámetros especificados por la IA; la denegación cancela la acción.

Formula la solicitud de manera concreta. Los valores documentados $tool.name y $tool.parameters pueden servir para mostrar a quien revisa qué herramienta se va a llamar y cuáles son los parámetros propuestos. Por ejemplo:

Review the proposed action before it runs.
Tool: {{ $tool.name }}
Proposed parameters: {{ JSON.stringify($tool.parameters, null, 2) }}
Approve only if the action and affected record are correct.

Revisa qué parámetros podrían aparecer en el mensaje de aprobación. Si contienen datos personales que no son necesarios para la revisión, modifica la entrada de la herramienta o el mensaje para reducir la exposición. No incluyas credenciales en los parámetros de las herramientas. n8n enumera Chat, Slack, Discord, Telegram, Microsoft Teams, Gmail, WhatsApp Business Cloud, Google Chat y Microsoft Outlook como posibles canales de aprobación; la disponibilidad depende de tu configuración.

Indica al Agent qué debe hacer si se deniega la solicitud: explicar que la acción no se completó, ofrecer una alternativa segura o pedir una aclaración. La documentación recomienda describir en las instrucciones del sistema la configuración de revisión y el comportamiento ante una denegación. La aprobación es un punto de control, no sustituye a los controles de acceso ni a la validación de los datos.

Haz que los errores permitan actuar

Planifica cómo gestionar estas tres clases de error:

SituaciónResultado útil
Los datos no superan la validaciónDetén el flujo antes de llamar a la IA o a la herramienta; indica qué campo falta o no es válido sin repetir datos sensibles.
Quien revisa deniega la acciónNo la reintentes automáticamente; informa a quien hizo la solicitud de que no se llevó a cabo y explica el siguiente paso seguro.
Falla una herramienta aprobadaRegistra un resumen del error que no exponga datos, conserva una referencia para investigar y dirige el problema a la persona responsable del flujo o al proceso de soporte.

Si falla una herramienta, evita mostrar a los usuarios los detalles sin procesar del error, ya que podrían incluir datos personales o información de implementación. Incluye suficiente contexto operativo para que una persona autorizada pueda investigarlo, como el paso del flujo de trabajo, la hora y una referencia de la solicitud. Define si es seguro volver a intentarlo: en algunos diseños puede ser aceptable repetir una lectura, mientras que repetir el envío de un mensaje o la actualización de un registro podría duplicar una acción. Comprueba el comportamiento del servicio de destino antes de añadir reintentos automáticos.

Prueba el flujo antes de activarlo

Usa registros sintéticos para probar, como mínimo, estas rutas: datos válidos, falta de datos obligatorios, acción no admitida, aprobación concedida, aprobación denegada y error de una herramienta después de la aprobación. Confirma que las solicitudes no válidas nunca llegan al Agent, que una denegación impide ejecutar la herramienta protegida y que los mensajes de aprobación no revelan secretos ni datos innecesarios del usuario. Comprueba también que todos los mensajes de error indiquen un paso siguiente práctico.

Conclusión

El patrón más seguro consiste en validar primero, reducir al mínimo los datos antes de procesarlos con IA y colocar la revisión humana justo antes de las acciones que requieren supervisión. Separa los errores de validación, las denegaciones y los errores de ejecución para poder gestionar cada uno de forma deliberada. Prueba esas rutas con datos no sensibles antes de poner el flujo de trabajo en uso.

Fuentes

FAQ

¿Se puede exigir aprobación en n8n solo para algunas herramientas de un AI Agent?

Sí. La documentación de n8n describe cómo aplicar la revisión humana a todas las herramientas conectadas a un AI Agent o solo a algunas. Usa la revisión en las acciones cuyas consecuencias justifiquen que una persona compruebe los parámetros propuestos.

¿Qué ocurre cuando alguien deniega una llamada a una herramienta de IA?

La acción se cancela y no se ejecuta. Configura las instrucciones del Agent para que explique la denegación, ofrezca una alternativa adecuada o pida una aclaración, en lugar de afirmar que la acción se completó.

¿Cómo puedo evitar que las credenciales aparezcan en una solicitud de aprobación de n8n?

Configura las credenciales de los servicios mediante los ajustes de credenciales de n8n. No pases secretos en las instrucciones ni en los parámetros de las herramientas, y revisa los parámetros que se muestran a quienes aprueban para que el mensaje incluya solo el contexto necesario para decidir.

¿Debería reintentar automáticamente una llamada a una herramienta que ha fallado?

Solo si repetir la operación es seguro para ese servicio y esa acción concretos. Un reintento podría duplicar un mensaje externo o un cambio en un registro. Comprueba el comportamiento del servicio de destino y distingue los errores que permiten reintentar de las acciones que requieren investigación.

Artículos relacionados