Criar LookML com a assistência do Gemini

Esta página de documentação descreve como usar a assistência do Gemini para criar dimensões, grupos de dimensões e métricas em um projeto do LookML. Gerar sugestões de código do LookML em resposta a comandos escritos é um recurso do Gemini no Looker disponível nas instâncias do Looker (original) e do Looker (Google Cloud Core).

O Gemini no Looker oferece assistência com tecnologia de IA generativa para ajudar você a trabalhar com seus dados.

Saiba como e quando o Gemini para Google Cloud usa seus dados.

Esta página é destinada a desenvolvedores do Looker.

Antes de começar

Para usar o Gemini no ambiente de desenvolvimento integrado do Looker, observe os seguintes requisitos:

  • O Gemini no Looker precisa estar ativado na sua instância do Looker:
  • Você precisa ter um papel do Looker que contenha a permissão develop para pelo menos um modelo em um projeto do LookML.
  • Você precisa ter um papel que contenha a gemini_in_looker permissão para pelo menos um modelo no projeto do LookML.

Usar o Gemini no ambiente de desenvolvimento integrado do Looker

Para usar o Gemini na criação do LookML no seu projeto do Looker, siga estas etapas:

  1. Na sua instância do Looker, ative o Modo de Desenvolvimento.
  2. Abra seu projeto no ambiente de desenvolvimento integrado do Looker.
  3. Use o navegador de arquivos do ambiente de desenvolvimento integrado para abrir um arquivo de visualização do LookML em que você quer inserir o LookML.

  4. Selecione o ícone Me ajude com o código no seletor do painel lateral.

    IDE do Looker com o ícone "Me ajude com o código" destacado.

  5. Com o painel Me ajude com o código aberto, clique para posicionar o cursor em uma linha no arquivo de visualização do LookML. Com base no tipo de arquivo do LookML e no local em que o cursor está posicionado no arquivo, o Gemini oferece opções adequadas para orientar você, como Criar uma dimensão ou Criar uma métrica.

  6. Selecione uma das seguintes opções no painel Me ajude com o código:

    • Criar um grupo de dimensões
    • Criar uma dimensão
    • Criar uma métrica
    • Outra sugestão de código: você pode usar a opção Outra sugestão de código se quiser testar diferentes elementos do LookML. Lembre-se de que o Gemini é uma tecnologia em estágio inicial. Portanto, valide e teste todas as saídas antes de implantá-las.

  7. No campo de texto do painel Me ajude com o código , use linguagem conversacional para descrever a dimensão, o grupo de dimensão ou a métrica que você quer criar. Consulte as seções Dicas para usar o Gemini no ambiente de desenvolvimento integrado do Looker e Comandos de amostra nesta página para receber orientações.

  8. Pressione Enter ou clique no ícone Enviar para enviar sua solicitação ao Gemini. O Gemini vai responder com o código sugerido.

  9. Com o código sugerido, você pode fazer o seguinte:

    • Mantenha o ponteiro sobre o botão Inserir para visualizar o LookML sugerido no arquivo. Você pode mover o cursor para uma linha diferente no arquivo para visualizar em um local diferente antes de inserir o LookML no arquivo.
    • Clique no botão Editar para mudar manualmente o LookML sugerido.
    • Clique no botão Inserir para inserir o LookML no arquivo no local do cursor.
    • Envie feedback sobre o código sugerido selecionando o ícone de polegar para cima (Esta resposta foi útil) ou o ícone de polegar para baixo (Esta resposta não era o que eu esperava).
    • Clique no link Nova sugestão de código para começar de novo e inserir um novo comando para o Gemini.

    O Gemini mostrando uma prévia do posicionamento do código quando o cursor é passado sobre o botão "Inserir".

  10. Clique em Salvar alterações no arquivo do LookML.

  11. Verifique o LookML fazendo o seguinte:

Dicas para usar o Gemini no ambiente de desenvolvimento integrado do Looker

Confira algumas dicas para usar o Gemini no ambiente de desenvolvimento integrado do Looker:

  • Para melhores resultados, escreva seus comandos em inglês americano. Consulte a documentação de limitações Google Cloud doGemini para mais informações.
  • O painel Me ajude com o código não retém o contexto de um comando anterior na conversa e não retém comandos em logins e atualizações.
  • Ao usar o LookML sugerido pelo Gemini, sempre valide o LookML com o Validador do LookML e teste os novos campos em uma análise.
  • Dependendo da sua solicitação, o Gemini pode sugerir o LookML que referencia campos em outros arquivos de visualização. Ao adicionar o LookML sugerido ao arquivo, salve-o e execute o Validador do LookML. O Validador do LookML vai mostrar erros se você precisar adicionar include instruções ao arquivo de modelo.

Comandos de amostra

Para dar algumas ideias, confira alguns exemplos de comandos e os resultados deles:

Criar uma dimensão usando longitude e latitude

Confira um comando usando a opção Criar uma dimensão que pede ao Gemini para criar uma nova dimensão com base nos campos longitude e latitude definidos no arquivo de visualização:

show coordinates with longitude and latitude

O Gemini retorna este código sugerido:

   dimension: coordinates {
      type: location
      sql_latitude: ${TABLE}.latitude ;;
      sql_longitude: ${TABLE}.longitude ;;
   }

Você pode verificar esse LookML em uma análise selecionando o novo campo coordinates, junto com os campos longitude e latitude em que ele se baseia. Como o Gemini criou a dimensão usando type:location, os resultados da análise incluem um hiperlink para visualizar as coordenadas em um mapa:

Análise do Looker mostrando os campos de latitude e longitude, com o novo campo de coordenadas com valores que correspondem aos valores de latitude e longitude.

Criar uma métrica para o total de vendas de hoje

Confira um comando usando a opção Criar uma métrica que pede ao Gemini para criar uma nova métrica para a soma de todos os pedidos de hoje:

show the total sale price of today's orders

O Gemini retorna este código sugerido:

   measure: todays_orders {
      type: sum
      sql: ${basic_order_items.sale_price} ;;
      filters: [basic_order_items.created_at_date: "today"]
  }

Enviar feedback

Você pode enviar feedback para o LookML gerado no painel Me ajude com o código. Se o LookML gerado parecer correto, clique no ícone de polegar para cima thumb_up. Se o LookML gerado parecer incorreto ou não for o que você esperava, clique no ícone de polegar para baixo thumb_down.