Manual do Usuário

O acesso é pelo Keycloak — não há login próprio da plataforma. Ao abrir o endereço, você é levado à tela de autenticação da empresa e volta autenticado.

O espaço de trabalho (tenant) vem do seu usuário. Cada espaço tem os próprios dados, conexões e painéis: o que você vê é o do seu espaço, sempre.

Quatro grupos:

O menu pode ser recolhido para ganhar espaço horizontal. O que aparece nele depende dos seus perfis — ver Perfis de Acesso.

Vale ler esta seção uma vez: quase toda dúvida de uso nasce de confundir dois destes conceitos.

É a tela onde as análises nascem.

Os campos do dataset, separados em Dimensões (o que agrupa), Medidas (o que se soma) e Métricas (cálculos nomeados, reutilizáveis).

O botão f+ cria um campo calculado; o Σ ao lado de uma métrica indica um cálculo salvo no dataset.

Disponível em Tabela e Dinâmica. Três tipos de regra:

O campo Regra por texto aceita linguagem natural (“destaque em vermelho vendas abaixo de 1000”) e a IA monta a regra.

O painel pode ser redimensionado pelo canto, e o tamanho fica guardado.

Também em Tabela e Dinâmica. É a ideia dos conjuntos de ícones do Excel: o valor cai numa faixa e a faixa define um símbolo.

Seis conjuntos prontos — Semáforo, Setas, Sinais, Bandeiras, Bolinhas, Estrelas — e o campo do símbolo aceita qualquer emoji ou texto curto colado.

Ao criar, os limites já vêm sugeridos a partir dos terços do intervalo real da coluna, arredondados. Ajuste-os à sua régua.

As faixas valem de cima para baixo: a primeira que casar define o símbolo.

Cada indicador escolhe onde aparece:

Para ter os dois, crie dois indicadores sobre a mesma medida.

A barra própria da dinâmica oferece:

Arraste a divisa entre as colunas para redimensioná-las.

Duplo clique em uma barra, fatia ou célula abre a janela de Detalhe com as linhas por trás daquele número.

Um dos tipos de apresentação. Em vez de um gráfico, a plataforma escreve a leitura dos dados em texto. O campo Pergunta direciona a análise (“compare com o mês anterior e aponte o que explica a queda”). Exige um conector LLM configurado.

A tela lista os datasets do espaço. Ao editar um, há seis abas.

Nome, descrição e a marca Fonte certificada (confiável), que sinaliza aos demais usuários que aquele dataset é oficial.

Mostra também a origem — e avisa quando a conexão de origem não existe mais: o dataset continua consultável com o que já foi materializado, mas não consegue se atualizar.

Cada campo tem:

Edite quantos quiser e use Salvar campos para gravar todos de uma vez; o contador mostra quantos estão com alteração pendente.

+ Campo calculado cria uma coluna por expressão SQL, por exemplo (receita - custo) / nullif(receita, 0).

Os perfis (roles) que podem ver e usar o dataset no Explorar. Vazio = visível a todos. Administradores sempre veem.

Define com que frequência os dados são trazidos da origem — vale para todas as consultas e painéis que usam o dataset.

Atenção com a carga incremental: ela não enxerga linhas excluídas na origem. Configure a recarga periódica de reconciliação — é o que impede a diferença de se acumular, e o melhor uso da expressão CRON, para cair fora do horário de pico.

Edita as células diretamente (até 500 linhas de amostra). É como se mantém uma planilha de metas ou uma tabela de apoio criada na plataforma.

Para datasets vindos de consulta: permite trocar o SQL que os alimenta.

Um fluxo transforma dados e gera um dataset. É a alternativa ao SQL para quem prefere montar a transformação passo a passo — e ao mesmo tempo comporta SQL e JavaScript onde eles forem necessários.

Cada passo mostra o resultado daquele ponto, com contagem de colunas e linhas de amostra. É assim que se confere a transformação sem executar o fluxo inteiro.

A prévia não chama serviços externos: passos de IA e de API aparecem com as colunas vazias. Use o Testar do próprio passo e depois Executar.

Preparar — Filtrar linhas · Colunas · Coluna calculada · Converter tipo · Ordenar · Limitar linhas · Remover duplicatas · Substituir texto · Dividir coluna

Combinar — Juntar (LEFT, INNER, FULL, ANTI, SEMI) · Empilhar · Juntar por semelhança (Jaro-Winkler ou Levenshtein)

Remodelar — Agrupar e resumir · Colunas viram linhas · Linhas viram colunas

Análise avançada — Detectar anomalias (z-score ou IQR, comparando dentro de cada grupo) · Faixas de valor (quantis ou intervalos iguais) · Normalizar escala · Correlação · Agrupar semelhantes (k-means) · Prever série · Preencher faltantes

Código e IA — SQL · Código (JavaScript) · Definir variável · Perguntar à IA · Buscar de API

O passo anterior chega como entrada e as origens pelo apelido. É uma consulta só, sem ponto e vírgula. Use ${variável} onde entra uma data de corte ou um parâmetro.

