Configurar e gerenciar um espaço Genie de IA/BI

Este artigo explica como configurar e gerenciar um espaço Genie, uma interface de bate-papo para usuários corporativos fazerem perguntas em linguagem natural sobre seus dados.

Requisitos técnicos e limites

Os seguintes requisitos e limites se aplicam ao usar espaços Genie:

• Catálogo Unity: Os dados para o espaço Genie devem ser registrados no Catálogo Unity.
• Compute: Você deve usar um SQL warehouse profissional ou sem servidor.
• Taxa de transferência: Cada espaço de trabalho pode lidar com até 20 perguntas por minuto em todos os espaços do Genie.

Permissões necessárias

As seguintes permissões são necessárias para criar, editar e usar espaços Genie:

• Permissões de computação: criadores, editores e usuários do espaço Genie exigem acesso CAN USE ao armazém SQL padrão designado para o espaço. Os criadores selecionam o SQL warehouse padrão quando criam um espaço. Eles podem escolher qualquer armazém SQL para o qual tenham permissões CAN RUN.
• Permissões de acesso a dados: Qualquer usuário que interaja com o espaço precisa de pelo menos SELECT privilégios sobre os dados usados em um espaço.
• permissões de espaço do Genie: Os usuários precisam de permissões CAN RUN no espaço do Genie para interagir com o Genie e os dados usados no espaço. Consulte ACLs do espaço Genie para obter um mapeamento completo de privilégios e habilidades para um espaço Genie.

Observação

A configuração de dados e acesso à computação requer permissões elevadas, geralmente restritas a um administrador. Consulte Criar um armazém SQL e Gerir privilégios no Unity Catalog.

Gerencie o acesso ao Genie

O Genie usa recursos de assistência de IA baseados em serviços de IA do Azure que devem ser habilitados no nível da conta. Para saber como gerir essas funcionalidades para a sua conta, consulte Use o Databricks Assistant.

Observação

Você deve ser um administrador de conta para gerenciar o acesso a esse recurso. Se você desabilitar os recursos baseados em IA do Azure, os usuários com o direito SQL ainda poderão clicar no ícone Genie na barra lateral, mas não poderão acessar nenhum espaço do Genie.

Crie um novo espaço Genie

Os espaços Genie permitem que os analistas de dados criem uma experiência espacial Genie específica do domínio para usuários corporativos seguindo as seguintes etapas:

1. Clique em Genie na barra lateral.

2. Clique Novo no canto superior direito do ecrã.

   

3. Na caixa de diálogo Nova, escolha suas configurações iniciais. As opções são descritas da seguinte forma:

• Título: O título aparece no explorador do espaço de trabalho juntamente com outros objetos do espaço de trabalho. Escolha um título que ajude os utilizadores finais a descobrir o seu espaço Genie.
• Descrição: Os usuários veem a descrição quando abrem o espaço Genie. Use esta área de texto para descrever a finalidade dos espaços. O campo de descrição suporta formatação Markdown para que você possa estilizar seu texto e fornecer links para contexto e referências úteis. Para obter mais informações sobre a sintaxe do markdown, consulte este guia.
• Default warehouse: Este recurso de computação alimenta as instruções SQL geradas nos espaços Genie. Os usuários finais precisam ter acesso a esse armazém para interagir com o espaço. Um espaço Genie pode usar um armazém de dados SQL profissional ou sem servidor. Para um desempenho ideal, o Databricks recomenda o uso de um SQL warehouse sem servidor.
• Tabelas: Os espaços Genie podem ser baseados em uma ou mais tabelas. O botão Adicionar tabelas abre uma nova caixa de diálogo onde você pode selecionar as tabelas do Catálogo Unity que deseja incluir.
• Exemplos de perguntas: As perguntas de exemplo são opcionais. Eles aparecem em chats para fornecer exemplos dos tipos de perguntas que os usuários podem fazer. Eles podem ser adicionados durante a criação ou mais tarde a partir das Configuraçõesdo espaço.

Fornecer instruções

As instruções ajudam a orientar as respostas do Genie para que ele possa processar o jargão, a lógica e os conceitos exclusivos em um determinado domínio. Instruções abrangentes são essenciais para uma experiência espacial Genie perfeita e intuitiva. Para inserir instruções, clique no na barra lateral do espaço Genie para abrir o painel de instruções. Use este painel para adicionar Instruções gerais, Exemplo de consultas SQLe SQL Functions.

Você pode adicionar até 100 instruções no total para um espaço Genie. Contribuem para a contagem os seguintes elementos:

• Todo o bloco de texto em Instruções Gerais conta como um.
• Cada exemplo de consulta SQL conta como um.
• Cada função SQL conta como uma.

Instruções gerais

Forneça instruções de texto simples que transmitam as suas preferências empresariais ou de resposta para o Genie seguir. Você pode formatar as instruções como uma única nota abrangente ou categorizá-las por tópico para uma melhor organização.

