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 para acelerar a personalização das visualizações do Looker. A personalização de visualizações com o Visualization Assistant é um recurso do Gemini no Looker disponível nas instâncias do Looker (original) e do Looker (Google Cloud Core).
O Asistente de visualização está disponível para visualizações que usam a API HighCharts, que inclui a maioria dos gráficos cartesianos, como gráfico de colunas, gráfico de barras e 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 criar visualizações com a ajuda do Gemini, observe os seguintes requisitos:
- O Gemini no Looker precisa estar ativado para sua instância do Looker:
- Para o Looker (original), a instância precisa estar executando o Looker 25.2 ou mais recente e precisa ser ativada para o Gemini no Looker nas configurações de administrador. Para instruções detalhadas de ativação, consulte a página de documentação Configurações do administrador: Gemini no Looker.
- No Looker (Google Cloud Core), a instância precisa ser ativada para o Gemini no Looker no console do Google Cloud. Para instruções detalhadas de ativação, consulte a página de documentação Administrar o Gemini na sua instância do Looker (Google Cloud Core).
- Você precisa ter um papel do Looker que contenha a permissão
can_override_vis_config. - Você precisa ter o papel de Gemini do Looker.
Como usar o Assistente de visualização
Para personalizar uma visualização com o Assistente de visualização, siga estas etapas:
- Visualize uma visualização compatível em uma Análise ou edite uma visualização em um Look ou painel.
- Abra o menu Editar na visualização.
- Clique em pen_spark Visualization Assistant para abrir o menu de instruções.
No menu de comando Visualization Assistant pen_spark, é possível fazer o seguinte:
- Digite um comando de texto simples de mudanças para a visualização no campo Pergunte o que quiser. Para enviar send_spark sua solicitação, pressione Return (Mac) ou Enter (PC).
- Aplique as sugestões geradas à visualização.
- Abra Editar configuração do gráfico para gravar e editar manualmente as opções de formatação JSON.
- Limpar substituições de gráfico para limpar todas as mudanças personalizadas aplicadas à visualização. Você vai precisar confirmar a remoção de todas as mudanças antes de continuar. Se você limpou as alterações por acidente, é possível recuperá-las navegando de volta no histórico do navegador.
Quando o comando for executado, uma janela de visualização será aberta com as opções de:
- Escreva e edite 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 Visualization Assistant para retornar ao menu de instruções.
- Começar uma nova solicitação: clique em Start Over para iniciar uma nova solicitação no menu Visualization Assistant pen_spark. Todas as mudanças não aplicadas serão perdidas.
- Aplique as mudanças da visualização à visualização: clique em Aplicar. Se houver mudanças no menu Configuração do gráfico, essa opção vai mudar para Revalidar e aplicar.
- Envie feedback sobre a utilidade da resposta: selecione thumb_up para indicar que a resposta foi útil ou thumb_down para indicar que a resposta não foi o esperado.
Uma mensagem de erro Invalid JSON detected vai aparecer se você tentar visualizar o código que contém JSON inválido. É possível limpar JSONs inválidos usando a opção Autofix code edit_fix_auto na parte de baixo do painel Chart Config.
Como criar comandos bem-sucedidos
Escrever comandos eficazes pode exigir prática. Tente algumas das sugestões a seguir para escrever comandos que atinjam sua meta.
Dividir comandos em várias partes
As instruções têm mais sucesso 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 essas solicitações separadamente. Depois de aprovar as mudanças geradas, aplique-as e comece a escrever a próxima instrução.
Instrução: transforme a última série em uma linha.
Instrução: mude a fonte para Arial e aplique negrito
Tente escrever uma instrução 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 gerar uma saída mais bem-sucedida. Veja os exemplos a seguir:
Boa instrução: faça a primeira série #F4B400 se ela for maior que 350000.
Instrução inadequada: destaque os valores principais em amarelo
Se você tiver várias séries em uma visualização, tente se referir a elas pelo nome, em vez de pela posição no gráfico.
Instrução: transformar a série do meio em uma coluna
Melhor instrução: torne a série de usuários uma coluna
Usar comandos como ponto de partida
Personalizações particularmente complexas podem exigir edições diretas no JSON. Tente usar as instruções do Visualization Assistant para criar modelos e padrões para personalizações complexas e, em seguida, use o Edit Chart Config para gravar e editar manualmente as opções de formatação JSON. Acesse a documentação 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
Use os exemplos de instruções a seguir para ter ideias de como o Assistente de visualização pode ajudar você a começar a personalizar suas visualizações:
- "Transformar este gráfico em um de colunas"
- "Adicionar legendas de dados ao gráfico"
- "Definir a margem do gráfico como 100 px"
- "Definir a cor da linha como vermelho"
- "Definir a cor do plano de fundo do gráfico como rosa"
- "Definir a forma do marcador da série de linhas como triângulo"
Gerar feedback
Você pode enviar feedback sobre a visualização no menu de comando do Visualization Assistant. Se a visualização gerada estiver correta, clique no ícone de aprovação thumb_up. Se a visualização gerada estiver incorreta ou não for o esperado, clique no ícone de reprovação thumb_down.
Você também pode enviar seu feedback por e-mail.