Recebe a linha (ou todas as linhas, no modo tabela) e a lista de variáveis. O painel lateral mostra como a linha chega, com a amostra real e os cuidados — principalmente com valores nulos, que derrubam o passo se usados sem verificação.

Classifica, extrai ou resume o conteúdo de cada linha com um modelo de linguagem. Traz exemplos prontos (Classificar, Extrair, Resumir, Sentimento).

Custo: cada pergunta distinta é uma chamada paga. Linhas que geram a mesma pergunta são perguntadas uma vez só — classificar mil linhas em dez categorias custa dez chamadas. Há uma trava de máximo de linhas.

Três modos: Enriquecer cada linha (uma chamada por valor distinto), Empilhar o resultado ou Juntar por chave. Também tem trava de linhas e um Testar em 5 linhas.

Depois da primeira execução bem-sucedida, o fluxo pode rodar sozinho na frequência escolhida.

Conecta tabelas de uma fonte, sugere os relacionamentos e gera datasets sem escrever SQL.

Cada relacionamento tem a opção Prevenir fan-out, que evita que uma junção de um-para-muitos infle as medidas.

O modelo pode ser ao vivo (consulta a fonte a cada uso, com pushdown) ou materializado (copia para o motor analítico).

Para quem escreve SQL.

Modelos prontos de dashboards, relatórios e apps, filtráveis por setor.

Escolha o modelo, aponte o dataset e a plataforma monta a estrutura — os campos do modelo são mapeados automaticamente para as colunas escolhidas.

Você também pode transformar seus próprios dashboards e relatórios em modelos, pelo botão Modelo dentro deles.

Uma tela só reúne os três, porque eles se compõem.

Uma grade de widgets. Cada widget tem cabeçalho com as ações:

Arraste a alça do canto inferior direito para mudar a altura.

Filtros aceitam três tipos de campo — valor (multisseleção), numérico (intervalo) e data (intervalo) — e oferecem:

Clicar num ponto do gráfico aplica cross-filter ao painel, conforme a configuração de Interação da análise.

Retratos (versões) guardam o estado do painel — capturados diariamente e a cada clique — e permitem comparar dois retratos indicador a indicador.

Composição livre, em fluxo vertical ou grade. Tipos de bloco:

Reúnem páginas e dashboards existentes como telas de um produto só, com nome, descrição, ícone, cor e tela inicial. Dois modos:

O ícone 📖 no cabeçalho aparece quando há orientação vinculada — e só quando há. Duas formas, que servem a coisas diferentes:

Nas telas públicas aparece apenas a nota. Os documentos da base exigem sessão, e publicá-los junto com o link exporia material interno.

Ao arrastar uma consulta salva para um painel ou página, fica registrado de qual consulta ela veio — o ícone de elo no cabeçalho indica isso. A configuração é lida da origem a cada abertura, inclusive no PDF e nas telas públicas.



Documentos em seções, feitos para virar arquivo.

Cada seção tem título, formato dos números, limite de linhas e largura (inteira ou metade — duas meias formam uma linha).

Mostrar legenda liga e desliga; Texto da legenda troca o nome da série. O campo mostra como placeholder o nome atual (sum_vendas), e apagá-lo volta ao original.

Na pizza a legenda lista as fatias, e o texto vem dos próprios dados — por isso o campo não aparece ali.

Mesmo desenho do bloco de parâmetro das Páginas: fonte de dados, campo, rótulo e multisseleção. O recorte é por fonte de dados — um parâmetro de uf não filtra seção que lê outra tabela.

Os parâmetros valem também nos arquivos exportados, e cada formato registra o recorte aplicado: parágrafo no PDF, resumo no Excel, cabeçalho no Word, capa no PowerPoint. Um arquivo filtrado que não diz por qual valor engana quem o receber adiante.

PDF, Excel, Word e PowerPoint. O PDF desenha os gráficos com a mesma paleta da tela.

Modelo transforma o relatório num modelo reaproveitável na Galeria.

Duas telas de consumo, para quem usa e não constrói:

Cinco recursos, na mesma tela.

Escolha o relatório, os destinatários, o formato do anexo e a frequência — intervalo ou expressão cron de seis campos (ex.: 0 0 8 * * MON-FRI = dias úteis às 8h), com fuso horário. Enviar agora testa na hora.

Vigiam uma consulta salva e disparam quando o valor passa de um limiar (maior que, menor que, igual a) ou quando foge do padrão (anomalia por desvio σ).

Canais: e-mail, in-app (sino) e webhook.

Testar mostra o valor atual e se dispararia agora.

Exporta o resultado de uma consulta salva — com seus filtros — em CSV ou XLSX e envia por e-mail no intervalo ou cron definido.

Disparam e-mail ou relatório quando o sistema de origem chama o webhook — por exemplo, um pedido confirmado. Copie a URL gerada e configure no sistema transacional. Nos textos de assunto e corpo, use  e os campos do payload como .

Assine uma métrica pelo botão Assinar no Pulse, dentro do modal Insights do Explorar. O Pulse verifica periodicamente e avisa no sino (e por e-mail) quando surge uma anomalia ou tendência — sem você precisar procurar.

