GuidesOneMux

Crea un flujo de trabajo de IA más seguro en n8n con validación, aprobación humana y fallos accionables

Un patrón práctico de n8n para evaluar de forma repetible las acciones generadas por IA, comprobar las entradas y salidas, exigir aprobación para herramientas de riesgo y dirigir los fallos hacia pasos de recuperación útiles.

AI

Resumen · TL;DR

Usa un conjunto de evaluación fijo y reglas explícitas de aprobación o rechazo antes de permitir que un AI Agent de n8n llame a herramientas con consecuencias. Valida las entradas y salidas, exige revisión humana para determinadas acciones y haz que cada ruta de fallo indique qué hacer a continuación.

Puntos clave

  • Separa la evaluación de la ejecución en vivo: ejecuta casos de prueba fijos en el flujo de trabajo antes de habilitar acciones reales.
  • Valida los campos de entrada obligatorios y la salida de la IA antes de usar cualquiera de ellos en pasos posteriores.
  • Usa el paso de revisión humana de n8n para las herramientas seleccionadas cuyas acciones requieran aprobación.
  • Trata la denegación, los datos no válidos, los tiempos de espera agotados y los errores de las herramientas como resultados distintos, con instrucciones claras de recuperación.
En esta página (7)

El patrón: evaluar primero, actuar después

Un flujo de trabajo de IA en n8n no debe tratar una respuesta plausible del modelo como permiso para actuar. Un diseño más seguro tiene dos rutas: una ruta de evaluación repetible que comprueba casos conocidos y una ruta en vivo que valida cada solicitud y se detiene para que una persona revise determinadas llamadas a herramientas con consecuencias.

La ruta de evaluación responde a la pregunta: «¿Este flujo de trabajo cumple nuestras reglas en estos casos?». El paso de aprobación responde a otra: «¿Debe realizarse esta acción concreta ahora?». Ninguno sustituye al otro. Una persona que revisa una sola solicitud no puede demostrar un rendimiento repetible, y un conjunto de pruebas no puede autorizar un borrado en vivo ni un mensaje externo.

La configuración siguiente es un diseño ilustrativo, no una exportación de flujo de trabajo probada. Los nombres de los nodos y las opciones disponibles pueden variar según la versión de n8n y la integración. Consulta la documentación de los nodos que utilices antes de implementar el flujo.

Define los límites y los casos de prueba antes de crear el flujo

Documenta qué puede hacer el flujo de trabajo, qué no debe hacer nunca y qué se considera un fallo de evaluación. Por ejemplo, un flujo que redacta una respuesta de soporte podría tener estos límites:

  • Puede clasificar y redactar; no puede enviar una respuesta sin aprobación.
  • Debe devolver una categoría de una lista acordada y un borrador no vacío.
  • No debe inventar un número de pedido cuando no se proporciona ninguno.
  • Debe detenerse cuando falten campos obligatorios o no se pueda analizar la salida.

Crea un conjunto pequeño y fijo de pruebas que incluya entradas habituales y problemáticas. Mantén los resultados esperados o las reglas de aceptación junto a cada caso; no uses únicamente ejemplos que la instrucción ya gestione bien.

Caso de pruebaCondición de entradaResultado esperado
Solicitud completaTexto y referencia válidosCategoría y borrador válidos; sin datos no compatibles
Falta la referenciaFalta la referencia obligatoriaRechazar o solicitar aclaración; sin acción de herramienta
Mensaje vacíoEl texto está en blancoFallo de validación de entrada
Solicitud poco claraEl mensaje tiene varios significados plausiblesSolicitar aclaración o derivar a una persona
Se solicita una acción de riesgoLa solicitud implica enviar o modificar datosSe requiere aprobación antes de ejecutar la herramienta
Salida del modelo con formato incorrectoFaltan campos o el JSON no es válidoFallo de validación; sin acción posterior

