Criar visualizações com a ajuda do Gemini

Esta página de documentação descreve como usar a assistência do Gemini para gerar opções de formatação JSON com base em comandos de texto e, em seguida, aplicar essa formatação para personalizar uma visualização do Looker. A personalização de visualizações com o Assistente de visualização é um recurso do Gemini no Looker disponível nas instâncias do Looker (original) e do Looker (Google Cloud Core).

O Assistente de visualização está disponível para visualizações que usam a API Highcharts, que inclui a maioria dos gráficos cartesianos, como o gráfico de colunas, o gráfico de barras e o gráfico de linhas, entre outros.

O Gemini no Looker é um produto do portfólio Gemini para Google Cloud que oferece assistência com tecnologia de IA generativa para ajudar você a analisar e receber insights valiosos dos seus dados.

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

Esta página é destinada a usuários que estão analisando dados em uma instância do Looker.

Antes de começar

Para personalizar visualizações com a ajuda do Gemini, observe os seguintes requisitos:

Como usar o Assistente de Visualização

Para personalizar uma visualização com o Assistente de visualização, siga estas etapas:

  1. Veja uma visualização compatível em uma Análise ou edite uma visualização em um Look ou painel.
  2. Selecione a guia Estilo no painel de configuração.
  3. Clique em pen_spark Assistente de visualização para abrir o menu de comandos.

Se você estiver usando a Análise clássica, para personalizar uma visualização com o Assistente de visualização, siga estas etapas:

  1. Veja uma visualização compatível em uma Análise ou edite uma visualização em um Look ou painel.
  2. Abra o painel Visualização.
  3. Clique em pen_spark Assistente de visualização para abrir o menu de comandos.

No menu de comandos do pen_spark Assistente de Visualização, você pode:

  • Digite um comando de texto simples com as mudanças para a visualização no campo Pergunte o que quiser. Para enviar send_spark seu comando, pressione Return (Mac) ou Enter (PC).
  • Aplique as Sugestões geradas à visualização.
  • Abra a opção Editar configuração do gráfico para escrever e editar manualmente as opções de formatação JSON.
  • Limpar substituições de gráfico para remover todas as mudanças personalizadas que foram aplicadas à visualização. Será preciso Confirmar a remoção de todas as mudanças antes de continuar. Se você limpou as mudanças por acidente, pode recuperá-las voltando no histórico de navegação do navegador.

Depois que o comando for executado, uma prévia vai aparecer na janela de conversa com as seguintes opções:

  • Aplicar as mudanças visualizadas à visualização: clique em Aplicar. Se forem feitas mudanças no menu Configuração do gráfico, essa opção vai mudar para Revalidar e aplicar.
  • Escrever e editar manualmente as opções de formatação JSON geradas: clique em Editar configuração do gráfico para abrir o editor de configuração do gráfico. Clique em Assistente de visualização para voltar ao menu de comandos.
  • Clique em Limpar substituições de gráfico para desfazer as mudanças aplicadas.
  • Envie feedback sobre a utilidade da resposta ao comando: selecione thumb_up para indicar que a resposta foi útil ou thumb_down para indicar que a resposta não foi o que você esperava.

Uma mensagem de erro Invalid JSON detected vai aparecer se você tentar visualizar um código que contém um JSON inválido. Para limpar o JSON inválido, use a opção Corrigir código automaticamente edit_fix_auto na parte de baixo do painel Configuração do gráfico.

Como criar comandos eficazes

Escrever comandos eficazes pode exigir prática. Tente algumas das sugestões a seguir para escrever comandos que alcancem seu objetivo.

Dividir os comandos em várias partes

Os comandos são mais eficazes quando se concentram em uma mudança de cada vez. Por exemplo, se você quiser mudar a família de fontes e o tipo de visualização, é melhor fazer isso em comandos separados. Depois de aprovar as mudanças geradas, aplique-as e comece a escrever o próximo comando.

Comando: mude a primeira série para uma linha

O menu do Assistente de Visualização mostra uma prévia de um comando que muda uma das três séries em uma visualização de uma coluna para uma linha.

Comando: mude a fonte para Arial e coloque em negrito.

O menu do Assistente de Visualização mostra uma prévia de um comando que muda a fonte do gráfico para a família de fontes Arial e deixa o texto em negrito.

Tente escrever um comando de várias maneiras

Se você não estiver recebendo os resultados esperados, tente reformular o comando. Ao aplicar a formatação condicional, tente deixar o comando o mais claro possível. Definir intervalos de valores específicos e fornecer códigos hexadecimais pode criar uma saída mais bem-sucedida. Veja os exemplos a seguir:

Bom comando: mude a cor da primeira série para #F4B400 se ela for maior que 1.800.

Comando ruim: destaque os valores mais altos em amarelo.

O menu do Assistente de Visualização mostra uma prévia de um comando que muda a cor da primeira série de valores acima de 1.800.

Se você tiver várias séries em uma visualização, tente se referir a elas pelo nome, e não pela posição no gráfico.

Comando: transforme a série do meio em uma coluna

Comando melhor: transforme a série de usuários em uma coluna

O menu do Assistente de Visualização mostra uma prévia de um comando que muda a segunda de três séries, chamada "usuários", para um gráfico de colunas

Usar comandos como ponto de partida

As personalizações mais complexas podem exigir edições diretas no JSON. Use os comandos do Assistente de Visualização para criar modelos e padrões de personalizações complexas e, em seguida, use a opção Editar configuração do gráfico para escrever e editar manualmente as opções de formatação JSON. Acesse a documentação Como personalizar visualizações usando o Editor de configuração de gráficos para saber mais sobre o uso do JSON do Highcharts.

Comandos de amostra

Teste os comandos de exemplo a seguir para ter ideias de como o Assistente de Visualização pode ajudar você a começar a personalizar suas visualizações:

  • "Transforme este gráfico em um gráfico de colunas"
  • "Adicionar rótulos de dados ao gráfico"
  • "Defina a margem do gráfico como 100px"
  • "Defina a cor da linha como vermelho"
  • "Defina a cor do plano de fundo do gráfico como rosa"
  • "Defina a forma do marcador da série de linhas como triângulo"

Enviar feedback

Você pode enviar feedback sobre a prévia da visualização no menu de comandos do Assistente de visualização. Se a prévia gerada estiver correta, clique no ícone de aprovação thumb_up. Se a prévia gerada estiver incorreta ou não for o que você esperava, clique no ícone de thumb_down.