Consultar um painel definido pelo usuário com um agente de painel

Com a Análise Conversacional, que usa o Gemini para Google Cloud, você pode investigar seus dados fazendo perguntas sobre eles em linguagem natural por uma interface de chat intuitiva. Quando você usa a Análise conversacional com um painel definido pelo usuário, a Análise conversacional cria um agente de dados conectado ao painel. Enquanto você conversa com o agente do painel, ele consulta seu painel e todos os blocos vinculados a consultas. É possível personalizar agentes de painel definidos pelo usuário com contexto e instruções específicas para os dados do painel.

Nesta página, explicamos como usar a Análise Conversacional para interagir com dados do painel definidos pelo usuário. Ele abrange os seguintes tópicos:

Antes de começar

Antes de usar o Conversational Analytics para interagir com os dados do painel, verifique se a configuração e os requisitos da sua instância do Looker foram atendidos e se você recebeu as permissões adequadas para realizar as tarefas descritas nesta página.

Iniciar uma conversa em um painel do Looker

Para iniciar uma conversa com um agente de painel em um painel definido pelo usuário, selecione faísca Chat com este painel.

Se você não tiver permissões suficientes para conversar com o painel, o Looker vai mostrar um erro.

Depois de criar uma conversa, você pode fazer perguntas sobre os dados no campo Fazer uma pergunta do . Para acessar suas conversas recentes com o agente do painel, selecione more_vert Menu > Conversas recentes.

Além de fazer perguntas ao agente do painel sobre os dados no painel ou nos blocos vinculados à consulta, para agentes de painel definidos pelo usuário, você pode personalizar a configuração do agente com mais contexto e instruções.

Ativar ou desativar agentes do painel para um painel

Se os agentes do painel estiverem ativados para sua instância, eles também estarão para todos os painéis definidos pelo usuário por padrão. No entanto, os criadores de painéis podem controlar se os usuários podem conversar com um painel definido pelo usuário específico ativando ou desativando a configuração do agente do painel no nível individual.

Para ativar ou desativar um agente de painel em um painel definido pelo usuário, siga estas etapas:

  1. Selecione o ícone de menu more_vert Ações do dashboard e depois edit Editar dashboard.
  2. Clique em configurações Configurações na barra de ferramentas do painel.
  3. Na caixa de diálogo Configurações, selecione a guia Geral.
  4. Ative ou desative o controle Ativar chat com dashboard.
  5. Clique em Salvar para salvar as mudanças no painel.

Metadados de conversas

O painel Conversar com este painel oferece suporte às seguintes tarefas para painéis definidos pelo usuário:

  • Para fazer uma pergunta sobre os dados do painel, digite uma dúvida no campo Faça uma pergunta.
  • Para editar informações sobre o agente do painel, selecione tune Gerenciar agente. Na guia Editor, você pode inserir instruções do agente e expandir Opções avançadas para configurar opções como Mostrar raciocínio e Mostrar informações de depuração. Selecione Atualizar para salvar as mudanças no agente do painel. Use a guia Visualização para conferir uma prévia das mudanças feitas no agente do painel.
  • Para expandir o painel de conversa do agente do painel, selecione open_in_full Ver em tela cheia.
  • Para acessar suas conversas recentes com o agente do painel, selecione more_vert Menu > Conversas recentes.
  • Por padrão, as conversas recebem nomes com base na sua pergunta inicial. Para renomear uma conversa, selecione uma opção no menu Conversas recentes, clique em more_vert e em edit Renomear.
  • Para excluir uma conversa com um agente de dados, selecione more_vert Menu > delete Lixeira.

Modificar o agente do painel

Para editar informações sobre o agente do painel, selecione tune Gerenciar agente.

