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 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 explorando dados em uma instância do Looker.
Antes de começar
Para personalizar visualizações com a assistência do Gemini, observe os seguintes requisitos:
- O Gemini no Looker precisa estar ativado na sua instância do Looker:
- Para o Looker (original), a instância precisa executar o Looker 25.2 ou uma versão mais recente e estar 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 de administrador: Gemini no Looker.
- Para o Looker (Google Cloud Core), a instância precisa estar ativada para o Gemini no Looker no Google Cloud console. Para instruções detalhadas de ativação, consulte a página de documentação Administrar o Gemini na instância do Looker (Google Cloud Core).
- Você precisa receber um papel do Looker que contenha as permissões
gemini_in_lookerecan_override_vis_config.
Como usar o Assistente de visualização
Para personalizar uma visualização com o Assistente de visualização, siga estas etapas:
- Veja 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 Assistente de visualização para abrir o menu de comandos.

No menu de comandos do pen_spark Assistente de visualização, você pode 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 o comando, pressione "Return" (Mac) ou "Enter" (PC).
- Aplique Sugestões geradas à visualização.
- Abra a Configuração de edição do gráfico para escrever e editar manualmente as opções de formatação JSON.
- Limpe as substituições de gráfico para limpar todas as mudanças personalizadas aplicadas à visualização. Você vai receber uma solicitação para Confirmar a remoção de todas as mudanças antes de continuar. Se você limpar as mudanças por engano, é possível recuperá-las navegando de volta no histórico de navegação.
Depois que o comando for executado, uma janela de visualização será aberta com as opções para:

- 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 retornar ao menu de comandos.
- Iniciar um novo comando: clique em Recomeçar para iniciar um novo comando no menu do pen_spark Assistente de visualização. Todas as mudanças não aplicadas serão perdidas.
- Aplicar as mudanças visualizadas à visualização: clique em Aplicar. Se as mudanças forem feitas no menu Configuração do gráfico, essa opção será alterada para Revalidar e aplicar.
- Enviar feedback sobre a utilidade da resposta do comando: selecione thumb_up para indicar que a resposta do comando foi útil ou selecione thumb_down para indicar que a resposta não era o esperado.
Uma mensagem de erro Invalid JSON detected vai aparecer se você tentar visualizar um código que contenha um JSON inválido. É possível limpar o JSON inválido usando a opção Código de correção automática edit_fix_auto na parte de baixo do painel Configuração do gráfico.
Como criar comandos bem-sucedidos
Escrever comandos bem-sucedidos exige prática. Confira algumas das sugestões a seguir para escrever comandos que atinjam seu objetivo.
Dividir comandos em várias partes
Os comandos têm mais sucesso quando se concentram em uma mudança por vez. Por exemplo, se você quiser mudar a família de fontes e o tipo de visualização, é melhor fazer comandos separados. Depois de aprovar as mudanças geradas, aplique-as e comece a escrever o próximo comando.
Comando: mude a última série para uma linha

Comando: mude a fonte para Arial e deixe-a em negrito

Tente escrever um comando de várias maneiras
Se você não estiver recebendo os resultados esperados do comando, tente reformulá-lo. 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: deixe a primeira série #F4B400 se ela for maior que 350.000
Comando ruim: destaque os principais valores em amarelo

Se você tiver várias séries em uma visualização, tente se referir à série pelo nome em vez da posição dela no gráfico.
Comando: deixe a série do meio como uma coluna
Comando melhor: deixe a série de usuários como uma coluna

Use comandos como ponto de partida
Personalizações particularmente complexas podem exigir edições diretamente no JSON. Tente usar os comandos do Assistente de visualização para criar modelos e padrões para personalizações complexas e, em seguida, use a Configuração de ediçã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 do gráfico para saber mais sobre o uso do JSON do HighCharts.
Comandos de amostra
Confira os comandos de amostra 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"
- "Adicione rótulos de dados ao gráfico"
- "Defina a margem do gráfico como 100 px"
- "Defina a cor da linha como vermelho"
- "Defina a cor 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 para a visualização de prévia no menu de comandos do Assistente de visualização. 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 que você esperava, clique no ícone de reprovação thumb_down.