Painel do cliente
O painel fica em app.datafala.com.br/login. É lá que o administrador do seu tenant prepara tudo o que a API usa para gerar o SQL. Schema e contexto entram só pelo painel; a API /v1 não altera configuração.
| Tela | Para que serve |
|---|---|
| Início | Resumo da configuração, perguntas dos últimos 30 dias e uso por usuários finais (ativos no mês, faixa e meses anteriores). |
| Schema | Dialeto (PostgreSQL, MySQL ou Firebird 2.5+) e DDL. Mostra tabelas, colunas e chaves estrangeiras reconhecidas; permite descrever e ocultar cada uma. Para Firebird, cole a extração do isql -x em SQL dialect 3. |
| Contexto | Regras de negócio e glossário em texto livre. |
| Exemplos | Pares pergunta → SQL (até 200), validados pelo SQL Guard ao salvar. |
| Playground | Testar perguntas com o mesmo pipeline do /v1/ask, vendo os motivos de rejeição sem mascaramento. |
| Histórico | Perguntas recentes com status, motivo da rejeição, avaliação e comentário do usuário, o prompt enviado à LLM e o botão "Promover a exemplo". |
| Avaliação | Até 50 casos pergunta → SQL esperado, executados em lote para medir a qualidade depois de mudar schema, contexto ou modelo. |
| Credenciais | Criar, listar e revogar API keys. |
| Configurações | Provedor, modelo e chave da sua LLM (com teste antes de salvar), nome do cliente, idioma padrão e tema do painel. |
Como melhorar as respostas
- Descreva o que não é óbvio. Uma coluna
stcom valoresA,C,Pprecisa de descrição ("status: A = ativo, C = cancelado, P = pendente"). - Oculte o que não deve ser usado. Colunas de dados pessoais ou internas não entram no prompt e são recusadas pelo Guard.
- Escreva regras no contexto. "Faturamento é a soma de
valor_totaldas vendas comstatus <> 'C'." Não coloque segredos ali. - Cadastre exemplos para as perguntas mais comuns e para as que deram errado. Um feedback 👍 no Histórico vira exemplo com um clique.
- Monte uma avaliação com as perguntas que importam e rode depois de cada mudança.
Atualizar o schema
Colar um novo DDL cria uma nova versão do schema. Descrições e marcações de oculto são copiadas para as tabelas e colunas de mesmo nome. As respostas já guardadas no histórico não são revalidadas contra o schema novo.