SQL Query Database Tool

El SQL Query Database Tool te permite ejecutar consultas SQL directamente desde tu dashboard de Nappai. Conecta tu base de datos y obtén un objeto Tool que puedes usar en flujos de trabajo con LLMs o en otras partes de tu automatización.

¿Cómo funciona?

Internamente el componente crea una instancia de CustomQuerySQLDataBaseTool, que es una herramienta de LangChain diseñada para ejecutar consultas SQL. Cuando seleccionas una base de datos en el campo SQLDatabase, el componente envuelve esa conexión y la expone como un objeto Tool. Este objeto puede ser pasado a un modelo de lenguaje o a cualquier otro proceso que requiera ejecutar consultas SQL de forma segura y controlada.

El flujo de trabajo es sencillo:

1. Selecciona la base de datos que quieres usar.
2. El componente crea el Tool con la conexión y la metadata necesaria.
3. Obtén el Tool a través del output y utilízalo donde lo necesites.

No se realizan llamadas externas; todo el procesamiento ocurre dentro de Nappai y la base de datos conectada.

Entradas

Campos de Entrada

• SQLDatabase: Conecta la base de datos que quieres consultar. Debes seleccionar un objeto de tipo SQLDatabase que ya esté configurado en tu dashboard.
  • Visible en: Todas las operaciones (el componente no tiene operaciones distintas).

Salidas

• Tool: Devuelve un objeto de tipo Tool (específicamente BaseTool). Este objeto contiene la lógica para ejecutar consultas SQL y puede ser usado en flujos de trabajo con LLMs o en cualquier otro componente que acepte un Tool.

Ejemplo de Uso

1. Añade el componente SQL Query Database Tool al flujo.
2. Conecta la salida de tu componente SQLDatabase al campo SQLDatabase del nuevo componente.
3. Obtén el output Tool y úsalo en un componente LLM Prompt:

   Prompt: "¿Cuál es el total de ventas del último trimestre?"
   Tool: [Tool]  # el Tool generado por SQL Query Database Tool

   El LLM podrá usar el Tool para ejecutar la consulta SQL y devolver la respuesta.

Componentes Relacionados

• CustomQuerySQLDataBaseTool – La herramienta subyacente que ejecuta las consultas SQL.
• NappaiBaseComponent – La clase base que provee la infraestructura de componentes de Nappai.
• SQLDatabase – Componente que configura y expone la conexión a la base de datos.

Consejos y Mejores Prácticas

• Revisa la sintaxis SQL antes de usarla en el LLM para evitar errores de ejecución.
• Limita los permisos de la base de datos a solo lo necesario para la consulta.
• Prueba la consulta en un entorno de desarrollo antes de desplegarla en producción.
• Utiliza parámetros en la consulta cuando sea posible para evitar inyección SQL.

Consideraciones de Seguridad

• Asegúrate de que la base de datos esté protegida con autenticación fuerte.
• Evita exponer datos sensibles en los logs del flujo.
• Si la base de datos contiene información confidencial, considera cifrar la conexión (SSL/TLS).