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 de conversas 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 da conversa. 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 a consultas, é possível personalizar a configuração do agente com mais contexto e instruções para agentes definidos pelo usuário.

Ativar ou desativar agentes do painel para um painel

Se os agentes do dashboard estiverem ativados na sua instância, eles também estarão em todos os dashboards 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 no nível do painel 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 clique em 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 no agente do painel.
  • Para expandir o painel de conversa do agente do painel, selecione open_in_full Ver tela cheia.
  • Para acessar suas conversas recentes com o agente do painel, selecione more_vert Menu > Conversas recentes.
  • Por padrão, as conversas são nomeadas com base na sua pergunta inicial. Para renomear uma conversa, selecione uma opção no menu Conversas recentes, clique em more_vert e em Editar 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 as seguintes opções:

  • 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 de 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 as 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: um papel ou uma 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 a Análise Conversacional 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, eles precisam estar relacionados à 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. O Conversational Analytics 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 no menu suspenso com as opções Rápido e Pensando. A interface descreve Rápido como uma opção para respostas rápidas e Raciocínio como uma opção para resolver problemas complexos. Por padrão, a Análise Conversacional usa o modo de perguntas Pensando. A Análise de conversas mantém o mesmo modo de pergunta em todas as conversas multiturno, a menos que você mude manualmente.

Modo rápido

Quando você faz uma pergunta no modo Rápido, a Análise Conversacional tenta mapear diretamente sua consulta em linguagem natural 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 consegue responder rapidamente porque depende das definições controladas da sua LookML e não usa nem mostra nenhum tipo de raciocínio.

Por exemplo, uma consulta como "Qual foi nossa receita total no mês passado?" pode ser traduzida rapidamente em uma consulta que seleciona a métrica total_revenue e filtra o mês anterior.

Selecione o modo Rápido se a consulta estiver pedindo fatos específicos ou métricas predefinidas dos seus dados.

Modo de pensamento

O modo Pensando é destinado a solicitações analíticas mais complexas que exigem análise além de pesquisas diretas do LookML. Nesse modo, o agente "planeja" a abordagem, decidindo quais ferramentas usar e como combinar os resultados. Esse modo permite resolver problemas de várias etapas e realizar tarefas avançadas de ciência de dados que não seriam possíveis com uma única consulta baseada em SQL.

Selecione o modo Pensando ao perguntar por que sobre seus dados, comparar tendências ou fazer solicitações analíticas mais complexas que podem exigir várias etapas. Esse modo também é especialmente útil ao testar um agente para entender como ele está usando a LookML das fontes de dados.

Conversas com vários turnos

A Análise Conversacional vai considerar 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 remover a pergunta e a resposta de forma definitiva.

Entender os resultados e cálculos da consulta

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

Determinar como sua consulta foi interpretada

Se você usar o modo Pensar para fazer sua pergunta, poderá ver como a Análise Conversacional raciocinou sobre 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 sua 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 usadas 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 Conversational Analytics 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 pelo Conversational Analytics 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 menu 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 são nomeadas com base na sua pergunta inicial. Para renomear uma conversa, selecione uma opção no menu Conversas recentes, clique em more_vert e em Editar 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 Excluir 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.