Pular para o conteúdo principal
Última atualização em

Genie Agents com painéis

Dashboards publicados incluem um Genie Agent por default para permitir que os usuários de negócios explorem dados usando linguagem natural. Um Genie Agent é uma interface sem código que fornece um botão Pergunte ao Genie em dashboards publicados, permitindo que os visualizadores conversem com os dados em vez de depender apenas de visualizações predefinidas. O botão Pergunte ao Genie está disponível para os visualizadores tanto no workspace quanto quando os dashboards são incorporados usando incorporação básica. Consulte Genie Agents.

Ao publicar seu dashboard, o botão de alternância Ativar Genie está ativado por default, e o Databricks gera automaticamente um Genie Agent com base nos datasets e visualizações do seu dashboard. Alternativamente, é possível vincular a um Genie Agent existente ou desativar a alternância para desabilitar o Genie.

Genie Agents Companheiros usam modo Agente em Genie Agents, o que permite ao Genie raciocinar em vários os passos e fontes de dados para responder a perguntas complexas.

Para obter mais informações sobre os Genie Agents, consulte Genie Agents.

nota

O Ask Genie está disponível apenas em modo de incorporação básico. O Ask Genie não é compatível Genie incorporações externas. Para cenários de incorporação externa, utilize a API Genie Conversation para integrar recursos de consulta em linguagem natural.

Controle de acesso ao Genie Agent do seu dashboard​

Para habilitar ou configurar um Genie Agent para o seu painel publicado:

  1. Abra seu painel de controle.
  2. No painel direito, clique em Configurações . Ou clique Ícone do menu Kebab. o menu kebab > Configurações para abrir as configurações.
  3. Clique em Geral .
  4. O seletor Habilitar Genie está ativado por default. Desative o seletor se desejar desabilitar o Genie Agent para visualizadores do painel.
  5. (Opcional) Para vincular um Genie Agent existente, selecione o botão de opção Vincular Genie Agent existente e cole o URL associado. Se você não selecionar esta opção, o Databricks gerará automaticamente um novo Genie Agent com base no seu painel quando você publicar.

GIF mostrando a abertura de uma janela de bate-papo do Genie em um painel publicado. O usuário faz uma pergunta e o Genie responde com uma tabela de resultados.

importante

Quando os visualizadores usam o Genie, as perguntas deles são respondidas a partir dos resultados completos da query do dataset. Se uma query de dataset incluir colunas ou linhas confidenciais, esses dados ficarão disponíveis para o Genie, mesmo que não sejam mostrados em visualizações. Defina seus datasets para incluir apenas os campos e linhas aos quais você deseja que os usuários tenham acesso. Consulte Permissões para Genie Agents.

nota

Os Genie Agents Complementares não aparecem em seu navegador de arquivos ou na página de listagem do Genie. Quando o dashboard é republicado com alterações, o Genie Agent associado é atualizado automaticamente para refletir os novos datasets e visualizações.

Abra o Genie Agent​

Para abrir o Genie Agent publicado em uma nova janela:

  1. Clique no menu de Ícone do menu Kebab. kebab no canto superior direito da janela de bate-papo
  2. Clique em Abrir Genie Agent .
nota

Não é possível editar as instruções para Genie Agents gerados automaticamente na interface do usuário do Genie Agent. O Genie Agent é atualizado quando o dashboard é republicado com alterações.

Pergunte ao Genie sobre um gráfico específico​

Para perguntar ao Genie sobre um gráfico de painel específico:

  1. Clique em Ask Genie em um painel publicado habilitado para o Genie.
  2. Clique em um gráfico de painel para selecioná-lo. O Genie exibe o título do gráfico selecionado na janela de bate-papo.
  3. Faça perguntas sobre os dados representados no gráfico selecionado.

Peça à Genie para explicar as alterações no gráfico.​

Você pode pedir Genie para explicar as alterações diretamente no gráfico para visualizações de séries temporais de barras, linhas e áreas (incluindo gráficos de múltiplas séries e gráficos empilhados), células de tabelas dinâmicas, gráficos de barras horizontais, gráficos pie e mapas de calor. Genie entra no modo Agente para analisar a mudança e identificar os principais fatores.

