Criar LookML com ferramentas de programação agêntica

1. Introdução

As ferramentas de criação de código de agente com base no ecossistema do VS Code se tornaram muito populares. Cursor e Antigravity são apenas dois exemplos. Este codelab demonstra como o LookML pode ser escrito com essas ferramentas de código.

O que você vai fazer

Neste codelab, você vai usar a extensão do VS Code do Looker para modificar um modelo do LookML a fim de adicionar uma nova métrica, testar a nova métrica e criar um painel do LookML usando essa nova métrica. Tudo isso será feito solicitando um agente de programação.

O que é necessário

Público-alvo: desenvolvedores, engenheiros de dados e arquitetos do LookML.

2. Configurar a instância do Looker

Criar um projeto do Google Cloud

  1. No console do Google Cloud, na página de seletor de projetos, selecione ou crie um projeto do Google Cloud.
  2. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

Conectar o Looker à fonte de dados

  1. No Looker, em Administrador , acesse o cabeçalho Bancos de dados e selecione Conexões.
  2. Clique em Adicionar conexão no canto superior direito da tela.
  3. Crie uma nova fonte de dados para o conjunto de dados Cymbal Gadgets. Dê o nome cymbal_gadgets. Selecione Google BigQuery Standard SQL para o dialeto SQL. Captura de tela das configurações gerais de conexão
  4. Na próxima página, insira o nome do projeto na nuvem do Google, o projeto de armazenamento looker-private-demo e o nome do conjunto de dados cymbal_gadgets. Captura de tela das configurações do banco de dados
  5. Aceite os padrões para todos os campos restantes e conclua o processo de criação da nova fonte de dados.
  6. No SQL Runner , confirme se é possível consultar o conjunto de dados executando
    SELECT count(*)
FROM looker-private-demo.cymbal_gadgets.transactions

Importar o projeto do GitHub

  1. Ramifique o projeto https://github.com/looker-open-source/cymbal_gadgets do GitHub para seu próprio repositório. Não é possível adicionar uma chave de implantação a um projeto que não é seu. Portanto, a ramificação é necessária para vincular o projeto ao Looker.
  2. Ative o Modo de desenvolvimento.
  3. Selecione Desenvolver e Projetos.
  4. Na página Projetos do LookML, clique em Novo modelo.
  5. Clique no link para usar a página de criação do modelo LookML antigo. Captura de tela do link da caixa de diálogo de criação do modelo antigo
  6. Crie um novo projeto em branco no Looker chamado cymbal_gadgets. Captura de tela da caixa de diálogo "Novo projeto"
  7. Escolha Configurar o Git para conectá-lo ao repositório ramificado que você criou. Captura de tela da configuração do git
  8. Adicione a Deploy Key ao seu repositório Git. Clique na caixa para permitir acesso de gravação com a chave de implantação. Captura de tela da configuração da chave de implantação do Git
  9. Em seguida, escolha Testar e finalizar a configuração. Captura de tela da configuração do projeto concluída
  10. Verifique se o projeto e a fonte de dados funcionam consultando dados da análise "🛍️ Cymbal Gadgets: Transactions & Sales".
  11. Abra o projeto cymbal_gadgets no editor do LookML e pressione o botão Criar cópia do desenvolvedor no canto superior direito.
  12. Em Ações do Git , clique em Enviar mudanças para o remoto para que a ramificação de desenvolvimento esteja disponível no GitHub. Captura de tela das ações do Git
  13. Em uma sessão de terminal no seu computador, execute o seguinte:
    cd $HOME
git clone git@github.com:YOUR_GITHUB_USER/cymbal_gadgets.git
cd cymbal_gadgets
git checkout YOUR_DEV_BRANCH
    Substitua o nome da sua conta de usuário do GitHub por YOUR_GITHUB_USER. Substitua também o nome da ramificação de desenvolvimento por YOUR_DEV_BRANCH. A ramificação de desenvolvimento terá um nome como dev-john-doe-jhgr. Ou seja, a palavra dev seguida do seu nome e sobrenome, seguida por uma string aleatória curta. Você vai encontrar sua ramificação de desenvolvimento pessoal na parte de cima do editor do LookML na interface do Looker.

3. Configurar o ambiente de desenvolvimento integrado do agente

Instalar a extensão do VS Code

No ambiente de desenvolvimento integrado, clique no ícone Extensões no painel esquerdo. Em seguida, pesquise "Looker" e instale a extensão oficial do Google clicando no botão de instalação.

Instalar o servidor da MCP Toolbox for Databases

Para dar ao Antigravity acesso à API Looker (executar consultas, inspecionar SQL, inspecionar o modelo LookML e inspecionar informações do esquema de conexão), você precisa de um servidor local da MCP Toolbox for Databases em execução. A MCP Toolbox vem com a implementação oficial do Looker MCP. Nesta seção, você vai configurar e configurar para sua instância do Looker.

  1. Primeiro, você precisa de um client_id e client_secret da API. Use o guia de chaves de API Looker para gerar o client_id e client_secret do seu usuário. Você também vai precisar do URL de base da sua instância do Looker.
  2. Agora você vai usar o npx para instalar a MCP Toolbox. Você pode fornecer o URL da instância do Looker e as credenciais da API como variáveis de ambiente inline ou defini-las no ambiente shell. Execute isso no ambiente shell para Mac e Linux:
    LOOKER_BASE_URL="https://your-instance.looker.com" \
LOOKER_CLIENT_ID="YOUR_CLIENT_ID" \
LOOKER_CLIENT_SECRET="YOUR_CLIENT_SECRET" \
npx @toolbox-sdk/server --prebuilt=looker,looker-dev
    Para Windows, execute isso no Powershell:
    $env:LOOKER_BASE_URL="https://your-instance.looker.com"
