Consultar um painel com um agente de painel

A Análise Conversacional, com tecnologia do Gemini Google Cloud, permite investigar seus dados fazendo perguntas sobre eles em linguagem conversacional por meio de uma interface de chat intuitiva. Ao usar a Análise Conversacional com um painel definido pelo usuário ou um painel do LookML, a Análise Conversacional cria um agente de dados conectado ao painel. À medida que você conversa com o agente do painel, ele consulta o painel e todos os blocos vinculados à consulta. É possível personalizar os agentes de painel definidos pelo usuário com contexto e instruções específicos para os dados do painel.

Esta página discute como usar a Análise Conversacional para interagir com os dados do painel. Ele abrange os seguintes tópicos:

Antes de começar

Antes de usar a Análise Conversacional para interagir com os dados do painel, verifique se a configuração e os requisitos da 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 ou um painel do LookML, selecione spark Conversar 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. 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 de painel para um painel

Se os agentes de painel estiverem ativados para sua instância, eles serão ativados 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 de painel no nível do painel individual.

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

  1. Selecione o ícone do menu more_vert Ações do painel e selecione edit Editar painel.
  2. Clique em settings 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 o painel.
  5. Clique em Salvar para salvar as alterações no painel.

Metadados de conversas

O painel Conversar com este painel oferece suporte às seguintes tarefas para cada tipo de painel:

Painel definido pelo usuário

  • Para fazer uma pergunta sobre os dados do painel, insira uma pergunta no campo Fazer uma pergunta.
  • Para editar informações sobre o agente do painel, selecione tune Gerenciar agente. Na guia Editor, é possível inserir instruções do agente e expandir Opções avançadas para configurar definições como Mostrar raciocínio e Mostrar informações de depuração. Selecione Atualizar para salvar as alterações no agente do painel. Use a guia Visualização para conferir uma prévia das alterações 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 conversa na opção de menu Conversas recentes , selecione more_vert e, em seguida, selecione edit Renomear.
  • Para excluir uma conversa com um agente de dados, selecione more_vert Menu > delete Lixeira.

dashboard do LookML

  • Para fazer uma pergunta sobre os dados do painel, insira uma pergunta no campo Fazer uma pergunta.
  • 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, uma conversa é nomeada com base na sua pergunta inicial. Para renomear uma conversa, selecione uma conversa na opção de menu Conversas recentes , selecione more_vert e, em seguida, selecione 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.

Opcionalmente, você pode expandir Opções avançadas na guia Editor para configurar as seguintes definições:

  • Mostrar raciocínio: ative esse botão para mostrar as etapas de raciocínio do agente, as consultas do Looker geradas e as tabelas de dados subjacentes nas respostas.
  • Mostrar informações de depuração: ative esse botão para mostrar as etapas executadas por o agente por resposta para facilitar a solução de problemas.

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

Escrever instruções do agente

É possível adicionar instruções de formato livre que definem o comportamento principal do agente de dados e fornecem um contexto básico a ser considerado antes de processar um comando do usuário.

Confira alguns exemplos dos tipos 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 especialização, personagem ou tom que você atribui ao agente

Para dicas e práticas recomendadas para escrever instruções do agente, consulte a página de documentação Práticas recomendadas para configurar a Análise Conversacional no Looker.

Fazer perguntas sobre os dados do Looker

Ao iniciar uma nova conversa, a Análise Conversacional sugere algumas perguntas iniciais. As perguntas não precisam estar em um formato específico ou usar uma sintaxe específica. No entanto, elas precisam estar relacionadas à análise 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 Parar resposta. A Análise Conversacional 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 nas perguntas.

Selecionar um modo de pergunta

Ao fazer uma pergunta, você pode selecionar o modo de pergunta em um menu suspenso que contém as opções Rápido e Pensamento. A interface descreve Rápido como destinado a responder rapidamente e Pensamento como destinado a resolver problemas complexos. A Análise Conversacional usa o modo de pergunta Pensamento por padrão. A Análise Conversacional vai manter o mesmo modo de pergunta em todas as conversas multiturno, a menos que você o mude manualmente.

Modo rápido

Ao fazer uma pergunta no modo Rápido, a Análise Conversacional tenta mapear diretamente sua consulta em linguagem natural para os parâmetros LookML definidos nos modelos LookML que estão na base do painel ou das análises da conversa. A Análise Conversacional pode responder rapidamente porque depende das definições controladas do 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 medida 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 Pensamento é 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 podem não ser possíveis com uma única consulta baseada em SQL.