Se quiser, expanda Opções avançadas na guia Editor para configurar o seguinte:

  • Ativar a análise avançada: ative essa configuração para permitir que o agente use a análise avançada, que traduz suas perguntas em linguagem natural para código Python e executa esse código para fornecer análises e visualizações avançadas. Essa configuração só fica visível quando a configuração de administrador Análise avançada está ativada na página Administrador do Gemini no Looker da sua instância.
  • Mostrar raciocínio: ative essa opção para permitir que o agente mostre as etapas de raciocínio, as consultas do Looker geradas e as tabelas de dados subjacentes em todas as respostas de cada conversa.
  • Mostrar informações de depuração: ative essa opção para permitir que o agente mostre as etapas executadas em todas as respostas de cada conversa.

Selecione Atualizar para salvar as mudanças no agente do painel. Use a guia Visualização para conferir uma prévia das mudanças no agente do painel.

Escrever instruções para o agente

Você pode adicionar instruções de formato livre que definem o comportamento principal do seu agente de dados e fornecem um contexto fundamental para considerar antes de processar um comando do usuário.

Confira alguns exemplos de contexto que você pode fornecer no campo Instruções:

  • Campos principais: os campos mais importantes para análise
  • Campos excluídos: campos que o agente de dados deve evitar
  • Filtragem e agrupamento: campos que o agente deve usar para filtrar e agrupar dados
  • Persona: uma função ou especialidade, um personagem ou um tom que você atribui ao agente

Para dicas e práticas recomendadas sobre como escrever instruções para o agente, consulte a página de documentação Práticas recomendadas para configurar o Conversational Analytics no Looker.

Fazer perguntas sobre dados do Looker

Ao iniciar uma nova conversa, a Análise Conversacional sugere algumas perguntas para começar. As perguntas não precisam estar em um formato específico nem usar uma sintaxe específica. No entanto, elas precisam estar relacionadas à análise detalhada selecionada.

Digite sua pergunta em linguagem natural no campo Fazer uma pergunta. Selecione um modo de pergunta e clique em Enviar. Depois de enviar a consulta, você pode cancelar a resposta da Análise Conversacional clicando em Interromper resposta. A Análise de conversas interrompe a execução da consulta e mostra a seguinte mensagem: The query was cancelled.

Para mais orientações sobre os tipos de perguntas que você pode fazer, consulte Limitações de perguntas.

Selecione um modo de pergunta

Ao fazer uma pergunta, você pode selecionar o modo de pergunta em um menu suspenso com as seguintes opções:

  • Rápido (padrão): ideal para a maioria das perguntas.
  • Raciocínio: raciocínio detalhado.

A Análise Conversacional usa o modo de pergunta Rápido por padrão. A Análise de conversas vai manter o mesmo modo de pergunta em todas as conversas multiturno, a menos que você mude manualmente.

Modo rápido

O modo Rápido é recomendado para a maioria das perguntas e está selecionado por padrão. No modo Rápido, a Análise Conversacional mapeia sua consulta em linguagem natural diretamente para os parâmetros da LookML definidos nos modelos que embasam o painel ou as análises detalhadas da sua conversa. A análise conversacional responde rapidamente sem gastar tokens extras pensando ou transmitindo resumos de ideias no chat.

As consultas no modo Rápido têm o mesmo nível de precisão que as consultas no modo Raciocínio. Use o modo Rápido para suas perguntas, a menos que você queira ver especificamente o processo de raciocínio do agente.

Modo de pensamento

No modo Pensando, o agente usa mais tokens para analisar a solicitação e transmite um resumo dos pensamentos diretamente no chat enquanto processa sua consulta, mostrando as etapas de raciocínio detalhado do agente.

Embora o modo Pensando não produza respostas mais precisas do que o modo Rápido, mostrar o raciocínio do agente permite observar como a Análise de conversas interpreta sua consulta, planeja as etapas analíticas e faz referência aos modelos LookML subjacentes.

Selecione o modo Pensando se quiser inspecionar as etapas detalhadas de raciocínio do agente ou testar como ele interage com suas fontes de dados e quiser gastar os tokens extras necessários para pensar.

Conversas com vários turnos

A análise de conversas considera as perguntas e respostas anteriores enquanto você continua a conversa. Você pode usar respostas anteriores e criar com base nelas, refinando ainda mais os resultados ou mudando o tipo de visualização.

