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

A Análise Conversacional, com tecnologia do Gemini para Google Cloud, permite investigar seus dados fazendo perguntas sobre eles em linguagem conversacional por meio de uma interface de chat intuitiva. Quando você usa a Análise Conversacional com um painel definido pelo usuário, ela fornece um único agente padrão compartilhado conectado ao painel. Todos os usuários com permissão para conversar com o painel conversam com esse agente compartilhado. Ao conversar com o agente do painel, ele consulta o painel e todos os blocos vinculados à consulta. Os usuários com permissões de edição no painel podem personalizar o agente padrão com contexto e instruções específicos para os dados do painel, o que atualiza o comportamento do agente para todos os usuários que consultam o painel.

Esta página discute como usar a Análise Conversacional para interagir com dados de painel definidos pelo usuário. 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 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 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 dentro 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 à 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 painéis definidos 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, você pode inserir instruções do agente e expandir Opções avançadas para configurar configurações como Mostrar pensamento e Mostrar informações de depuração. Selecione Atualizar para salvar as alterações no agente do painel. Use a guia Prévia para visualizar as 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 serã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 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 configuraçõ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 da Análise avançada está ativada na página Administrador do Gemini no Looker da sua instância.
  • Mostrar pensamento: 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 para todas as respostas em cada conversa.

Selecione Atualizar para salvar as alterações no agente do painel. Use a guia Prévia para visualizar as alterações no agente do painel.

Escrever instruções do agente

Você pode adicionar instruções de formato livre que definem o comportamento principal do agente de dados e fornecer 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 para de executar a 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 seguintes opções:

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

A Análise Conversacional é definida como o modo de pergunta Rápido por padrão. A Análise Conversacional vai manter o mesmo modo de pergunta em todas as conversas com vários turnos, a menos que você o mude manualmente.

Modo rápido

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

As consultas no modo Rápido fornecem 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 raciocínio

No modo Pensamento, o agente gasta tokens extras pensando na solicitação e transmite um resumo de pensamentos diretamente no chat enquanto processa sua consulta, visibilidade às etapas de raciocínio detalhado do agente.

Embora o modo Pensamento não produza respostas mais precisas do que o modo Rápido , mostrar o raciocínio do agente permite observar como a Análise Conversacional interpreta sua consulta, planeja as etapas analíticas e referencia os modelos do LookML subjacentes.

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

Conversas com vários turnos

A Análise Conversacional vai considerar as perguntas e respostas anteriores à medida que você continua a conversa. Você pode 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, você pode 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 pensamento. Para ocultar o raciocínio, clique em Ocultar pensamento.

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. Quando você expande Mostrar raciocínio, a Análise Conversacional mostra uma explicação de texto simples das etapas que foram necessárias 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 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 de texto simples das etapas que foram necessárias para que a Análise Conversacional chegasse à resposta fornecida. Essa explicação inclui os nomes de campos brutos que foram 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 pensamento: 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 da conversa do painel. Você pode 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 serã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 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 a conversa permanentemente.