> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crie um dashboard a partir de dados

> Transforme um CSV público, planilha, banco de dados, conector de warehouse ou API em um dashboard que responde a uma pergunta clara.

export const AiPrompt = ({children}) => {
  return <CodeBlock className="relative block font-sans whitespace-pre-wrap break-words">
      <div className="pr-7">
        {children}
      </div>
    </CodeBlock>;
};

Um dashboard ajuda alguém a tomar uma decisão a partir de dados.

Você vai construir um **Global Progress Explorer** a partir de um CSV público: dados em nível de país com ano, população, continente, expectativa de vida e PIB per capita.

## O que você vai conquistar

Ao final deste guia, você terá:

* Um dashboard Global Progress Explorer construído a partir de um CSV público realista.
* Métricas resumidas para países, população, expectativa de vida e PIB per capita.
* Gráficos e filtros que mostram como o progresso mudou ao longo do tempo.
* Uma forma de verificar se os números do dashboard correspondem aos dados de origem.
* Um dashboard compartilhável ou publicável para as partes interessadas.

## O que você vai aprender

Você vai aprender como:

* Começar com uma decisão, não com um tipo de gráfico.
* Pedir ao Agent para construir um dashboard a partir de um CSV público.
* Verificar cálculos em relação aos dados subjacentes.
* Adicionar filtros e um resumo de insights.
* Decidir quando um dashboard precisa de login, atualização, exportações ou dados conectados.

## Para quem é este guia

Use este guia se você tem dados de clientes, vendas, produto, operações, pesquisa ou públicos e precisa de um dashboard que as pessoas possam entender.

Isso é útil para analistas, operadores, fundadores, PMs, educadores e equipes que precisam transformar dados brutos em decisões.

## Defina a decisão

Antes de construir, anote a decisão que o dashboard deve apoiar.

Para o dataset de progresso global:

* **Pergunta**: Onde a expectativa de vida e o PIB per capita melhoraram ao longo do tempo?
* **Público**: equipes de educação, pesquisa, estratégia ou organizações sem fins lucrativos.
* **Métricas úteis**: contagem de países, intervalo de anos, última mediana de expectativa de vida, população total representada e mediana do PIB per capita.
* **Filtros úteis**: continente, país e intervalo de anos.

Se você não consegue declarar a decisão, o dashboard se tornará uma coleção de gráficos em vez de uma ferramenta útil.

## Construa a partir de um CSV público

Use um dataset público positivo com campos significativos e linhas suficientes para explorar.

