Visão geral e configuração dos aplicativos de dados do Looker

Os apps de dados do Looker são painéis de tela livre criados por agentes de programação de IA locais, como a CLI do Gemini, o Claude Code ou o Cursor, com base em comandos de linguagem natural. Ao contrário dos painéis de grade padrão, os apps de dados oferecem controle completo do layout visual (incluindo posicionamento absoluto, elementos sobrepostos e componentes da Web personalizados), mantendo-se vinculados à camada semântica da LookML gerenciada do Looker e às permissões de usuário.

Ao criar um app de dados, o agente de programação de IA é executado na sua máquina local para gerar o código do aplicativo. Depois de publicar o app de dados no Looker, nenhum modelo de IA é envolvido quando os usuários abrem ou interagem com o painel.

Visão geral dos apps de dados do Looker

Um app de dados é uma extensão do Looker que usa o framework de extensões do Looker e é executado em um painel definido pelo usuário (UDD) de um único elemento.

As principais capacidades incluem:

  • Criação com assistência de IA, IA de tempo de execução zero: você usa um agente de programação de IA no computador para gerar o layout e o código do componente com base em comandos. Os apps de dados publicados são executados como componentes da Web padrão no Looker sem chamar nenhum modelo de IA quando os usuários visualizam o painel.
  • Sandbox isolado da rede: como um agente de IA escreve o código do aplicativo, o Looker executa todos os apps de dados em um sandbox isolado do navegador que bloqueia conexões de rede de saída. O código do aplicativo só pode se comunicar com sua instância do Looker. Assim, os resultados da consulta e as credenciais do usuário não podem ser enviados para servidores externos.
  • Acesso a dados governados: os apps de dados consultam dados exclusivamente pela camada semântica LookML do Looker. Todas as consultas são executadas com base nas permissões do Looker, no acesso ao modelo e nos filtros de acesso no nível da linha do usuário que está visualizando.
  • Controles interativos e entrega programada: os apps de dados incluem filtros interativos, filtragem cruzada e detalhamento no app. Além disso, eles são compatíveis com downloads de PDF do Looker e entrega de e-mail programado.

Antes de começar

Antes de instalar as ferramentas de desenvolvedor e criar um app de dados, verifique se você atende aos seguintes pré-requisitos:

Requisitos de instância

  • Use uma instância hospedada pelo Looker que esteja executando o Looker 26.18 ou uma versão mais recente.
  • Um administrador do Looker precisa ativar a opção de pré-lançamento Apps de dados no painel Administrador em Geral > Pré-lançamentos. Para mais informações, consulte a página de documentação dos recursos em prévia.
  • Os navegadores dos usuários precisam ter acesso à rede www.gstatic.com para carregar as bibliotecas de tempo de execução dos apps de dados.

Permissões necessárias

Para criar e publicar um app de dados, você precisa ter o seguinte:

Para acessar um app de dados publicado, os usuários precisam ter o seguinte:

  • O nível de acesso Visualizar à pasta de destino

  • As permissões do Looker access_data, explore e see_user_dashboards para os modelos do LookML

Credenciais da API Looker

Suas ferramentas de desenvolvedor acessam a instância do Looker usando a API Looker. Para conceder às suas ferramentas de desenvolvedor acesso à API Looker, você precisa de uma chave de API, que consiste em um ID e uma chave secreta do cliente. Você fornece o ID e a chave secreta do cliente às ferramentas para desenvolvedores ao configurar as opções de configuração.

Para recuperar sua chave de API, siga estas etapas:

  1. O administrador do Looker precisa ativar as chaves de API para sua conta de usuário na página Administrador > Usuários.
  2. No Looker, acesse a página Conta do usuário.
  3. Na seção Autenticação, ao lado do título Chaves de API, clique em Gerenciar.
  4. Na página Chaves de API, você pode conferir as chaves de API atuais ou criar novas.
  5. Copie o ID do cliente e a chave secreta do cliente da chave de API selecionada.

Identificador da pasta

Identifique o ID numérico da pasta do Looker em que você quer publicar seus aplicativos de dados. No Looker, abra a pasta de destino (como Compartilhados ou Minha pasta) e observe o número no final do URL:

https://LOOKER_INSTANCE_URL/folders/FOLDER_ID

Limitações

Os apps de dados do Looker têm as seguintes limitações:

  • Incorporação, temas e impressão: os apps de dados não oferecem suporte a incorporação, temas de painel interno ou impressão. No entanto, é possível personalizar o estilo visual diretamente no app de dados ao pedir para seu agente de programação de IA.
  • Copiar apps de dados: evite copiar um app de dados no Looker. Como as cópias fazem referência ao mesmo aplicativo subjacente, as mudanças feitas em uma cópia são refletidas em todas as cópias.
  • Exportação e importação de LookML: não é possível exportar um aplicativo de dados como LookML nem importar um aplicativo de dados da LookML.
  • Dependência de www.gstatic.com: os apps de dados exigem acesso à rede para www.gstatic.com carregar bibliotecas de tempo de execução e de componentes. Os navegadores dos usuários precisam conseguir acessar www.gstatic.com para renderizar os apps de dados.

Instalar as ferramentas para desenvolvedores

Para criar apps de dados, instale as ferramentas de desenvolvedor no seu ambiente de desenvolvimento local (macOS ou Linux).

Execute o script de instalação

Abra um terminal em uma máquina com acesso ao seu agente de programação de IA e execute o seguinte comando:

