Panel del cliente
El panel está en app.datafala.com.br/login. Ahí el administrador de tu tenant prepara todo lo que la API usa para generar el SQL. El schema y el contexto entran solo por el panel; la API /v1 no modifica la configuración.
| Pantalla | Para qué sirve |
|---|---|
| Inicio | Resumen de la configuración, preguntas de los últimos 30 días y uso por usuarios finales (activos en el mes, tramo y meses anteriores). |
| Schema | Dialecto (PostgreSQL, MySQL o Firebird 2.5+) y DDL. Muestra las tablas, columnas y claves foráneas reconocidas; permite describir y ocultar cada una. Para Firebird, pega la extracción de isql -x en SQL dialect 3. |
| Contexto | Reglas de negocio y glosario en texto libre. |
| Ejemplos | Pares pregunta → SQL (hasta 200), validados por el SQL Guard al guardarlos. |
| Playground | Probar preguntas con el mismo flujo de /v1/ask, viendo los motivos de rechazo sin enmascarar. |
| Historial | Preguntas recientes con estado, motivo del rechazo, valoración y comentario del usuario, el prompt enviado al LLM y el botón "Promover a ejemplo". |
| Evaluación | Hasta 50 casos pregunta → SQL esperado, ejecutados en lote para medir la calidad después de cambiar el schema, el contexto o el modelo. |
| Credenciales | Crear, listar y revocar API keys. |
| Configuración | Proveedor, modelo y clave de tu LLM (con prueba antes de guardar), nombre del cliente, idioma por defecto y tema del panel. |
Cómo mejorar las respuestas
- Describe lo que no es obvio. Una columna
stcon valoresA,C,Pnecesita una descripción ("estado: A = activo, C = cancelado, P = pendiente"). - Oculta lo que no debe usarse. Las columnas de datos personales o internos no entran en el prompt y son rechazadas por el Guard.
- Escribe reglas en el contexto. "La facturación es la suma de
valor_totalde las ventas constatus <> 'C'." No pongas secretos ahí. - Registra ejemplos para las preguntas más comunes y para las que salieron mal. Un feedback 👍 en el Historial se convierte en ejemplo con un clic.
- Arma una evaluación con las preguntas que importan y ejecútala después de cada cambio.
Actualizar el schema
Pegar un nuevo DDL crea una nueva versión del schema. Las descripciones y las marcas de oculto se copian a las tablas y columnas con el mismo nombre. Las respuestas ya guardadas en el historial no se vuelven a validar contra el schema nuevo.