Consultar um painel com um agente de painel

Com a Análise de conversação, 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 as Análises de conversação com um painel definido pelo usuário ou um painel do LookML, as Análises de conversação criam 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 conversação para interagir com os dados do painel. Ele abrange os seguintes tópicos:

Antes de começar

Antes de usar a Análise de conversação 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 ou um dashboard do LookML, selecione brilho Conversar com este painel.

Depois de criar uma conversa, você pode fazer perguntas sobre os dados no campo Faça 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.

Resumos do painel (prévia)

Quando o recurso de resumos do painel está ativado, um resumo é gerado automaticamente quando você seleciona spark Conversar com este painel. O resumo aparece na parte de cima da conversa e fornece o seguinte:

  • Uma visão geral dos dados que aparecem no painel
  • Principais destaques de dados
  • Uma breve interpretação da importância dos dados

Para detalhes sobre como ativar esse recurso, consulte a página de documentação Configurar a Análise de conversação no Looker.

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, 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 para o agente. 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.
  • 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 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.

dashboard do LookML

  • Para fazer uma pergunta sobre os dados do painel, digite uma dúvida no campo Faça uma pergunta.
  • 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, uma conversa recebe um nome 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. Na guia Editor, você pode inserir instruções para o agente. As instruções fornecem contexto para ajudar as Análises de conversação a entender como interagir com seus dados e fornecer respostas precisas e relevantes. 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
  • Consultas de ouro: pares de perguntas em linguagem natural e as consultas do recurso Detalhar correspondentes
  • 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 a Análise Conversacional no Looker.

Definir uma consulta de ouro do Looker

Para definir cada consulta de ouro do Looker para uma determinada pergunta, forneça valores para os dois campos a seguir:

  • natural_language_questions: a pergunta em linguagem natural que um usuário pode fazer
  • looker_query: a consulta de ouro do Looker que corresponde à pergunta em linguagem natural

Para o campo natural_language_questions, considere as perguntas que um usuário pode fazer sobre essa análise detalhada e escreva essas perguntas em linguagem natural. É possível incluir mais de uma pergunta no valor desse campo. É possível obter o valor do campo looker_query nos metadados da consulta do recurso Detalhar.

As consultas de ouro são compatíveis com os seguintes campos:

  • model (string): o modelo do LookML usado para gerar a consulta. Este campo é obrigatório.
  • explore (string): a Análise usada para gerar a consulta. Este é um campo obrigatório.
  • fields[] (string): os campos a serem recuperados da Análise, incluindo dimensões e medidas. Esse campo é opcional.
  • filters[] (string): os filtros a serem aplicados à Análise. Esse campo é opcional.
  • sorts[] (string): a classificação a ser aplicada à Análise. Esse campo é opcional.
  • limit (string): o limite de linhas de dados a ser aplicado à Análise. Esse campo é opcional.

Fazer perguntas sobre dados do Looker

Ao iniciar uma nova conversa, as Análises de Conversação sugerem algumas perguntas para começar. As perguntas não precisam estar em um formato ou 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 das Análises de Conversação 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 de Conversação 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 de conversação 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. As Análises de conversação conseguem responder rapidamente porque dependem das definições controladas da sua LookML e não usam nem mostram 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 pedir fatos específicos ou métricas predefinidas dos seus dados.

Modo de pensamento

O modo Pensar é 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 excluir permanentemente a pergunta e a resposta.

Entender os resultados e cálculos da consulta

As Análises de Conversação fornecem detalhes sobre como sua consulta foi interpretada.

Determinar como sua consulta foi interpretada

Se você usar o modo de pensamento para fazer sua pergunta, poderá ver como a Análise de conversação 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.

O Conversational Analytics 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 à conversa e interpretando da consulta quais agregações precisam ser realizadas. Quando você expande Mostrar raciocínio, o Conversational Analytics mostra uma explicação em texto simples das etapas que foram seguidas para interpretar sua consulta. A explicação também inclui a duração em que o Conversational Analytics 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 de conversas mostra uma seção Texto. Essa seção fornece uma explicação em texto simples das etapas realizadas pela Análise de conversas para chegar à resposta. Essa explicação inclui os nomes dos campos brutos usados, os cálculos feitos, os filtros aplicados, a ordem de classificação e outros detalhes.

Gerenciar conversas

Cada conversa permanece na seção Conversas recentes do painel more_vert Menu. É possível mudar os nomes, excluir ou restaurar conversas 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.

Limitações conhecidas

Os agentes do painel do Conversational Analytics têm as seguintes limitações conhecidas:

  • O Advanced Analytics não é compatível com agentes de painel.
  • Os agentes do painel consultam o modo de produção dos dados do painel.
  • Os agentes do painel não podem ser compartilhados com outros usuários.
  • Os agentes de painel não são compatíveis quando a Análise Conversacional é incorporada a um site ou aplicativo.
  • 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 gerar gráficos de conversas. 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, empilhadas)
  • 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. Os gráficos não especificados nesta seção são considerados sem suporte.

Limitações nas fontes de dados

O Conversational Analytics tem as seguintes limitações de fonte de dados:

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

Limitações das perguntas

A Análise de dados de conversação é 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 de dados de conversação ainda não é compatível com perguntas que só podem ser respondidas com os seguintes tipos de visualizações complexas:

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