Sem SMTP configurado, os envios ficam em dry-run: são registrados no log do servidor, mas não saem. Ver Configurações.

A base que a IA consulta ao responder — e de onde saem as orientações exibidas nos widgets.

Organize pastas e documentos Markdown. Crie na tela ou faça upload de .md, .txt, .csv, .json, .docx.

Cada documento pode ser vinculado a datasets: sem marcar nenhum, vale como conhecimento geral; marcando, o assistente usa aquele documento apenas nas conversas sobre os datasets escolhidos.

Os modelos de linguagem que a plataforma usa. Provedores suportados:

Um conector precisa estar ativo e marcado como padrão — sem isso, os recursos de IA não têm a quem perguntar. Testar confirma que o modelo responde.

Ollama e vLLM rodam na sua infraestrutura e não mandam dado nenhum para fora.

Presente no canto inferior direito. Permite:

Banco de dados, agrupados por família:

API REST, com autenticação Nenhuma, Basic, Token/JWT (Bearer) ou cabeçalho personalizado (API key), cabeçalhos extras e Caminho JSON para quando os registros vêm dentro de um envelope (resultado.itens).

Testar API confere antes de salvar.

Ao conectar, a plataforma lista as tabelas (ou índices). Selecione as que interessam: cada uma vira um dataset com o nome da tabela.

Manutenção do que já existe: renomear, trocar parâmetros, testar, excluir e definir quais perfis podem mexer em cada conexão.

Aqui, nenhum perfil marcado = só administrador — o oposto dos datasets, onde lista vazia libera. A diferença é proposital: nos datasets se lê dado; aqui se altera a credencial de um banco.

Excluir uma conexão em uso avisa quantos datasets deixarão de se atualizar.

Registro de acessos aos componentes de BI: quando, quem, tipo e componente.

Define quais funcionalidades cada perfil (role) pode acessar — é o que decide o menu de cada usuário.

Regras que valem a pena conhecer:

Segurança em nível de linha (RLS) fica na mesma área:

A partir daí, cada pessoa vê apenas as linhas que lhe cabem, em qualquer tela.

Formato de data e moeda — data, hora, moeda, separadores e casas decimais, com prévia. Vale para Explorar, Relatórios, dashboards e páginas.

“Segue o idioma” usa a convenção do idioma escolhido na barra superior. Prefira um formato fixo quando o material precisa sair igual para todo mundo.

E-mail (SMTP) — remetente, host, porta, usuário e senha. Sem habilitar envio real, tudo fica em dry-run.

Backup e portabilidade — exporta todos os elementos criados (dashboards, consultas, relatórios, automação, configurações) num único .json, e importa um pacote para restaurar ou migrar. Os dados brutos das fontes não são incluídos — apenas as definições. A inclusão de segredos (senhas e chaves) é opcional e explícita.

Comparação — Barras · Linhas · Área · Combinado · Cascata · Tornado · Bullet · Marimekko

Composição — Pizza · Rosca · Treemap · Sunburst · Funil · Stream graph

Relação — Dispersão · Bolhas · Correlação em matriz (heatmap) · Radar · Coordenadas paralelas · Sankey · Grafo · Árvore

Distribuição — Histograma · Boxplot

Evolução no tempo — Calendário · Gantt · Candlestick · Pulse

Número único — KPI · Tendência · Medidor (gauge)

Tabelas — Tabela · Tabela dinâmica

Geográfico — Mapa (país, UF, cidade, bairro)

Texto — Nuvem de palavras

Narrativa — Análise de IA

SUM · AVG · MIN · MAX · COUNT · COUNT DISTINCT · MEDIAN · P90 · P95 · STDDEV · VARIANCE

O símbolo da moeda e os separadores vêm das Configurações do espaço.

Alterei uma consulta salva e o painel não mudou. Painéis criados antes da versão que introduziu o vínculo guardam uma cópia solta. Adicione a consulta ao painel novamente: a partir daí ele acompanha a origem.

Um campo aparece com nome técnico (sum_vendas) nos filtros. Preencha o Rótulo do campo em Datasets → Campos. Ele vale para filtros, parâmetros, cabeçalhos e para a janela de detalhe.

O e-mail não chega. Confira em Configurações → E-mail se Habilitar envio real está ligado. Sem isso, os envios ficam em dry-run e só aparecem no log do servidor.

Os recursos de IA estão indisponíveis. É preciso um conector em Conectores LLM que esteja ativo e marcado como padrão.

A carga incremental está deixando linhas para trás. A carga incremental não enxerga exclusões na origem. Configure a recarga periódica de reconciliação na aba Sincronização do dataset.

O dataset parou de se atualizar. Veja a aba Identidade: se a conexão de origem foi excluída, o dataset continua consultável com o que já foi materializado, mas não se atualiza mais.

Não consigo ver um menu que meu colega vê. O menu depende dos perfis. Peça a um administrador para conferir em Perfis de Acesso.

Preciso que os números saiam iguais para todo mundo, em qualquer idioma. Em Configurações → Formato, escolha um formato fixo em vez de “Segue o idioma”.

Este manual descreve a plataforma como ela está. Recursos e telas evoluem — em caso de divergência, a tela é a referência.