Decide de antemano cuántos casos deben superarse y qué fallos bloquean el lanzamiento. Por ejemplo, podrías exigir que se superen todos los casos relacionados con límites de seguridad y permitir una excepción documentada para un caso de formato no crítico. Estas son reglas del proyecto, no valores predeterminados de n8n.

Crea el flujo de trabajo por etapas

Una secuencia general útil es la siguiente:

  1. Activar y normalizar: acepta la solicitud, elimina los espacios innecesarios y asigna los campos entrantes a una estructura coherente.
  2. Validar la entrada: usa un nodo IF o Code para comprobar los campos obligatorios y los valores permitidos. Envía las solicitudes no válidas a una rama de respuesta o revisión sin llamar al agente.
  3. Ejecutar el AI Agent: proporciona instrucciones claras sobre el comportamiento permitido, los campos de salida y qué hacer cuando falte información.
  4. Validar la salida: comprueba que existan los campos obligatorios, que los valores estén dentro de los conjuntos permitidos y que la respuesta siga el formato esperado por el nodo siguiente.
  5. Revisar las herramientas seleccionadas: conecta mediante el paso Human review de n8n las herramientas que envían mensajes, modifican registros o tienen otras consecuencias relevantes.
  6. Ejecutar y registrar: ejecuta una llamada a una herramienta aprobada y registra después el resultado y el identificador del caso correspondiente para evaluarlo más adelante.

En el caso de una respuesta estructurada, valida después del agente en lugar de asumir que las instrucciones de la solicitud garantizan un resultado válido. Una comprobación ilustrativa en un nodo Code podría tener este aspecto, una vez que el elemento entrante tenga un objeto output analizado:

const result = $json.output;
const allowedCategories = ['billing', 'technical', 'other'];

const valid =
  result !== null &&
  typeof result === 'object' &&
  allowedCategories.includes(result.category) &&
  typeof result.draft === 'string' &&
  result.draft.trim().length > 0;

return [{
  json: {
    ...$json,
    validation: {
      valid,
      reason: valid ? null : 'Missing or invalid category or draft'
    }
  }
}];

Este ejemplo supone que la salida del modelo ya se ha analizado con la estructura indicada. Si tu agente devuelve una cadena, el análisis y la gestión de errores de análisis deben ocurrir antes de esta comprobación. Añade comprobaciones para tus propios límites, como la longitud máxima del borrador o los campos prohibidos, y dirige validation.valid con valor false a una rama que explique el problema. No envíes una salida no válida a un nodo de acción.

Exige aprobación para las acciones adecuadas

La función Human review de n8n permite que un flujo de trabajo se detenga cuando un AI Agent está a punto de usar una herramienta configurada para revisión. La persona revisora puede aprobar la acción, lo que permite que la herramienta se ejecute con la entrada especificada por la IA, o denegarla, lo que cancela la acción. La revisión puede utilizar canales como n8n Chat, Slack, Telegram, Microsoft Teams, Gmail y otros que aparecen en la documentación de n8n sobre human-in-the-loop.

Configura la revisión de forma selectiva: una consulta de solo lectura quizá no necesite el mismo control que el envío de un mensaje externo o la modificación de un registro. Proporciona a las personas revisoras el nombre de la herramienta, los parámetros propuestos y suficiente contexto para tomar una decisión. n8n documenta los valores $tool.name y $tool.parameters para construir un mensaje de revisión; muestra claramente la acción propuesta en lugar de pedir una aprobación vaga.

Indica también al agente qué significa una denegación. Sus instrucciones deben decirle que informe de que la acción no se realizó, que evite volver a intentar la misma acción y que ofrezca un paso siguiente seguro, como solicitar una aclaración a la persona que hizo la solicitud. Una llamada a una herramienta denegada es un resultado normal del flujo de trabajo, no un motivo para fingir que la tarea se completó.

Haz que los fallos sean accionables

