Descripción general del flujo de trabajo

Este es un flujo de trabajo de asistente inteligente basado en IA para interactuar con bases de datos PostgreSQL mediante conversación, que permite a los usuarios realizar consultas a la base de datos utilizando lenguaje natural. El flujo aprovecha modelos lingüísticos de OpenAI para interpretar la intención del usuario, generar y ejecutar automáticamente consultas SQL, y devolver los resultados de forma amigable.

Funcionalidades principales

Generación inteligente de consultas
El flujo utiliza un Agente de IA para interpretar las solicitudes del usuario en lenguaje natural y generar automáticamente sentencias SQL compatibles con la estructura de la base de datos. La IA garantiza que los nombres de las tablas incluyan el prefijo correcto del esquema (schema), evitando errores en las consultas.

Conocimiento de la estructura de la base de datos
El sistema puede obtener automáticamente información del esquema de la base de datos, listas de tablas y definiciones detalladas de cada tabla (incluyendo nombres de columnas, tipos de datos, relaciones de claves foráneas, etc.), permitiendo así que la IA genere consultas precisas.

Memoria contextual en conversaciones
Incluye una función de historial de chat que, por defecto, conserva los últimos 5 mensajes del diálogo, permitiendo a la IA comprender el contexto y ofrecer una experiencia conversacional más coherente.

Componentes del flujo de trabajo

Nodo desencadenante

• When chat message received: Disparador de mensajes de chat que recibe las solicitudes de consulta del usuario.

Nodos de procesamiento central

• AI Agent: Nodo de agente inteligente que coordina todo el proceso de consulta, utilizando el modo Functions Agent de OpenAI.
• OpenAI Chat Model: Emplea el modelo GPT-4o-mini para proporcionar capacidades de IA.
• Chat History: Módulo de memoria con ventana deslizante que gestiona el historial de la conversación.

Nodos de herramientas (herramientas invocables por el Agente de IA)

1. Execute SQL Query: Ejecuta la consulta SQL generada por la IA.
2. Get DB Schema and Tables List: Obtiene todos los nombres de tablas y sus esquemas correspondientes en la base de datos.
3. Get Table Definition: Obtiene la definición detallada de una tabla específica, incluyendo columnas, tipos de datos, restricciones y relaciones de claves foráneas.

Instrucciones del sistema (prompt)

El asistente de IA está configurado como un asistente especializado en bases de datos, con las siguientes responsabilidades principales:

• Ejecutar consultas a la base de datos según las solicitudes del usuario.
• Generar consultas SQL personalizadas para agregar datos.
• Asegurar que cada nombre de tabla incluya el prefijo correcto del esquema.
• Obtener todos los datos necesarios para su análisis antes de responder al usuario.

Características técnicas

Gestión automática de esquemas
El flujo identifica y gestiona automáticamente los esquemas de la base de datos, asegurando que las consultas SQL generadas tengan sintaxis correcta.

Análisis inteligente de datos
La IA no solo ejecuta consultas, sino que también analiza los datos devueltos, ofreciendo al usuario explicaciones significativas e ideas útiles.

Selección flexible de modelos
Permite reemplazar el modelo de chat por otros diferentes, lo que ofrece buena capacidad de expansión.

Ventana contextual personalizable
Se puede ajustar la cantidad de historial de chat conservado, logrando un equilibrio entre rendimiento y comprensión contextual.

Casos de uso

• Analistas de negocio realizando consultas rápidas sobre datos operativos.
• Personal no técnico accediendo a la base de datos mediante lenguaje natural.
• Exploración de datos y consultas ad hoc.
• Generación automatizada de informes.
• Aprendizaje y comprensión de la estructura de la base de datos.

Requisitos de configuración

1. Credenciales de la base de datos PostgreSQL.
2. Credenciales de la API de OpenAI.
3. Opcional: ajustar la longitud de la ventana del historial de conversación (5 mensajes por defecto).
4. Opcional: activar el flujo de trabajo para hacer el chat públicamente accesible.