bash <(curl -fsSL https://dl.google.com/looker-data-apps/install.sh)

Configurar opções de configuração

Durante a instalação, responda às solicitações interativas:

  1. Diretório de instalação: insira o caminho local em que você quer armazenar o projeto de apps de dados ou pressione Enter para aceitar o padrão (~/looker-data-apps).
  2. URL da instância do Looker: insira o URL da sua instância do Looker, como https://myinstance.looker.com.
  3. client_id da API Looker: insira seu ID do cliente.
  4. client_secret da API Looker: insira a chave secreta do cliente (salva localmente em data-apps-config.json com permissões de arquivo somente do proprietário).
  5. ID da pasta do Looker: insira o ID da pasta de destino que você identificou em Identificador da pasta ou pressione Enter para aceitar a pasta padrão, que é a pasta 1, a pasta Compartilhada.

Depois de concluir os comandos, o instalador executa automaticamente uma verificação de quatro etapas para confirmar se suas credenciais funcionam e se a instância do Looker pode armazenar e veicular aplicativos de dados.

Criar, visualizar e publicar um app de dados

Siga este fluxo de trabalho para criar um app de dados com seu agente de programação de IA:

Etapa 1: iniciar o agente de programação de IA

No terminal, navegue até o diretório de instalação dos apps de dados (~/looker-data-apps) e inicie o agente de programação de IA.

Etapa 2: pedir ao agente para gerar um app de dados

Use linguagem natural para escrever seus comandos e peça ao agente para criar um aplicativo. Sua inscrição precisa ser baseada em análises detalhadas e visualizações atuais, mas não é necessário usar identificadores técnicos. Exemplo:

Build a responsive Looker Data App using the faa model and the
large\_flight\_data explore. I want this to be a dynamic, dark-themed operations
center.

Please include the following components:

The Map (Centerpiece): Create a custom visual that visualizes flights moving
from their Origin to Destination. Include a timeline slider (or playback
animation) based on Departure Time and Arrival Time so I can watch the flights
move over time.

KPI Strip: Across the top, include a row of KPI cards showing the total flight
Count, average Delay Mins, total Total Revenue, and average Load Factor.

Trend Chart: Include a line chart showing how Carbon Emissions and Total Revenue change over
the Departure Date periods.

Interactive Filters: Include drop-down filters for Airline, Status, and Origin
that wire into the charts and map to update the data dynamically.

O agente de IA inspeciona suas Análises do LookML, grava a definição do componente e inicia o servidor de visualização local.

Etapa 3: inspecionar a visualização local

Abra o URL de visualização local (http://localhost:8765) fornecido pelo seu agente.

Você também pode executar make start (ou python3 skills/data-app-previewer/tools/start-preview.py) no terminal para ver uma galeria de todos os apps locais que você criou.

Etapa 4: refinar o app de forma iterativa

Converse com seu agente de IA para refinar o layout, o estilo e as interações:

  • "Alinhe os três cards de métricas ao lado direito da tela."
  • "Adicione um controle deslizante de período acima do gráfico de tendência."
  • "Mude o plano de fundo para um cinza neutro sutil e adicione cards arredondados com sombras projetadas suaves."

Etapa 5: publicar o app de dados no Looker

Quando você estiver satisfeito com o design, peça ao agente para implantar o app:

Publish this app to Looker.

O agente executa o script de publicação, que empacota o script do componente e cria ou atualiza um objeto de painel na pasta configurada.

Etapa 6: acessar o app de dados no Looker

Clique no link do Looker retornado pelo agente. O app de dados é carregado no Looker com suporte total para filtros de acesso do usuário, compartilhamento de pastas e recursos da plataforma.

Sugestões de coisas para tentar

Para conhecer os recursos dos apps de dados do Looker durante a prévia, tente os seguintes cenários:

Replicar relatórios de imagens

Faça upload de uma captura de tela de um relatório de outra ferramenta de BI (como Tableau ou Power BI) ou de uma apresentação de slides para seu agente de IA. Envie o seguinte comando para o agente:

Replicate the layout, visual hierarchy, and color scheme shown in this
screenshot, binding the charts to our customer_analytics explore.

Os agentes de IA multimodais podem extrair geometria de coordenadas, tipografia e paletas de cores de imagens para gerar layouts de apps de dados correspondentes.

Projetar layouts personalizados

Vá além das grades retangulares padrão criando layouts assimétricos:

  • Crie cards de KPI flutuantes que se sobreponham parcialmente aos banners principais.
  • Adicione barras laterais de resumo executivo com várias colunas ao lado de grades de dados amplas.
  • Aplique branding corporativo personalizado, estilos de fonte e gradientes de plano de fundo.

Incorporar componentes UI interativos avançados

Peça ao seu agente para adicionar elementos interativos da Web:

  • Navegação com guias: organize métricas operacionais complexas em várias guias sem recarregar a página.
  • Caixas de diálogo modais e gavetas: abra visualizações detalhadas de detalhamento ou definições do glossário ao clicar em uma métrica.
  • Filtros e controles interativos: adicione botões de alternância, controles deslizantes e entradas de pesquisa personalizados que atualizam as séries de gráficos de forma dinâmica.

Usar tabelas e visualizações de dados avançadas

Aproveite as bibliotecas de componentes integradas:

  • Integração do AG Grid: incorpore tabelas de dados interativas que oferecem suporte à classificação e ao redimensionamento de colunas, além da formatação de células.
  • Tipos avançados do Highcharts: gere indicadores, mapas de calor, mapas de árvore e diagramas de Sankey que os blocos padrão do painel não oferecem suporte.

Testar recursos da plataforma Looker

Verifique se o app de dados se integra aos fluxos de trabalho do Looker:

  • Cruzamento de filtros: configure os gráficos para que a seleção de uma categoria em um deles filtre as visualizações restantes.
  • Exportação de PDF: faça o download de todo o painel como um PDF.
  • Entrega programada: configure uma programação automática para enviar um instantâneo em PDF do seu app de dados para sua equipe por e-mail.