Segue-se um exemplo de informações que pode incluir nas instruções gerais:

• Informações comerciais específicas da empresa:
  • "Nosso ano fiscal começa em fevereiro"
• Valores, aliases ou filtros comuns:
  • "Sempre converta para minúsculas e use um operador semelhante ao aplicar filtros."
  • "Use abreviaturas para estados em valores de filtro."
• Especificar funções para responder a perguntas e fornecer instruções para valores de retorno:
  • "Para trimestres use o adventureworks.oneb.get_quarter(date) UDF. A produção de get_quarter() é o trimestre e é 1,2,3 ou 4. Use isso para filtrar os dados conforme necessário.

Exemplo de consultas SQL

Exemplos de consultas SQL são consultas SQL que você prepara para ajudar a treinar o Genie. O Genie seleciona de forma inteligente consultas relevantes para ajudar a gerar a resposta ao responder a perguntas. Ao adicionar consultas de exemplo, você mostra ao Genie como usar seus dados para responder a perguntas. Você também pode adicionar perguntas de exemplo para ensinar o Genie sobre os tipos de perguntas que você esperaria que a consulta de exemplo respondesse. Se o Genie receber uma pergunta correspondente, ele poderá usar a consulta de exemplo diretamente para fornecer uma resposta. Se ele receber uma pergunta semelhante, ele pode usar pistas da consulta de exemplo para ajudar a estruturar o SQL fornecido na resposta. Concentre-se em fornecer exemplos que destaquem a lógica exclusiva da sua organização e dos dados, como no exemplo a seguir:

  -- Return our current total open pipeline by region.
  -- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = 'Pipeline' AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Adicionar parâmetros em consultas SQL

Os parâmetros permitem escrever consultas de exemplo com espaços reservados para valores específicos a serem substituídos em tempo de execução. Com parâmetros, o Genie pode receber entradas específicas de perguntas do usuário e reutilizar a estrutura de uma consulta de exemplo para fornecer respostas verificadas como ativos confiáveis. Por exemplo, você pode ajustar a consulta SQL anterior para incluir um parâmetro que filtra pelo valor o.forecastcategory, permitindo que a consulta responda a perguntas sobre oportunidades marcadas em diferentes categorias de previsão. Para obter mais informações sobre como usar consultas parametrizadas para gerar respostas rotuladas como ativos confiáveis, consulte Usar ativos confiáveis em espaços do AI/BI Genie.

O trecho de código a seguir mostra o exemplo anterior, modificado adicionando um parâmetro para o valor o.forecastcategory. Os parâmetros usam a mesma sintaxe que os marcadores de parâmetros nomeados. Consulte Marcadores de parâmetros nomeados.

-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = :forecast_category AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

Para adicionar um parâmetro a uma consulta:

1. Coloque o cursor onde pretende colocar o parâmetro na consulta.

2. Clique em Adicionar parâmetro para inserir um novo parâmetro.

   Isso cria um novo parâmetro com o nome padrão parameter. Para alterar o nome padrão, substitua-o no editor de consultas. Você também pode adicionar parâmetros digitando dois pontos seguidos por um nome de parâmetro (:parameter_name) no editor.

Editar um parâmetro de consulta

Para editar um parâmetro, faça o seguinte:

1. Clique no ícone de engrenagemGear icon ao lado do nome do parâmetro. Uma caixa de diálogo Parameter details é exibida e inclui as seguintes opções de configuração:

   • Keyword: A palavra-chave que representa o parâmetro na consulta. A palavra-chave só pode ser alterada atualizando diretamente o texto na consulta.

   • Nome de exibição: O nome legível por humanos que o Genie usa na experiência de bate-papo. Quando o Genie gera uma resposta usando uma consulta parametrizada, ele inclui o nome para exibição e o valor associado na resposta.

   • Tipo: Os tipos suportados incluem String, Data, Data e Horae Numérica.

     • O tipo padrão é String.
     • O tipo de dados numérico permite especificar entre decimal e inteiro. O tipo numérico padrão é Decimal.

     Observação

     Se o valor de entrada real não corresponder ao tipo de parâmetro selecionado, o Genie tratará o valor de entrada como o tipo incorreto, o que pode levar a resultados imprecisos.

2. Clique em outra parte da interface do usuário para fechar a caixa de diálogo.

Funções SQL

As funções SQL são funções personalizadas que são armazenadas no Unity Catalog e usadas pelo Genie para responder a perguntas específicas. O Genie pode chamar essas funções e inserir quaisquer parâmetros especificados pelo usuário, mas não pode acessar o conteúdo SQL subjacente. Isso significa que as funções SQL são ideais para responder a perguntas específicas comuns que incluem argumentos complexos ou cálculos que o Genie não deve ser capaz de acessar ou editar. Para obter orientação sobre como registrar uma função no Unity Catalog, consulte Criar uma função de tabela SQL e Funções definidas pelo usuário (UDFs) no Unity Catalog.