Para explicar uma alteração no gráfico:

  1. Clique em Ask Genie em um painel publicado habilitado para o Genie.
  2. Clique com o botão direito do mouse em uma visualização compatível.
  3. Selecione a opção para pedir à Genie que explique a alteração.

O Genie analisa a alteração selecionada e retorna uma explicação com os principais fatores que contribuíram para ela.

Permissões para Genie Agents​

As permissões dependem se o Genie Agent foi gerado automaticamente ou vinculado.

Genie Agents autogerados seguem o modelo de credenciais do dashboard:

  • Se o dashboard usar credenciais incorporadas (permissão de dados compartilhados), o Genie Agent também usará credenciais incorporadas. O Genie usa as credenciais do editor para acessar dados, assim, os espectadores podem interagir com o Genie mesmo que não tenham acesso direto aos dados subjacentes.
  • Se o painel usa credenciais do leitor, o Genie Agent também usa credenciais do leitor. Aplicam-se as próprias permissões de acesso a dados de cada leitor.

Genie Agents vinculados sempre usam as configurações de credenciais configuradas no próprio Genie Agent. As configurações de credenciais do painel não têm efeito sobre um Genie Agent vinculado.

Em todos os casos, os visualizadores devem ser membros do workspace para interagir com os Genie Agents. Para saber mais sobre os tipos de acesso, consulte Gerenciar painel e acesso ao Genie.

Editar a descrição do Genie Agent do seu painel​

O Databricks gera automaticamente uma descrição com base no conteúdo do seu painel. Você pode editar a descrição a qualquer momento.

Para editar a descrição:

  1. Abra o Genie Agent.
  2. Clique em Configurar .
  3. Clique Ícone de lápis. o ícone de edição ao lado de Descrição .
  4. Insira ou edite a descrição e clique em Salvar .

Expressões SQL incompatíveis​

Os Agentes Genie vinculados não podem usar datasets que contêm as seguintes expressões SQL:

  • Cláusula Identifier com uma cadeia de caracteres não constante, como no exemplo a seguir.

    SQL
    SELECT * FROM identifier(:param)

  • Visualização temporária ou funções em um conjunto de dados com várias declarações, como no exemplo a seguir.

    SQL
    CREATE OR REPLACE TEMPORARY VIEW taxis AS SELECT * FROM samples.nyctaxis.trips;

    SELECT * FROM taxis;

  • Fazendo referência a um volume no SQL que define o dataset, como no exemplo a seguir.

    SQL
    SELECT * FROM csv.`/Volumes/catalog/schema/volume/my-data.csv`
nota

Se apenas alguns conjuntos de dados em seu dashboard usarem expressões não suportadas, o Ask Genie usará os conjuntos de dados suportados e ignorará os não suportados em vez de falhar. Por exemplo, se um conjunto de dados usar IDENTIFIER() ou uma UDF, o Ask Genie ainda responderá a perguntas dos conjuntos de dados suportados restantes.

OpenSharing​

Datasets compartilhados usando OpenSharing não são compatíveis com Genie Agents que usam credenciais incorporadas (permissão de dados compartilhados). O OpenSharing usa um sistema de credenciais incompatível com a delegação de credenciais do Genie. Para usar esses datasets com o Genie, use as credenciais do visualizador em vez das credenciais incorporadas.

Limitações​

  • O Ask Genie não é compatível com incorporação externa. Para cenários de incorporação externa, utilize a API Genie Conversation. Veja que o Ask Genie não está disponível em incorporação externa.
  • Não é possível editar as instruções para Genie Agents gerados automaticamente a partir da UI do Genie Agent.
  • Os Genie Agents complementares suportam até 30 datasets de dashboard. Se o seu dashboard usar mais de 30 datasets, apenas 30 serão incluídos no Genie Agent.
  • Filtros do painel não são transferidos para o contexto do bate-papo ao usar um Genie Agent vinculado. Filtros do painel funcionam como esperado com Genie Agents autogerados.
  • O Ask Genie ignora conjuntos de dados que contêm cláusulas de identificador com strings não constantes, views ou funções temporárias, ou referências de volume, e responde a partir dos conjuntos de dados suportados restantes. Consulte Expressões SQL Incompatíveis.
  • Datasets compartilhados usando OpenSharing não são suportados em Genie Agents que usam credenciais incorporadas. Consulte OpenSharing.
Nesta página