Generador automático de SQL con IA y Depurador de Errores de PostgreSQL - Flujo de trabajo de n8n

• Desarrolladores de bases de datos que buscan un entorno de pruebas (sandbox) SQL asistido por IA.


• Equipos técnicos que necesitan generación de SQL automatizada y validada.


• Usuarios de n8n que buscan ejemplos avanzados de integración de IA y bucles de gestión de errores.


• Cualquiera que desee una plantilla de n8n lista para usar para interactuar con bases de datos mediante lenguaje natural.

Esta plantilla avanzada de flujo de trabajo de n8n resuelve el importante desafío de validar manualmente el SQL generado por la IA. Al integrar modelos de lenguaje grandes (LLM) como GPT (vía OpenAI u OpenRouter) directamente con una base de datos PostgreSQL, esta automatización de n8n crea una herramienta de desarrollo SQL muy eficiente y con depuración automática. El valor principal de este flujo de trabajo de n8n reside en su bucle de gestión de errores integrado. Si la ejecución inicial del SQL falla en el entorno de pruebas, el sistema captura automáticamente los detalles del error a través de un nodo dedicado de n8n (ExecuteAIresult), devuelve el error a la IA para que se autocorrija y reintenta la ejecución. Este potente bucle garantiza que la salida siempre sea ejecutable, convirtiéndolo en un flujo de trabajo de n8n muy sólido y fiable.

Todo el proceso se inicia mediante un disparador (trigger) especializado de n8n y avanza a través de varios pasos condicionales para gestionar la interacción con la IA y la ejecución de la base de datos.

1. Disparador y Configuración: El flujo de trabajo de n8n comienza con el disparador de n8n When chat message received, capturando la solicitud en lenguaje natural del usuario y parámetros de configuración cruciales, como el aiProvider deseado y la configuración de autoErrorFixing. Posteriormente, el nodo de n8n localVariables configura el prompt de instrucción estricto y detallado necesario para dirigir a la IA a actuar como un 'Desarrollador Senior de PostgreSQL', asegurando una salida SQL estructurada.


2. Orquestación de la IA: El flujo se ramifica basándose en el aiProvider. Si se selecciona OpenAI, la plantilla de n8n utiliza la API de Assistant para una gestión fluida del historial. Si se elige OpenRouter, se utiliza el nodo de n8n Simple Memory para mantener el contexto conversacional.


3. Generación de SQL: Los nodos principales de n8n de IA (OpenAIMainBrain u OpenRouterAgent) generan el script SQL completo, que incluye la creación del esquema (CREATE TABLE), la inserción de datos simulados (mock data) y la consulta de solución final.


4. Ejecución y Gestión de Errores: El nodo de n8n de PostgreSQL ExecuteAIresult intenta ejecutar el código generado. Si tiene éxito, se captura el resultado. Si se produce un error, el flujo comprueba el parámetro AutoErrorFixing.


5. Bucle de Depuración: Si la corrección automática está activada, el nodo de n8n GenerateErrorPrompt construye una instrucción específica detallando el error de ejecución. Esta instrucción se envía de vuelta a la IA para su refinamiento, creando un bucle. El nodo de n8n IsMaxAutoErrorReached actúa como salvaguarda, limitando el número de iteraciones del bucle (a 4) para evitar una ejecución indefinida y costosa, asegurando que esta potente plantilla de n8n siga siendo rentable.

Para implementar este potente flujo de trabajo de n8n, sigue estos pasos:

1. Importar: Copia el JSON proporcionado e impórtalo en tu instancia de n8n autohospedada o en la nube.


2. Credenciales de PostgreSQL: Localiza el nodo de n8n ExecuteAIresult y configura las credenciales de conexión a PostgreSQL. Esta base de datos actúa como el entorno de pruebas SQL donde se ejecuta el código generado.


3. Credenciales de IA: Actualiza las credenciales tanto para los nodos de n8n de OpenAI como de OpenRouter, dependiendo del proveedor que planees utilizar. Asegúrate de que tus credenciales tengan los permisos necesarios.


4. Configuración: El disparador inicial de n8n When chat message received requiere datos de entrada específicos (ej. sessionId, chatInput, aiProvider). Asegúrate de que tu aplicación o frontend proporcione estos parámetros correctamente al invocar este flujo de trabajo de n8n a través de su ID de webhook.


5. Pruebas: Ejecuta el flujo de trabajo de n8n con una solicitud de prueba de consulta SQL para verificar que la IA puede generar, ejecutar y corregir errores automáticamente.

When chat message received (LangChain Chat Trigger): El disparador inicial de n8n que captura la entrada del usuario (instrucción en lenguaje natural) y parámetros de configuración requeridos como aiProvider, model y autoErrorFixing.
localVariables (Set): Inicializa la instrucción principal (prompt) para la IA, definiendo su rol como desarrollador senior de PostgreSQL y estableciendo las estrictas reglas de formato SQL requeridas por esta plantilla de n8n.
OpenAIMainBrain (OpenAI): El nodo clave de n8n para usuarios de OpenAI, que interactúa con la API de Assistant de OpenAI. Gestiona los hilos de mensajes y aprovecha los asistentes existentes o crea uno nuevo basándose en el modelo especificado en los datos del disparador de n8n.
OpenRouterAgent (LangChain Agent): El nodo principal de n8n para usuarios que optan por OpenRouter. Utiliza el nodo de n8n Simple Memory para mantener el historial de la sesión de la IA, adaptando el flujo de trabajo de n8n para diferentes proveedores de LLM.
ExecuteAIresult (Postgres): El nodo crítico de n8n para bases de datos. Intenta ejecutar el script SQL completo generado por la IA. Está configurado para continuar hacia la salida de error si la ejecución falla, facilitando el bucle de autocorrección.
GenerateErrorPrompt (Code): Cuando falla la ejecución, este nodo personalizado de n8n genera una nueva instrucción (prompt) muy específica. Esta instrucción incluye la solicitud original del usuario y el mensaje de error técnico de PostgreSQL, indicando a la IA que corrija la consulta.

• IsMaxAutoErrorReached (If): Un nodo de n8n para el control de flujo que cuenta cuántas veces se ha ejecutado el bucle de corrección de errores (limitado a 4 intentos) para prevenir ciclos de ejecución infinitos y costosos en este flujo de trabajo de n8n.