Chatbot: Visualização de Dados com resultados

[giovanecarusoredacao]

Funcionalidade de criar visualizações de dados

@vrtornisiello Detalhes do que foi feito

Próximos passos:

• Testar em stanging;
• Alinhas identidade visual com Nay.

[vrtornisiello]

Exportação e gráficos de resultados de consultas

Permite que os usuários baixem e visualizem os resultados das consultas do chatbot. O agente pode exportar qualquer resultado como arquivo no formato escolhido e transformar um resultado em gráfico — ambos baseados nas linhas exatas retornadas por consultas previamente executadas (o modelo nunca inventa os dados).

Funcionalidades

• Exporta um resultado como arquivo: CSV, JSON Lines, Parquet, AVRO. Materializado sob demanda via um extract job do BigQuery → GCS → URL assinada de curta duração; o card de download mostra o tamanho e o nome reais do arquivo.
• Gera gráficos de um resultado: o agente descreve o gráfico em linguagem natural, uma etapa de visualização produz uma spec Vega-Lite v6 (validada e corrigida automaticamente) e o frontend a renderiza. Suporta barras, linhas, áreas, dispersão, histogramas, visões compostas/eixo duplo etc., com as cores da marca Base dos Dados.
• Dois pontos de entrada cada: as ferramentas conversacionais (export_query_result / chart_query_result, mediante pedido explícito) e os endpoints da interface (botões de exportar/gráfico por mensagem).
• Entre turnos: list_query_results permite ao agente encontrar e usar resultados de turnos anteriores.
• Proveniência/segurança: o servidor vincula as linhas exatas do resultado; a spec do modelo tem qualquer data/URL removida (sem invenção de dados, sem SSRF).

Limitações

• Sem mapas geográficos / coropléticos — exigiria geometria de fronteiras que o pipeline não fornece (possível trabalho futuro).
• Sem XLSX — o extract job do BigQuery não gera esse formato.
• Sem sandbox de código / computação arbitrária — os gráficos são gerados como specs, não executando código; qualquer agregação deve ser feita antes no SQL.
• Resultados expiram em ~24h após a consulta; um resultado expirado precisa ser reexecutado antes de exportar/plotar.
• Limites de tamanho: exportação limitada por MAX_EXPORT_BYTES; gráficos limitados por CHART_MAX_BYTES (os dados são embutidos na spec, então gráficos devem ser resumidos, não volumosos).
• Os gráficos são renderizados no cliente; a legibilidade de resultados densos é responsabilidade do modelo/prompt, não imposta pelo sistema.

Link da branch: https://github.com/basedosdados/chatbot/tree/feat/charts-and-exports.

[giovanecarusoredacao]

[colar atualização aqui em baixo]

[vrtornisiello]

Resumo do trabalho da última semana (01 – 08/09):

Mapas coropléticos do Brasil

• 3c4e14b: Adiciona mapas coropléticos do Brasil (estados e municípios) e simplifica o pipeline de gráficos.
• 1e38815: Adiciona a atribuição/crédito dos dados geográficos em app/assets.

Correções e ajustes finais no pipeline de gráficos

• 5a23506: Converte Decimal para número e passa a servir a geometria (TopoJSON) por URL, em vez de embutir no spec — o navegador busca e faz cache do arquivo diretamente, sem inflar o payload SSE nem os eventos persistidos.
• d3fb584: Remove o href dos specs de gráfico, fechando um vetor de XSS por clique.
• 6383512: Preserva códigos NUMERIC inteiros e torna mais robusta a junção da URL da geometria.
• ed802b3: Orienta, no prompt, a formatação de números e o uso de escalas logarítmicas nos gráficos.
• 86381f7: Reduz CHART_MAX_BYTES para 1MB.