Teste o seu espaço Genie

A maioria das interações do usuário ocorre na janela de chat. A melhor maneira de saber se o seu espaço está funcionando como você deseja é testá-lo com perguntas realistas que você espera que os usuários corporativos façam.

Todas as perguntas de exemplo inseridas nas configurações aparecem na janela de bate-papo. Essas perguntas de exemplo ajudam os usuários a entender quais perguntas eles podem fazer ao seu espaço Genie. O campo de texto, onde os usuários inserem perguntas, fica na parte inferior da tela.

As respostas aparecem acima do campo de texto. Depois que um usuário insere uma pergunta, ela é salva em um thread do histórico de bate-papo no painel esquerdo.

Para iniciar uma nova conversa:

1. Clique no ícone ícone de chat para abrir a janela de chat.
2. Digite a sua pergunta no campo de texto Faça a sua pergunta.... Para iniciar um novo tópico de conversação, clique em Novo chat.

Rever respostas

As respostas são normalmente entregues como uma resposta em linguagem natural às perguntas e uma tabela que mostra o conjunto de resultados relevante. A estrutura precisa da resposta varia de acordo com a pergunta. Todas as respostas incluem a consulta SQL que foi gerada para responder à pergunta. Clique Mostrar código gerado para visualizar a consulta gerada.

O lado inferior direito da resposta inclui ações opcionais. Você pode copiar o CSV de resposta para sua área de transferência, baixá-lo como um arquivo CSV, adicioná-lo como uma instrução para o espaço Genie e votar para cima ou para baixo na resposta.

Um conjunto de Ações rápidas blocos seguem respostas que incluem dados tabulares. Você pode usá-los para gerar visualizações.

Você também pode gerar uma visualização descrevendo-a em palavras depois de obter um resultado de consulta. Consulte Gerar visualizações.

Formatar resultados

Para formatar uma coluna numa tabela dentro de uma resposta, clique no menu kebab no cabeçalho da coluna e, em seguida, clique em Formatar para visualizar as opções disponíveis. As opções de formatação dependem do tipo de dados da coluna.

Faça o download do conjunto de resultados

Os utilizadores do espaço podem descarregar até aproximadamente 1GB de dados de resultados em formato CSV. O tamanho final do download do arquivo pode ser um pouco maior ou menor que 1GB, pois o limite de 1GB é aplicado a uma etapa anterior ao download do arquivo final. Para baixar resultados, clique no ícone de download na resposta.

Gerar visualizações

Os usuários podem solicitar explicitamente uma visualização usando a janela de bate-papo ou usando uma das visualizações sugeridas fornecidas na seção Ações rápidas que segue uma resposta. Às vezes, o Genie oferece uma visualização como parte de uma resposta. Você pode editar visualizações na janela de chat.

Os seguintes tipos de gráficos são suportados:

• Área
• Bar
• Linha
• Torta
• Dispersão

Para editar uma visualização:

• No canto superior direito da visualização, clique no ícone ícone de edição. Um painel de edição é aberto no lado direito da página.
• Use o menu de seleção Visualização para escolher um tipo de gráfico diferente.
• Para a maioria dos tipos de gráficos, use os menus suspensos eixo X e eixo Y para escolher os valores representados em cada eixo. Para gráficos de pizza, use o menu suspenso Ângulo de para escolher a coluna que deseja representar.
• (Opcional) Para personalizar o esquema de cores, clique no + na categoria de Cores .
• (Opcional) Para selecionar os dados a serem exibidos na dica ao passar o rato sobre a visualização, clique no + na secção Tooltip.

Fornecer feedback de resposta

Cada resposta do AI/BI Genie inclui um botão de feedback de polegar para cima ou para baixo. A Databricks recomenda incentivar os usuários a fornecer feedback sobre o espaço usando esse mecanismo.

Para obter uma resposta que inclua os resultados da consulta, os usuários podem solicitar que ela seja revisada por um editor de espaço do Genie clicando no ícone . Se um usuário tiver dúvidas sobre a qualidade ou precisão de uma resposta gerada, ele pode marcá-la para revisão e, opcionalmente, adicionar seu comentário ou pergunta.

Os utilizadores de negócios podem ver as atualizações das perguntas que marcaram para revisão na sua página Histórico. Os usuários com pelo menos permissão CAN MANAGE no espaço Genie podem revisar a troca específica, comentar a solicitação e confirmar ou corrigir a resposta. Eles podem acessar comentários e revisar solicitações na página de monitoramento. De seguida, poderá usar esse feedback para aprimorar as respostas e aperfeiçoar o seu espaço. Consulte Histórico de avaliações e comentários.

