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

Visualizar

Este recurso está sujeito aos "Termos da Pré-GA" nos Termos Gerais de Serviço dos Termos Específicos de Serviço e aos Termos Adicionais para Produtos Pré-lançamento de IA Generativa. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições das fases de lançamento.

Observação: envie feedback ou informe problemas com esse recurso em fase de pré-lançamento usando o formulário Problemas de pré-lançamento dos apps de dados do Looker.

Observação: como um recurso em fase de pré-lançamento, os apps de dados do Looker estão sujeitos ao Adendo de processamento de dados na nuvem.

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, a partir de comandos de linguagem natural. Os apps de dados oferecem controle total do layout visual (incluindo posicionamento absoluto, elementos sobrepostos e componentes da Web personalizados), mantendo-se vinculados à camada semântica do LookML e às permissões do 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 é alimentada pelo framework de extensão do Looker e executada em um painel definido pelo usuário (UDD, na sigla em inglês) de elemento único.

Os principais recursos incluem o seguinte:

• Criação assistida por IA, sem IA de execução: você usa um agente de programação de IA no computador para gerar o layout e o código do componente a partir de 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 grava o código do aplicativo, o Looker executa cada app de dados em um sandbox de navegador isolado que bloqueia conexões de rede de saída. O código do aplicativo só pode se comunicar com a instância do Looker. Portanto, os resultados da consulta e as credenciais do usuário não podem ser enviados a servidores externos.
• Acesso a dados controlados: os apps de dados consultam dados exclusivamente pela camada semântica do LookML do Looker. Cada consulta é executada nas permissões do Looker, no acesso ao modelo e nos filtros de acesso no nível da linha do usuário visualizador.
• Controles interativos: os apps de dados incluem filtros interativos integrados, filtragem cruzada e visualizações detalhadas no app.

Antes de começar

Antes de instalar as ferramentas para desenvolvedores e criar um app de dados, verifique se você atende aos pré-requisitos a seguir:

Requisitos da instância

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

Permissões necessárias

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

• O nível de acesso Gerenciar acesso, editar para a pasta em que você quer colocar o painel
• As permissões do Lookeraccess_data, explore, see_user_dashboards e save_dashboards (ou save_content)
• Acesso aos modelos do LookML para todos os dados que você quer usar no painel

Para visualizar 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 subjacentes

Credenciais da API Looker

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

Observação: a chave de API fornece acesso à API Looker. É importante armazenar a chave de API com segurança e restringir o acesso a ela.

Para recuperar a chave de API, siga estas etapas:

1. O administrador do Looker precisa ativar 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 cabeçalho Chaves de API, clique em Gerenciar.
4. Na página Chaves de API, você pode visualizar 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 de pasta

Identifique o ID numérico da pasta do Looker em que você quer publicar os apps de dados. No Looker, abra a pasta de destino (como Compartilhada ou Minha pasta) e anote 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 internos ou impressão. No entanto, você pode personalizar o estilo visual diretamente no app de dados solicitando ao agente de programação de IA.
• Como copiar apps de dados: evite copiar um app de dados no Looker. Como as cópias referenciam o mesmo aplicativo subjacente, as mudanças feitas em uma cópia são refletidas em todas as cópias.
• Exportação e importação do LookML: não é possível exportar um app de dados como LookML nem importar um app de dados do LookML.
• Dependência de www.gstatic.com: os apps de dados exigem acesso à rede www.gstatic.com para carregar bibliotecas de componentes e de execução. Os navegadores dos usuários precisam acessar www.gstatic.com para renderizar apps de dados.
• Exportação de PDF: não é possível baixar o app de dados como um PDF.
• Entrega programada: não é possível configurar uma programação automatizada para enviar um snapshot em PDF do app de dados por e-mail.

Instalar as ferramentas para desenvolvedores

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

Observação: as ferramentas para desenvolvedores de apps de dados exigem o Python versão 3.9 ou mais recente. Se você não tiver o Python instalado no ambiente de desenvolvimento local, consulte o guia de instalação oficial do Python para instalar o Python.

Executar o script de instalação

Abra um terminal em uma máquina com acesso ao 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 aos comandos interativos:

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 instância do Looker, como https://myinstance.looker.com.
3. client_id da API Looker: insira o 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 no 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 as credenciais funcionam e se a instância do Looker pode armazenar e veicular apps de dados.

Criar, visualizar e publicar um app de dados

Siga este fluxo de trabalho para criar um app de dados com o 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

Usando linguagem natural para escrever os comandos, peça ao agente para criar um aplicativo. O aplicativo precisa ser baseado em análises 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 as 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 agente.

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

Etapa 4: refinar o app de forma iterativa

Converse com o 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ências."
• "Mude o plano de fundo para um cinza neutro sutil e adicione fichas de informações arredondadas com sombras projetadas suaves."

Etapa 5: publicar o app de dados no Looker

Quando 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: visualizar 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 explorar os recursos dos apps de dados do Looker durante a pré-visualização, tente os seguintes cenários:

Replicar relatórios atuais de imagens

Faça upload de uma captura de tela de um relatório atual de outra ferramenta de BI (como o Tableau ou o Power BI) ou de um slide para o agente de IA. Peça ao 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.

Criar 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 de várias colunas ao lado de grades de dados amplas.
• Aplique a marca corporativa personalizada, estilos de fonte e gradientes de plano de fundo.

Incorporar componentes UI interativos avançados

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

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

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

Aproveite as bibliotecas de componentes integradas:

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

Testar recursos da plataforma Looker

Verifique se o app de dados está integrado aos processos do Looker.