$env:LOOKER_CLIENT_ID="YOUR_CLIENT_ID"
$env:LOOKER_CLIENT_SECRET="YOUR_CLIENT_SECRET"
npx @toolbox-sdk/server --prebuilt=looker,looker-dev

Configurar a extensão do VS Code

Nesta etapa, você vai configurar a extensão do VS Code para se conectar ao Looker e ao servidor do Looker MCP.

  1. No Antigravity, use CMD-SHIFT-P (Mac) ou CTRL+SHIFT+P (Linux/Windows) para abrir a paleta de comandos e escolha Preferences: Open Workspace Settings (JSON).
  2. Adicione o seguinte às configurações do espaço de trabalho para configurar a extensão usando client_id e client_secret. Para looker.projectId, use cymbal_gadgets:
    {
   "looker.instanceURL": "https://your-instance.looker.com",
   "looker.clientId": "YOUR_API_KEY_CLIENT_ID",
   "looker.clientSecret": "YOUR_API_KEY_CLIENT_SECRET",
   "looker.projectId": "cymbal_gadgets"
}

Abrir o editor

  1. Abra o Antigravity.
  2. Clique em Arquivo > Abrir pasta….
  3. Navegue até a pasta cymbal_gadgets e selecione-a.

4. Criar uma métrica de valor da vida útil do cliente

Primeiro, você vai criar uma nova medição no modelo LookML atual usando o agente. Uma medição de Customer Lifetime Value será útil nesse caso de uso de varejo. Você vai usar o agente para determinar a metodologia e o LookML dessa medição.

Solicitar o agente

No projeto cymbal_gadgets no seu espaço de trabalho do Antigravity, você terá uma nova interface de conversa à direita. Inicie a conversa no Modo de planejamento usando o modelo mais recente do Gemini com o comando: Create a Customer Lifetime Value measure.

Captura de tela do comando no Antigravity

Verificar o plano de implementação

O agente vai criar um plano de implementação. Abra o plano de implementação para analisá-lo e clique no botão Continuar.

Captura de tela do plano de implementação

Analisar o LookML

Analise o LookML modificado. Verifique se as mudanças fazem sentido e são válidas.

Captura de tela do LookML alterado

O LookML modificado é sincronizado automaticamente com o Looker pela extensão do VS Code. Ele pode ser testado no Modo de desenvolvimento.

Testar no ambiente de desenvolvimento integrado

Peça ao Antigravity para query CLV broken down by customer loyalty tier. O Antigravity vai usar o servidor do Looker MCP para encontrar os modelos, examinar os campos disponíveis e executar uma consulta usando o Looker. O resultado será algo como:

Captura de tela dos dados no Antigravity

Testar no Looker

No Looker, com o Modo de desenvolvimento ativado, abra a análise 🛍️ Cymbal Gadgets: Transactions &Sales. Selecione a métrica de valor da vida útil do cliente e, em seguida, faça uma tabela dinâmica pelo ano de registro do cliente. Execute a consulta. Ela deve ser semelhante a esta.

Captura de tela da análise detalhada

5. Criar um painel de valor da vida útil do cliente

Agora vamos tentar um exemplo mais complexo. Vamos pedir ao agente para criar um painel do LookML totalmente novo.

Solicitar um novo painel do agente

Volte para o Antigravity. Na mesma conversa, verifique se o Modo de planejamento e o modelo mais recente do Gemini estão selecionados. Em seguida, peça Create a dashboard showing customer lifetime value based on customer loyalty tier.

Captura de tela da criação do painel

Aprove o plano de implementação e aceite as mudanças no código. Agora, esse novo arquivo do LookML será sincronizado automaticamente com o Looker.

Testar no Looker

No Modo de desenvolvimento, navegue até a pasta LookML Dashboards. Selecione o painel recém-criado para visualizá-lo.

Captura de tela do novo painel

6. Limpar

  1. No Antigravity, no painel Controle do código-fonte, reverta as mudanças do LookML, se quiser. Ao lado de cada arquivo do LookML modificado, haverá um símbolo como ↶ para reverter o arquivo. Pressione esse botão para cada arquivo. Captura de tela da opção "Reverter mudanças"
  2. No Looker, selecione Administrador , Banco de dados e Conexões. Clique no ícone de engrenagem da conexão cymbal_gadgets e escolha Excluir. Confirme que você quer excluir a conexão.
  3. No Looker, use o Modo de desenvolvimento. Selecione Desenvolver e o projeto cymbal_gadgets. Em Configurações do projeto , selecione Excluir projeto. Confirme que você quer excluir o projeto digitando o nome dele, cymbal_gadgets, e selecionando o botão Excluir cymbal_gadgets permanentemente.

7. Parabéns

Parabéns por concluir o codelab.

O que vimos

  • Como modificar o LookML com um agente.
  • Como verificar planos de implementação.
  • Como testar no ambiente de desenvolvimento integrado.
  • Como testar na interface do Looker.
  • Como criar um novo painel com um agente.

O que você pode tentar

Agora, tente os comandos a seguir na interface para conferir diferentes recursos do ambiente de desenvolvimento integrado do agente:

  • Boas descrições são essenciais para usuários e IA. Peça ao agente para adicionar descrições a todos os campos que não têm uma.
  • Peça ao agente para adicionar mais períodos a um dos grupos de dimensões.
  • Peça ao Agente para executar uma consulta como "receita dividida por categoria dos produtos, com tabela dinâmica por trimestre".

Saiba mais