Chat-to-SQL: Pregunta a tu base de datos en español (guía técnica)

¿Qué es Chat-to-SQL?

Chat-to-SQL es una arquitectura que combina Retrieval-Augmented Generation (RAG) con modelos de lenguaje para traducir preguntas en español a consultas SQL ejecutables.

No es magia: es ingeniería aplicada con un stack probado.

Arquitectura del sistema

Usuario → Pregunta en español
    ↓
Embedding del catálogo (pgvector)
    ↓
Contexto relevante + Schema
    ↓
LLM genera SQL
    ↓
Validación + Ejecución
    ↓
Respuesta en lenguaje natural

Stack técnico

• PostgreSQL 16 con extensión pgvector para embeddings
• FastAPI como API de inferencia
• LangChain para orquestación del pipeline RAG
• Fine-tuning del modelo con el catálogo específico del cliente

Precisión y limitaciones

En nuestros despliegues, el sistema alcanza:

• 94% de precisión en consultas de inventario
• 87% de precisión en consultas financieras complejas
• < 2 segundos de latencia media

Las consultas que fallan suelen ser ambiguas o referirse a datos que no existen en el schema. El sistema aprende con cada corrección.

Implementación típica: 10 días al piloto

1. Días 1-5: Conexión al ERP, extracción de schema, generación de embeddings
2. Días 6-10: Validación con datos reales, ajustes y despliegue del piloto acotado

Ver demo interactiva →