Claix Retrieve frente a frameworks de text-to-SQL de código abierto: la forma más segura de dar acceso a bases de datos a agentes IA

¿Qué es Claix Retrieve?

Claix Retrieve es un servicio de recuperación controlada de bases de datos para agentes de IA. Conectas una base SQL compatible, publicas un Data Map, creas rutas que autorizan tablas y columnas concretas y las adjuntas a un agente Retrieve. El agente responde usando solo los datos y las reglas de sus rutas.

Una ruta no es un prompt. Es un límite técnico: las tablas y columnas que el agente puede usar, más una guía en lenguaje llano sobre cómo interpretar los datos. Si la información no está en la ruta, Claix no inventa un valor ni consulta fuera de ese límite.

Cómo funciona Claix Retrieve

Cuando tu aplicación llama a un agente Retrieve, Claix autentica la petición, identifica el agente, elige una ruta, propone una consulta de solo lectura, la valida, la ejecuta en la base conectada y devuelve filas crudas o un valor tipado.

La validación comprueba que sea una sola sentencia de lectura y que use solo las tablas y columnas de la ruta. Si no cumple, Claix la rechaza y puede reintentar con una consulta corregida, hasta tres veces.

Por qué un prompt no es un control de seguridad

Decirle a un modelo “nunca leas la columna de salario” es una petición, no un permiso. Un mensaje, un documento o un valor guardado en la base puede contener instrucciones que cambien el comportamiento del modelo. Eso es prompt injection, y funciona porque el modelo trata el texto como texto.

Retrieve no usa el prompt como límite de seguridad. La ruta define tablas y columnas. El rol limita lo que Claix puede leer. El validador rechaza lo que queda fuera de la ruta.

Modos de respuesta

Hay dos modos: raw y reasoned. Se configuran en el agente, en el Dashboard, y no se envían en cada petición. En reasoned los tipos son string, int, boolean, timestamp, timestamptz, date, json, array:string y array:int.

Qué permite y qué bloquea

Dentro de la ruta, Claix puede filtrar, unir tablas de la ruta, agrupar, ordenar, contar, sumar, promediar y usar funciones de fecha, texto y ventana. También puede devolver listas y JSON. Fuera de ese límite bloquea todo lo que no sea un único SELECT de solo lectura.

Claix Retrieve frente a Vanna AI

Vanna es un framework de Python de código abierto para text-to-SQL. Construye un almacén vectorial con metadatos, documentación y ejemplos, y un LLM genera el SQL, lo ejecuta y devuelve resultados. Es una base para aplicaciones a medida. La gobernanza, el determinismo, la auditoría y la operación quedan en el desarrollador. Su repositorio oficial se archivó y pasó a solo lectura en marzo de 2026, lo que cambia el cálculo de mantenimiento de un despliegue nuevo.

Por qué Retrieve es más seguro que montar el text-to-SQL tú

Vanna se puede hacer más seguro con un usuario de solo lectura, revisión de consultas, un proxy y aislamiento transaccional. Esas protecciones las diseña, implementa, prueba y mantiene tu equipo. En Retrieve forman parte del producto: rol de solo lectura, tablas y columnas por ruta, validación antes de ejecutar, límites de resultado y trazas.

Claix Retrieve frente a Wren AI

Wren AI es una opción de código abierto para consultar datos en lenguaje natural. Ofrece un motor GenBI apoyado en MDL y una capa de contexto legible, útil si quieres construir tú la analítica gobernada. Wren te da un motor que operar. Claix te da un límite de recuperación gestionado.

Claix Retrieve frente a SQLCoder y modelos locales

SQLCoder y modelos locales parecidos dan el máximo control del modelo y de la inferencia. Encajan en entornos sensibles, aislados o con un equipo fuerte de MLOps. Un modelo local no resuelve el acceso a la base. Sigues necesitando conexión, validación, límites de filas, tiempos de espera, auditoría y permisos.

Claix Retrieve frente a capas semánticas

Capas como Cube, dbt Semantic Layer y Wren AI mejoran la consistencia al definir métricas, dimensiones y relaciones una vez. Sirven para analítica gobernada. Retrieve es más estrecho y más operativo: un agente responde una pregunta concreta sobre un subconjunto controlado de una base en vivo. No sustituye una plataforma semántica.

Claix Retrieve frente a servidores MCP de bases de datos

Un servidor MCP expone la base como herramienta de un cliente de IA. Sirve para desarrollo local, prototipos y exploración interna de confianza. No es, por usarse, un límite de producción. Retrieve está pensado como ese límite: autorización por ruta, validación, ejecución de solo lectura y trazas.

Por qué encaja mejor en agentes de producción

Un agente de producción necesita comportamiento predecible, un alcance limitado, errores claros, una traza y un límite de seguridad que no dependa del prompt.

Arquitectura de producción recomendada

La arquitectura más sólida no depende de un solo control. Combina mínimo privilegio, autorización por ruta, validación, límites de resultado, trazas y monitorización. Retrieve es la capa de lectura. La base sigue siendo el límite técnico final. Las escrituras corresponden a Claix Guard, no a Retrieve.

Checklist de implementación

• Crea un rol de solo lectura dedicado.
• Concede solo las tablas y columnas que el agente necesita.
• No concedas escritura, administración ni operaciones destructivas.
• Publica un Data Map y revísalo antes de crear rutas.
• Crea una ruta por propósito de negocio.
• Selecciona solo las tablas y columnas de cada ruta.
• Escribe una guía clara de códigos, estados y reglas.
• Adjunta a cada agente solo las rutas necesarias.
• Prueba las rutas en el Sandbox con preguntas reales.
• Revisa Traces para detectar consultas o errores inesperados.
• Usa límites de filas y tiempos de espera en tu base cuando proceda.
• Trata los resultados como datos no fiables.
• Mantén la autorización por persona, el row-level security y el aislamiento de inquilinos en la base o en la aplicación.

Conclusión

Los frameworks de text-to-SQL de código abierto dan flexibilidad y también responsabilidad: la capa de acceso, la validación, los permisos, los errores, los registros y el mantenimiento. Claix Retrieve está pensado para equipos que quieren recuperación de producción sin operar otro sistema de seguridad. El límite es explícito, las consultas se validan antes de ejecutarse, la respuesta puede ser cruda o tipada, y cada petición deja traza. Para agentes que necesitan acceso controlado a bases SQL, es la opción más segura y más manejable.