Para mais orientações sobre como criar perguntas, consulte Limitações das perguntas.

Gerenciar consultas em uma conversa

Ao conversar com dados, você pode gerenciar a conversa interrompendo uma resposta de consulta ativa enquanto ela está em execução ou excluindo a pergunta e a resposta mais recentes.

Excluir a pergunta mais recente

Para excluir a pergunta e a resposta mais recentes, siga estas etapas:

  1. Passe o cursor sobre a pergunta mais recente e clique em Excluir mensagem.
  2. Na caixa de diálogo Excluir a mensagem permanentemente?, clique em Excluir para excluir permanentemente a pergunta e a resposta.

Entender os resultados e cálculos da consulta

A Análise de conversas oferece os seguintes parâmetros para entender os resultados e cálculos das consultas:

Determinar como sua consulta foi interpretada

Se você usar o modo Raciocínio para fazer sua pergunta, poderá ver como a Análise Conversacional processou sua consulta. Para conferir o raciocínio, expanda a opção Mostrar raciocínio. Para ocultar o raciocínio, clique em Ocultar raciocínio.

A Análise Conversacional analisa cada consulta e pensa em como responder, usando as palavras-chave da consulta para inferir as dimensões, métricas e outros parâmetros relevantes da camada semântica dos conjuntos de dados associados da conversa e interpretando da consulta quais agregações podem precisar ser realizadas. Ao abrir Mostrar raciocínio, a Análise de conversas mostra uma explicação em texto simples das etapas seguidas para interpretar sua consulta. A explicação também inclui a duração em que a análise conversacional pensou na consulta.

Determinar como uma resposta foi calculada

Para saber como a Análise de conversação chegou a uma resposta ou criou uma visualização, clique em Como isso foi calculado? nos resultados da consulta.

Ao clicar em Como isso foi calculado?, A Análise Conversacional mostra uma seção Texto. A seção Texto oferece uma explicação em texto simples das etapas realizadas pela Análise Conversacional para chegar à resposta. Essa explicação inclui os nomes de campos brutos usados, os cálculos feitos, os filtros aplicados, a ordem de classificação e outros detalhes.

Detalhes analíticos e informações de depuração

Se o agente de dados usado na conversa tiver opções avançadas específicas ativadas, as respostas poderão conter os seguintes detalhes:

  • Mostrar raciocínio: se ativada, a resposta do agente mostra as etapas de raciocínio, as consultas do Looker geradas e as tabelas de dados subjacentes.
  • Mostrar informações de depuração: se ativada, a resposta do agente mostra as etapas executadas por ele para essa resposta, o que pode ajudar na solução de problemas.

Essas configurações são definidas nas opções avançadas ao modificar o agente do painel.

Gerenciar conversas

Cada conversa permanece na seção Conversas recentes do painel more_vert Menu. Você pode mudar os nomes das conversas, excluir ou restaurar da lixeira.

  • Para acessar suas conversas recentes com o agente do painel, selecione more_vert Menu > Conversas recentes.
  • Por padrão, as conversas recebem nomes com base na sua pergunta inicial. Para renomear uma conversa, selecione uma opção no menu Conversas recentes, clique em more_vert e em edit Renomear.
  • Para excluir uma conversa com um agente de dados, selecione more_vert Menu > delete Lixeira.

Excluir uma conversa

Para excluir uma conversa com um agente de dados, selecione o menu de três pontos more_vert da conversa e clique em delete Excluir.

Restaurar ou excluir uma conversa permanentemente

Para restaurar ou excluir permanentemente uma conversa da lixeira, siga estas etapas:

  1. Selecione more_vert Menu > delete Lixeira.
  2. No painel Lixeira, encontre a conversa que você quer restaurar ou excluir permanentemente. Selecione o menu de três pontos more_vert da conversa e escolha uma das seguintes opções:
    • Restaurar: restaura a conversa. A conversa pode ser acessada na opção de menu Conversas recentes.
    • Excluir permanentemente: exclui a conversa de forma definitiva.