Selecione o modo Pensamento ao perguntar por que sobre seus dados, ao comparar tendências ou ao 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 o LookML subjacente das fontes de dados.

Conversas multiturno

A Análise Conversacional vai considerar as perguntas e respostas anteriores à medida que você continua a conversa. É possível usar as 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 nas perguntas.

Gerenciar consultas em uma conversa

Ao conversar com dados, é possível gerenciar a conversa interrompendo uma resposta de consulta ativa enquanto ela está em execução ou excluindo a pergunta mais recente e a resposta.

Excluir a pergunta mais recente

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

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

Entender os resultados e cálculos da consulta

A Análise Conversacional fornece os seguintes parâmetros para entender os resultados e cálculos da consulta:

Determinar como a consulta foi interpretada

Se você usar Pensamento modo para fazer sua pergunta, poderá ver como a Análise Conversacional raciocinou sobre sua consulta. Para ver 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, medidas 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 expandir Mostrar raciocínio, a Análise Conversacional mostra uma explicação em texto simples das etapas que foram necessárias para interpretar sua consulta. A explicação também inclui a duração do tempo que a Análise Conversacional pensou sobre a consulta.

Determinar como uma resposta foi calculada

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

Quando você clica em Como isso foi calculado?, a Análise Conversacional mostra uma seção Texto. A seção Texto fornece uma explicação em texto simples das etapas realizadas pela Análise Conversacional para chegar à resposta fornecida. 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 para a 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 que foram executadas pelo agente 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 do painel. É possível mudar os nomes das conversas, excluir conversas ou restaurá-las da pasta "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 conversa na opção de menu Conversas recentes , selecione more_vert e, em seguida, selecione 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 selecione delete Excluir.

Restaurar ou excluir permanentemente uma conversa

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 selecione uma das seguintes opções:

    • Restaurar: restaura a conversa. A conversa pode ser acessada na opção de menu Conversas recentes.
    • Excluir permanentemente: exclui permanentemente a conversa.

Limitações conhecidas

Os agentes de painel da Análise Conversacional têm as seguintes limitações conhecidas:

  • Análise avançada não é compatível com agentes de painel.
  • Os agentes de painel consultam o modo de produção dos dados do painel.
  • Os agentes de painel herdam o modelo de compartilhamento do painel. O acesso ao agente é regido pelo acesso ao painel subjacente.
  • Não é possível modificar o contexto ou as instruções para agentes de painel do LookML.

Limitações nas visualizações

A Análise Conversacional usa o Vega-lite para geração de gráficos de conversa. Os seguintes tipos de gráficos do Vega são totalmente compatíveis:

  • Gráfico de linhas (uma ou mais séries)
  • Gráfico de área
  • Gráfico de barras (horizontal, vertical, empilhado)
  • Gráfico de dispersão (um ou mais grupos)
  • Gráfico de pizza

Os seguintes tipos de gráficos do Vega são compatíveis, mas você pode encontrar um comportamento inesperado ao renderizá-los:

  • Maps
  • Mapas de calor
  • Gráficos com dicas

Os tipos de gráficos que existem fora do catálogo do Vega não são compatíveis. Todos os gráficos que não forem especificados nesta seção serão considerados sem suporte.

Limitações nas fontes de dados

A Análise Conversacional tem as seguintes limitações de fonte de dados:

  • A Análise Conversacional pode retornar até 5.000 linhas por consulta.
  • A Análise Conversacional não pode definir o valor de um campo somente para filtro definido usando os parâmetros parameter ou filter do LookML.

Limitações nas perguntas

A Análise Conversacional é compatível com perguntas que podem ser respondidas por uma única visualização, por exemplo:

  • Tendências das métricas ao longo do tempo
  • Divisão ou distribuição de uma métrica por dimensão
  • Valores exclusivos de uma ou mais dimensões
  • Valores de uma métrica
  • Os principais valores de dimensão por métrica

A Análise Conversacional ainda não é compatível com perguntas que só podem ser respondidas com os seguintes tipos de visualizações complexas:

  • Prediction e estimativa
  • Análise estatística avançada, incluindo correlação e detecção de anomalias