Histórico e feedback da revisão

Um espaço Genie destina-se a ser uma ferramenta de colaboração contínua para equipes de dados e usuários de negócios acumularem conhecimento, não uma implantação única. Compreender as novas perguntas para as quais os usuários corporativos precisam de respostas é essencial para a construção de conhecimento. Na página do histórico, pode visualizar perguntas e respostas individuais, gostos ou desgostos fornecidos pelos utilizadores e perguntas marcadas para revisão. Para abrir a página de histórico, clique no ícone Histórico na barra lateral do espaço do Genie.

A página de histórico mostra todas as perguntas e respostas que foram feitas no espaço. Você pode filtrar perguntas por tempo, classificação, usuário ou status. Ao monitorar o espaço, os editores do espaço Genie podem entender proativamente as consultas levantadas pelos usuários corporativos e como o espaço Genie respondeu.

Ao identificar as perguntas com as quais o Genie luta, você pode atualizar o espaço do Genie com instruções específicas para melhorar suas respostas. Clique numa pergunta para abrir o texto da pergunta e da resposta. Você também pode acessar o tópico de bate-papo completo a partir dessa visualização.

Editar SQL gerado

Você pode revisar e editar o SQL gerado em qualquer resposta. Os autores do espaço Genie normalmente conhecem o domínio e os dados que lhes permitem reconhecer quando o Genie está gerando uma resposta incorreta. Muitas vezes, os erros podem ser corrigidos com uma pequena quantidade de ajuste manual para a consulta SQL gerada. Para exibir o SQL gerado para qualquer resposta, clique Mostrar código gerado para inspecionar a consulta.

Você pode editar a instrução SQL gerada para corrigi-la se tiver privilégios CAN EDIT ou maiores no espaço Genie. Depois de fazer as correções, execute a consulta. Então, você pode salvá-lo como uma instrução para ensinar Genie como responder no futuro. Para guardar a sua consulta editada, clique no ícone de guardar como instrução .

Partilhe um espaço Genie

Importante

Os usuários do espaço Genie devem usar suas próprias credenciais para acessar dados. Qualquer pergunta sobre dados que eles não podem acessar gera uma resposta vazia.

Os utilizadores do espaço Genie devem ter permissões CAN USE no armazém associado a um espaço Genie e permissões de acesso nos objetos do Unity Catalog apresentados no espaço. Consulte Que dados devo utilizar?.

Os novos espaços Genie são guardados na sua pasta de utilizador por predefinição. Como outros objetos de espaço de trabalho, eles herdam permissões de sua pasta anexa. Você pode usar a estrutura de pastas do espaço de trabalho para compartilhá-las com outros usuários. Consulte Organizar objetos de espaço de trabalho em pastas.

Você também pode especificar determinados usuários ou grupos com os quais compartilhar em um determinado nível de permissão: PODE GERENCIAR, PODE EDITAR, PODE EXECUTAR e PODE VISUALIZAR.

Para partilhar com utilizadores ou grupos específicos:

1. Clique Partilhar.
2. Introduza os utilizadores ou grupos com os quais pretende partilhar o espaço. Em seguida, clique em Adicionar e defina os níveis de permissão apropriados.
3. Use o botão Copiar link na parte inferior do diálogo de Partilha para obter um link partilhável para o espaço do Genie. Os utilizadores privilegiados podem clicar no link para abrir o espaço do Genie numa nova guia e colocar questões.

Clone um espaço Genie

A clonagem de um espaço Genie cria uma cópia, incluindo todo o contexto e todas as instruções de configuração. Isso é útil se você tiver um espaço bem desenvolvido e quiser criar um novo espaço para testes adicionais ou reutilizar o contexto do espaço original. Depois que um espaço é clonado, o novo espaço é independente do original, permitindo que você faça edições e ajustes sem afetar o original.

Os seguintes elementos são copiados para um espaço Genie clonado:

• Tabelas e configurações
• Instruções gerais
• Exemplo de consultas SQL
• Funções SQL

Os tópicos de chat existentes e os dados de do Histórico de não são copiados para o novo espaço.

Para clonar um espaço Genie, faça o seguinte:

1. Abra o espaço Genie que deseja clonar.
2. Clique no menu kebab no canto superior direito do espaço.
3. Clique em clonar.
4. (Opcional) Na caixa de diálogo Clonar , especifique um novo nome e um novo local da pasta do espaço de trabalho para o espaço clonado do Genie.
5. Clique em Clone para criar o novo espaço.

Melhores práticas para a preparação do espaço

Para obter orientação sobre práticas recomendadas e ajuda com a resolução de problemas, consulte Como organizar eficazmente um espaço Genie.

Monitorizar a utilização

Você pode usar logs de auditoria para monitorar o uso do seu espaço Genie. Veja eventos do AI/BI Genie