Agentes Génio com dashboards

Os dashboards publicados incluem por defeito um Agente Genie para permitir que os utilizadores de negócio explorem dados usando linguagem natural. Um Agente Genie é uma interface sem código que fornece um botão Perguntar ao Genie em dashboards publicados, permitindo aos espectadores conversar com os dados em vez de dependerem apenas de visualizações pré-definidas. O botão Ask Genie está disponível para os utilizadores no ambiente de trabalho e quando os painéis são incorporados usando a incorporação básica. Ver Agentes Génio.

Quando publicas o teu dashboard, a opção Ativar Genie está ativada por defeito, e o Databricks gera automaticamente um Agente Genie com base nos conjuntos de dados e visualizações do teu dashboard. Alternativamente, podes ligar a um Agente Genie existente ou desligar a opção para desativar o Genie.

Os Agentes Génio Companheiros utilizam conceitos de Agentes Génio, que permitem ao Génio raciocinar através de múltiplas etapas e fontes de dados para responder a perguntas complexas.

Para mais informações sobre os Agentes Génio, consulte Agentes Génio.

Observação

Ask Genie só está disponível em integração básica. O Ask Genie não é suportado em Ask Genie não está disponível em embedding externo. Para cenários de integração externos, use a Genie Conversation API para integrar capacidades de consulta em linguagem natural.

Controla o acesso ao Agente Genie do teu dashboard

Para ativar ou configurar um Agente Genie para o seu painel publicado:

  1. Abra o seu painel.
  2. No painel direito, clique em Configurações. Ou, clique no ícone do menu Kebab. o menu > kebab Configurações para abrir as configurações.
  3. Clique em Geral.
  4. A opção Ativar Genie está ativada por padrão. Desligue a opção se quiser desativar o Genie Agent para visualizadores de dashboards.
  5. (Opcional) Para ligar um Agente Genie existente, selecione o botão de opção Ligar Agente Genie existente e cole a URL associada. Se não selecionares esta opção, o Databricks gera automaticamente um novo Agente Genie com base no teu painel de controlo quando publicas.

GIF mostrando uma janela de bate-papo do Genie aberta 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, suas perguntas são respondidas a partir dos resultados completos da consulta do conjunto de dados. Se uma consulta de conjunto de dados 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 conjuntos de dados para incluir apenas os campos e linhas que você deseja que os usuários acessem. Consulte Permissões para os agentes Genie.

Observação

Os agentes complementares do Genie não aparecem no explorador de ficheiros nem na página de listagem do Genie. Quando republica o seu painel com alterações, o Agente Genie associado atualiza-se automaticamente para refletir os novos conjuntos de dados e visualizações.

Abre o Agente Génio

Para abrir o Agente Génio publicado numa nova janela:

  1. Clique no ícone do menu Kebab no canto superior direito da janela de bate-papo
  2. Clique em Open Genie Agent.

Observação

Não podes editar as instruções dos Agentes Genie gerados automaticamente a partir da interface do Agente Genie. O Genie Agent atualiza-se quando republicas o dashboard com alterações.

Pergunte ao Genie sobre um gráfico específico

Para consultar o Genie sobre um gráfico específico do painel de controle:

  1. Clique em Ask Genie num painel publicado com suporte ao 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 chat.
  3. Faça perguntas sobre os dados representados no gráfico selecionado.

Pede ao Génio para explicar as alterações no mapa

Pode pedir ao 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 multisséries e empilhados), células de tabela dinâmica, gráficos de barras horizontais, gráficos circulares e mapas de calor. O Genie entra em modo Agente para analisar a mudança e identificar os principais condutores.

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

  1. Clique em Ask Genie num painel publicado com suporte ao Genie.
  2. Clique com o botão direito numa visualização suportada.
  3. Seleciona a opção para pedir ao Génio que explique a alteração.

O Génio analisa a alteração selecionada e devolve uma explicação com os principais fatores contributivos.

Permissões para Agentes Génio

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

Os Agentes Genie Autogerados seguem o modelo de credencial do dashboard:

  • Se o painel usar credenciais incorporadas (permissão de dados partilhados), o Agente Genie também usa credenciais incorporadas. O Genie utiliza as credenciais do editor para aceder aos dados, para que os espectadores possam interagir com o Genie mesmo que não tenham acesso direto aos dados subjacentes.
  • Se o painel usar credenciais do visualizador, o Agente Genie também usa credenciais do visualizador. Aplicam-se as próprias permissões de acesso aos dados de cada visualizador.

Os Agentes Genie ligados usam sempre as definições de credenciais configuradas no próprio Agente Genie. As definições de credenciais do painel não têm qualquer efeito sobre um Agente Génio ligado.

Em todos os casos, os espectadores devem ser membros do espaço de trabalho para interagir com os Agentes Genie. Para saber mais sobre os tipos de acesso, consulte Gerenciar painel e acesso do Genie.

Edite a descrição do Agente Genie no seu dashboard

O Databricks gera automaticamente uma descrição com base no conteúdo do seu dashboard. Pode editar a descrição a qualquer momento.

Para editar a descrição:

  1. Abre o agente génio.
  2. Clique em Configurar.
  3. Clique no ícone de lápis. O ícone de edição ao lado de Descrição.
  4. Introduza ou edite a descrição e clique em Guardar.

Expressões SQL incompatíveis

Os Agentes Genie ligados não podem usar conjuntos de dados que contenham as seguintes expressões SQL:

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

    SELECT * FROM identifier(:param)

  • Visões ou funções temporárias em conjuntos de dados com múltiplas instruções, como no exemplo seguinte.

    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 conjunto de dados, como no exemplo a seguir.

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

Observação

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

OpenSharing

Conjuntos de dados partilhados usando OpenSharing não são suportados em Agentes Genie que utilizam credenciais incorporadas (permissão de dados partilhados). O OpenSharing utiliza um sistema de credenciais que é incompatível com a delegação de credenciais do Genie. Para usar estes conjuntos de dados com o Genie, use credenciais do visualizador em vez de credenciais embutidas.

Limitações

  • A funcionalidade Ask Genie não é suportada em incorporação externa. Para cenários de embedding externo, use a API Genie Conversation. Veja Ask Genie não está disponível em incorporação externa.
  • Não podes editar as instruções dos Agentes Genie gerados automaticamente a partir da interface do Agente Genie.
  • Os agentes Genie complementares suportam até 30 conjuntos de dados do dashboard. Se o seu painel usar mais de 30 conjuntos de dados, apenas 30 estão incluídos no Agente Genie.
  • Os filtros do dashboard não se transferem para o contexto do chat quando se usa um Agente Genie ligado. Os filtros do painel funcionam como esperado com agentes Genie gerados automaticamente.
  • O Ask Genie ignora conjuntos de dados que contêm cláusulas de identificador com cadeias de caracteres não constantes, vistas temporárias ou funções, ou referências a volumes, e responde com base nos restantes conjuntos de dados suportados. Ver Expressões SQL Incompatíveis.
  • Conjuntos de dados partilhados através do OpenSharing não são suportados em Agentes Genie que utilizam credenciais embutidas. Veja OpenSharing.
  • As visualizações que o Genie One gera usam títulos em texto simples, porque não se pode editar uma visualização gerada. Num Agente Genie, o título de um widget gerado suporta texto enriquecido depois de editar e guardar o título ou a descrição. Veja Onde a formatação não é aplicada.
  • Last updated on