Usa ramas separadas o rutas de error para los fallos que tengan soluciones diferentes. Un registro de fallo útil incluye el identificador del caso o de la ejecución, la etapa, la categoría del fallo, un motivo conciso y la siguiente acción. Evita incluir en los registros contenido sensible de la solicitud, salvo que tu política de gestión de datos lo permita.

  • Fallo de validación de entrada: identifica el campo que falta o no está permitido y solicita una entrada corregida.
  • Fallo de validación de salida: registra qué regla falló, detén el flujo antes de cualquier acción y deriva el caso para revisar la solicitud o el flujo de trabajo.
  • Aprobación denegada: marca la acción como cancelada, informa a la persona solicitante y sugiere una alternativa segura.
  • Fallo o tiempo de espera agotado de una herramienta: informa de que la ejecución no está confirmada y proporciona una ruta de reintento o comprobación manual. No afirmes que la acción se realizó correctamente solo porque el agente solicitó la herramienta.

Para los fallos operativos, configura la gestión de errores de n8n según tu implementación y los nodos implicados. Prueba deliberadamente la ruta de fallo; un flujo que solo gestiona el caso correcto no está listo para acciones con consecuencias.

Ejecuta una evaluación repetible

Mantén las entradas de prueba y los resultados esperados en una fuente estable, como una tabla de datos controlada, y ejecútalos mediante las mismas etapas de validación y del agente. Registra la versión del flujo de trabajo, el ID del caso, el resultado de aprobación o rechazo y el motivo del fallo. Evita cambiar los casos de prueba a mitad de una comparación; si modificas una instrucción o una regla, vuelve a ejecutar el mismo conjunto y registra por separado los casos nuevos.

Una lista de comprobación práctica para el lanzamiento:

  • Las entradas obligatorias y los valores de salida permitidos están definidos de forma explícita.
  • El conjunto de pruebas cubre casos ausentes, ambiguos, con formato incorrecto y de riesgo.
  • Las salidas no válidas no pueden llegar a los nodos de acción.
  • Las herramientas de riesgo requieren revisión y la denegación tiene una respuesta definida.
  • Los errores y tiempos de espera agotados de las herramientas no generan mensajes de éxito falsos.
  • Los resultados de la evaluación pueden asociarse con una versión del flujo de trabajo y un caso.

Conclusión

En n8n, combina casos de prueba fijos con la validación de entradas y salidas para que el comportamiento de la IA sea medible, y usa Human review para controlar determinadas llamadas a herramientas en vivo. Las ramas de fallo explícitas cierran la brecha entre «el flujo de trabajo se detuvo» y «alguien sabe qué hacer a continuación».

FAQ

¿La aprobación humana sustituye las pruebas de un flujo de trabajo de IA en n8n?

No. La aprobación permite que una persona acepte o deniegue una llamada a una herramienta propuesta concreta. Un conjunto de evaluación fijo comprueba el comportamiento del flujo de trabajo en casos repetibles. Usa ambos cuando el flujo necesite un comportamiento predecible y supervisión para acciones con consecuencias.

¿Puede n8n exigir aprobación solo para algunas herramientas de un AI Agent?

Sí. n8n documenta la revisión humana para todas las herramientas conectadas a un AI Agent o para herramientas individuales seleccionadas, lo que permite centrar la revisión en las acciones de mayor riesgo.

¿Qué debe ocurrir cuando una persona revisora deniega una llamada a una herramienta?

La acción debe permanecer cancelada. Configura el agente para explicar que no se realizó, evitar presentarla como completada y ofrecer una alternativa segura o solicitar una aclaración.

¿Cómo pruebo una salida de IA con un formato incorrecto?

Incluye un caso en el que falten campos obligatorios o no se pueda analizar la respuesta. Dirige los fallos de análisis y validación del esquema lejos de los nodos de acción, registra la regla que falló y comprueba que no se ejecute ninguna herramienta.

Artículos relacionados