Dataset: [CSV de progresso global Gapminder](https://raw.githubusercontent.com/plotly/datasets/master/gapminderDataFiveYear.csv)

Peça ao Agent para construir o dashboard a partir desse CSV:

<AiPrompt>
  Construa um dashboard Global Progress Explorer a partir deste CSV público:<br />
  [https://raw.githubusercontent.com/plotly/datasets/master/gapminderDataFiveYear.csv](https://raw.githubusercontent.com/plotly/datasets/master/gapminderDataFiveYear.csv)<br />
  O dashboard deve ajudar uma equipe de educação ou pesquisa a entender como a expectativa de vida, a população e o PIB per capita mudaram entre países e continentes de 1952 a 2007.<br />
  Inclua cards resumidos para total de países, intervalo de anos, última mediana de expectativa de vida, população total representada e última mediana de PIB per capita.<br />
  Adicione um gráfico de linhas para expectativa de vida ao longo do tempo por continente.<br />
  Adicione um gráfico de bolhas onde o PIB per capita está no eixo x, a expectativa de vida está no eixo y, o tamanho da bolha representa a população e a cor representa o continente.<br />
  Adicione um gráfico de barras mostrando os países com os maiores ganhos de expectativa de vida entre seu primeiro e último ano no dataset.<br />
  Adicione filtros para continente, país e intervalo de anos.<br />
  Inclua um breve resumo de insights que explica os maiores padrões e quais regiões ou países melhoraram mais.<br />
  Mostre como as métricas-chave são calculadas para que eu possa verificar os números.<br />
  Torne o dashboard polido, responsivo e fácil de ler no desktop e mobile.
</AiPrompt>

## Verifique seu trabalho

Abra o Preview e verifique o dashboard antes de compartilhá-lo.

Verifique se:

* O total de países corresponde ao número de países únicos no CSV.
* O intervalo de anos mostra 1952 a 2007.
* A última mediana de expectativa de vida usa o último ano no dataset.
* Os totais de população usam os países e anos filtrados.
* Os filtros atualizam os cards resumidos e os gráficos.
* O gráfico de bolhas usa PIB per capita, expectativa de vida, população e continente corretamente.
* O resumo de insights corresponde ao que os gráficos mostram.
* O dashboard funciona em uma tela de tamanho de telefone.

Se um número parecer diferente do esperado, peça ao Agent para mostrar o cálculo.

<AiPrompt>
  A última mediana de expectativa de vida parece diferente do que esperava.<br />
  Mostre-me como você a calculou a partir do CSV.<br />
  Verifique se você usou apenas linhas do último ano nos dados filtrados.<br />
  Atualize o cálculo se necessário e me diga como verificá-lo.
</AiPrompt>

## Adicione filtros e exportações

Após o primeiro dashboard funcionar, peça ao Agent pela interação que ajuda o público a explorar os dados.

<AiPrompt>
  Adicione um painel de exploração para o dashboard de progresso global.<br />
  Deixe-me filtrar por continente, país e intervalo de anos.<br />
  Adicione um botão para exportar os dados do gráfico filtrado para CSV.<br />
  Mantenha os cards resumidos e o resumo de insights sincronizados com os filtros.
</AiPrompt>

Os dashboards também podem suportar exportação de PDF, exportação de CSV de gráfico, atualização, atualização automática, modo claro/escuro e resumos de análise. Veja [Visualização de Dados](/pt/references/artifact-types/data-apps) para a visão geral do conceito.

## Use dados conectados quando necessário

Use um CSV público quando estiver aprendendo ou prototipando. Use uma fonte de dados conectada quando o dashboard deve se manter atualizado.

Você pode conectar dashboards a:

* Um banco de dados de app Replit.
* Um conector de warehouse como BigQuery, Databricks ou Snowflake.
* Ferramentas de análise como Segment, Amplitude ou Hex.
* APIs externas.

Para dados de warehouse, peça ao Agent para explicar os campos e consultas que usa.

<AiPrompt>
  Crie um dashboard de crescimento usando nosso conector de warehouse.<br />
  Identifique os campos de cliente, uso de produto, faturamento e retenção necessários.<br />
  Construa gráficos para clientes ativos ao longo do tempo, crescimento de conta por segmento e receita de expansão por plano.<br />
  Explique os campos e cálculos que você usou para que eu possa verificar o dashboard.
</AiPrompt>

Para detalhes de configuração e disponibilidade, veja [Conectores de Dados](/pt/connectors/warehouses/overview).

## Compartilhe o dashboard

Compartilhe o dashboard quando os números forem confiáveis.

Se o dashboard usa dados privados de clientes ou negócios, adicione controle de acesso antes de compartilhar amplamente. Para dados públicos ou de amostra, você pode publicar e compartilhar a URL diretamente.

Pergunte aos revisores:

> Revise o dashboard de progresso global e me diga qual história de região ou país você destacaria primeiro, e por quê.

## Você terminou quando

* O dashboard carrega o CSV público.
* Cards resumidos e gráficos respondem à pergunta de progresso.
* Você verificou pelo menos uma métrica-chave manualmente.
* Os filtros atualizam o dashboard corretamente.
* O resumo de insights corresponde aos dados.
* Você sabe se o dashboard deve permanecer público, exigir login ou conectar-se a dados ao vivo.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Adicionar login" icon="lock" href="/build/add-login">
    Coloque o dashboard atrás de autenticação para que apenas as pessoas certas o vejam.
  </Card>

  <Card title="Adicionar um banco de dados" icon="database" href="/build/add-database">
    Salve dados para que persistam e atualizem entre sessões.
  </Card>

  <Card title="Adicionar integrações" icon="plug" href="/build/add-integrations">
    Puxe outra fonte de dados ou envie insights para ferramentas existentes.
  </Card>

  <Card title="Conectores de Dados" icon="network-wired" href="/pt/connectors/warehouses/overview">
    Conecte um warehouse ao vivo para que o dashboard reflita dados atualizados.
  </Card>

  <Card title="Transforme insights em uma apresentação" icon="presentation-screen">
    Peça ao Agent para criar uma apresentação para as partes interessadas a partir dos resultados do dashboard.
  </Card>
</CardGroup>

## Precisa de mais ajuda?

* **Números parecem diferentes do esperado:** peça ao Agent para mostrar a consulta, fórmula ou transformação.
* **O CSV não está disponível:** verifique a URL, o acesso à rede e os cabeçalhos do CSV.
* **Filtros não atualizam gráficos:** peça ao Agent para conectar os filtros tanto aos cards resumidos quanto aos dados dos gráficos.
* **O dashboard está lento:** peça ao Agent para resumir dados, adicionar filtros ou reduzir linhas carregadas na inicialização.
* **O dashboard usa dados privados:** adicione login antes de compartilhar amplamente.

## Relacionado

* [Visualização de Dados](/pt/references/artifact-types/data-apps)
* [Conectores de Dados](/pt/connectors/warehouses/overview)
* [Adicionar login](/build/add-login)
* [Adicionar integrações](/build/add-integrations)