Saltar al contenido principal

Qué es Datafala

Datafala es una API text-to-SQL: tu sistema envía una pregunta en lenguaje natural ("¿cuánto vendí del producto X en los últimos 6 meses?") y recibe de vuelta una consulta SQL validada, con parámetros con nombre, lista para ejecutarse en tu base de datos.

1. La persona pregunta en tu sistema  "¿cuánto vendí del producto X en los últimos 6 meses?"
2. Tu backend llama a Datafala        POST /v1/ask
3. Datafala devuelve                  { sql, params, explanation, request_id }
4. Tu backend lo ejecuta en tu base   con un usuario de solo lectura
5. Tu sistema muestra el resultado    y, si quieres, envía 👍/👎 a POST /v1/feedback

Qué hace la API​

  • Guarda, por cliente, la descripción de tu base de datos (el DDL de las tablas), descripciones de tablas y columnas, reglas de negocio, glosario y ejemplos de pregunta → SQL. Todo esto se registra en el panel.
  • Genera el SQL usando el LLM y la clave del propio cliente (OpenAI, Anthropic, Gemini, DeepSeek y otros). El costo de los tokens queda contigo y no se usa ninguna clave de la plataforma.
  • Pasa todo SQL generado por el SQL Guard, que solo acepta un único SELECT sobre las tablas y columnas registradas, con funciones permitidas y LIMIT aplicado. Consulta Seguridad.
  • Devuelve sql, params, las tablas usadas y una explicación breve en el idioma pedido.

Qué no hace la API​

La API nunca se conecta a tu base de datos

Datafala no recibe las credenciales de tu base de datos, no ejecuta SQL y no ve tus datos. Solo conoce el schema que registraste. Quien ejecuta la consulta es tu sistema, siempre con un usuario de solo lectura.

  • No controla qué filas puede ver cada usuario final. Si tu sistema tiene varias empresas o permisos por fila, aplica ese filtro en la base de datos (consulta Ejecutar el SQL).
  • No guarda los resultados de las consultas, porque nunca los ve.

Bases de datos compatibles​

Base de datosValor de dialectDrivers
PostgreSQLpostgrespsycopg 3, psycopg2, node-postgres (pg)
MySQL / MariaDBmysqlPyMySQL, mysqlclient, mysql2
Firebird 2.5+firebirdFDB (Python, Firebird 2.5+), firebird-driver (Python, Firebird 3+), FireDAC (Delphi), Jaybird (Java), node-firebird (Node.js)

El dialecto se elige al registrar el DDL en el panel y vale para todas las preguntas de ese schema. Para Firebird 2.5, usa FDB; firebird-driver requiere Firebird 3 o más reciente.

Direcciones​

QuéURL
APIhttps://app.datafala.com.br
Panel del clienteapp.datafala.com.br/login
Contactocontato@tisolutio.com.br

Siguiente paso: Primeros pasos.