Trabalhar com um espaço de IA/BI do Genie

Visão geral

Especialistas na área, como analistas de dados, configuram espaços do Genie com conjuntos de dados, consultas de exemplo e diretrizes de texto para ajudar o Genie a traduzir perguntas de negócios em consultas analíticas. Após a configuração, os usuários empresariais podem fazer perguntas e gerar visualizações para entender os dados operacionais. Você pode atualizar continuamente o conhecimento semântico do Genie conforme seus dados mudam e os usuários fazem novas perguntas. Para obter informações adicionais sobre o DatabricksIQ, consulte Recursos habiilitados pelo DatabricksIQ.

O AI/BI Genie seleciona nomes e descrições relevantes de tabelas e colunas anotadas para converter perguntas de linguagem natural em uma consulta SQL equivalente. Em seguida, ele responde com a consulta gerada e a tabela de resultados, se possível. Se o Genie não puder gerar uma resposta, ele poderá fazer perguntas de acompanhamento para esclarecer enquanto tenta fornecer uma resposta.

Casos de uso de exemplo

Você pode criar diferentes espaços do Genie para atender a vários públicos não técnicos. Os cenários a seguir descrevem dois possíveis casos de uso.

Exemplo 1: visualizar status de oportunidade

Um gerente de vendas deseja obter o status atual de oportunidades abertas e fechadas por etapa em seu pipeline de vendas. Eles podem interagir com o espaço do Genie usando a linguagem natural e gerar automaticamente uma visualização.

O gif a seguir mostra essa interação:

Exemplo 2: logística de rastreamento

Uma empresa de logística deseja usar espaços Genie para ajudar usuários empresariais de diferentes departamentos a acompanhar detalhes operacionais e financeiros. Eles criaram um espaço Genie para seus gerentes de instalações de remessa para acompanhar os embarques e outro para seus executivos financeiros entenderem sua saúde financeira.

Requisitos técnicos e limites

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

• Catálogo do Unity: os dados do espaço do Genie devem ser registrados no Catálogo do Unity
• Computação: você deve usar um SQL warehouse profissional ou sem servidor.
• Capacidade do espaço de trabalho: cada espaço de trabalho pode ter até 1.000 espaços Genie.

Permissões necessárias

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

• Permissões de computação: criadores, editores e usuários do espaço Genie exigem o acesso CAN USE ao SQL Warehouse padrão designado para o espaço. Os criadores selecionam o SQL warehouse padrão quando criam um espaço. Eles podem selecionar qualquer SQL warehouse para o qual têm permissões CAN RUN.
• Permissões de acesso a dados: qualquer usuário que interage com o espaço precisa de pelo menos privilégios SELECT nos 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. Confira ACLs de espaço do Genie para obter um mapeamento completo de privilégios e habilidades para um espaço do Genie.

Habilite espaços Genie em sua conta

O Genie usa recursos com tecnologia de IA do Azure que devem ser habilitados no nível da conta.

Um administrador de conta pode habilitar esses recursos usando as seguintes etapas:

1. Na barra lateral do console da conta, clique em Configurações.
   1. Clique na guia Habilitação de recursos.
   2. Ative a opção Habilitar recursos com tecnologia de serviços de IA do Azure.

Os recursos baseados em serviços de IA do Azure devem ser habilitados no nível da conta antes que o Genie possa ser habilitado para um workspace.

Habilite o Genie em seu ritmo de trabalho

O Genie é gerenciado na página Visualizações do espaço de trabalho, onde é ativado por padrão. Depois que os recursos de IA com tecnologia de IA do Azure são habilitados para a conta, o Genie se torna acessível aos usuários com o direito SQL.

Os administradores do workspace podem controlar o acesso do Genie no nível do workspace. Consulte Gerenciar Versões Prévias do Azure Databricks.

Criar um novo espaço Genie

Quando os espaços Genie estiverem habilitados em um espaço e trabalho, os analistas de dados podem criar uma experiência de espaço do Genie específica de domínio para usuários empresariais seguindo estas etapas:

1. Clique em Genie na barra lateral.

2. Clique em Novo no canto superior direito da tela.

   

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

• Título: O título aparece no navegador do workspace com outros objetos de workspace. Escolha um título que ajudará os usuários finais a descobrir o espaço Genie.
• Descrição: os usuários veem a descrição quando abrem o espaço Genie. Use essa área de texto para descrever a finalidade dos espaços. O campo de descrição dá suporte à 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 markdown, consulte este guia.
• Warehouse padrão: esse recurso de computação alimenta as instruções SQL geradas nos espaços Genie. Os usuários finais precisam de acesso a esse warehouse para interagir com o espaço. Um espaço Genie pode usar um SQL warehouse profissional ou sem servidor. Para um desempenho ideal, o Databricks recomenda usar 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 na qual você pode selecionar as tabelas do Catálogo do Unity que deseja incluir.
• Perguntas de exemplo: perguntas de exemplo são opcionais. Eles aparecem em chats para fornecer exemplos dos tipos de perguntas que os usuários podem fazer. Elas podem ser adicionadas durante a criação ou posteriormente nas Configurações do espaço.

Quais dados devo usar?

Você pode criar novos espaços do Genie com base em uma ou mais tabelas registradas no Catálogo do Unity, incluindo tabelas gerenciadas, tabelas externas, tabelas externas e exibições materializadas. O AI/BI Genie usa os metadados anexados aos objetos do Catálogo do Unity para gerar respostas. Conjuntos de dados bem anotados, emparelhados com instruções específicas que você fornece, são fundamentais para criar uma experiência positiva para os usuários finais.

O Databricks recomenda o seguinte:

• Coletar dados para consumo analítico: exibições de camada para reduzir o número de colunas e adicionar informações específicas do caso de uso para aumentar a qualidade da resposta.
• Minimizar o número de tabelas e colunas em um espaço do Genie: traga apenas as tabelas e colunas necessárias para responder perguntas de um determinado domínio. Tabelas ou colunas desnecessárias podem fazer com que o Genie forneça respostas confusas ou incorretas ou exiba uma mensagem de erro.

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 específicos de uma determinada área. Instruções abrangentes são essenciais para uma experiência de espaço perfeita e intuitiva Genie. Para inserir instruções, clique em Instruções na barra lateral do espaço do Genie para abrir o painel de instruções. Use esse painel para adicionar instruções gerais, exemplos de consultas SQL e funções SQL.

Instruções gerais

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

Veja a seguir um exemplo de informações que você 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 em letras minúsculas e use um operador semelhante ao aplicar filtros."
  • "Use abreviações para estados em valores de filtro."
• Especifique funções para responder a perguntas e fornecer instruções para valores retornados:
  • "Para trimestres, use a UDF adventureworks.oneb.get_quarter(date). A saída de get_quarter() é o trimestre e é de 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. Ao responder a perguntas, o Genie seleciona de forma inteligente as consultas relevantes para ajudar a gerar a resposta. Ao adicionar consultas de exemplo, você mostra ao Genie como usar os dados para responder a perguntas. É possível adicionar perguntas de exemplo para ensinar ao Genie sobre os tipos de perguntas que a consulta de exemplo deverá responder. Se o Genie receber uma pergunta correspondente, ele poderá usar a consulta de exemplo diretamente para fornecer uma resposta. Se receber uma pergunta semelhante, ele poderá usar pistas da consulta de exemplo para ajudar a estruturar o SQL fornecido na resposta. Concentre-se em fornecer exemplos que realçam a lógica que é exclusiva para sua organização e 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 que você escreva consultas de exemplo que incluem 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 Genie AI/BI.

O snippet de código a seguir mostra o exemplo anterior, modificado pela adição de um parâmetro para o valor o.forecastcategory. Os parâmetros usam a mesma sintaxe que os marcadores de parâmetro nomeados. Confira 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 você deseja colocar o parâmetro em sua 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 em ao lado do nome do parâmetro. Uma caixa de diálogo Detalhes do parâmetro é exibida e inclui as seguintes opções de configuração:

   • Palavra-chave: a palavra-chave que representa o parâmetro na consulta. Isso só pode ser alterado atualizando diretamente o texto na consulta.

   • Nome de exibição: o nome legível que o Genie usa na experiência de chat. Quando o Genie usa uma consulta parametrizada para gerar uma resposta, ele inclui o nome de exibição e o valor associado na resposta.

   • Tipo: os tipos com suporte incluem Cadeia de caracteres, Data, Data e Hora e Numérico.

     • O tipo padrão é Cadeia de caracteres.
     • O tipo de dados Numérico permite que você especifique 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 do SQL

As funções SQL são funções personalizadas armazenadas no Catálogo do Unity. Elas são usadas pelo Genie para responder a perguntas específicas. O Genie pode chamar essas funções e inserir 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 comuns específicas que incluem argumentos ou cálculos complexos que o Genie não pode acessar ou editar. Para obter diretrizes sobre como registrar uma função no Catálogo do Unity, confira Criar uma função de tabela SQL e UDFs (funções definidas pelo usuário) no Catálogo do Unity.

Ativos confiáveis

Quando o texto exato de uma consulta de exemplo parametrizada ou função SQL é usado para gerar uma resposta, o Genie marca a resposta como um ativo confiável. Os ativos confiáveis destinam-se a transmitir uma camada extra de garantia na precisão de um resultado para um usuário do espaço. Consulte Usar ativos confiáveis em espaços Genie de IA/BI.

Chat no espaço Genie

A maioria das interações de espaço do Genie ocorre em uma janela de chat.

Uma nova janela de chat inclui um conjunto selecionado de perguntas de exemplo. Essas perguntas de exemplo ajudam os usuários a entender quais perguntas podem fazer ao espaço do Genie. O campo de texto, em que os usuários insere perguntas, fica próximo à 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 de histórico de chat no painel esquerdo.

Histórico de chat

Os threads de histórico de chat são salvos para cada usuário para que eles possam se referir a perguntas e respostas anteriores. Os usuários também podem reenviar ou revisar perguntas de um thread de chat. O botão Novo chat no painel esquerdo inicia um novo thread.

Cada tópico de chat mantém o contexto sobre perguntas anteriores que foram feitas. Isso permite que os usuários façam perguntas de acompanhamento para explorar ou concentrar novamente um conjunto de resultados.

Os tópicos do histórico de bate-papo são armazenados indefinidamente e permanecem acessíveis até que o tópico ou o espaço do Genie seja excluído. Os usuários com permissão CAN MANAGE ou superior podem visualizar todos os bate-papos dentro do espaço.

Estrutura de resposta

A estrutura de resposta precisa varia de acordo com a pergunta. Muitas vezes, as respostas incluem uma explicação de linguagem natural e uma tabela mostrando o conjunto de resultados pertinente. Todas as respostas incluem a consulta SQL gerada para responder à pergunta. Clique em Mostrar código gerado para exibir a consulta gerada.

Um conjunto de botões abaixo da resposta permite que você execute várias ações. Você pode votar a favor ou contra para indicar a qualidade da resposta ou solicitar uma revisão por usuários com permissão CAN EDIT ou superior no espaço Genie. Opções adicionais incluem adicionar a resposta como uma instrução, regenerar a resposta ou exibir o código SQL usado para gerar o conjunto de resultados na resposta.

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

Você também pode gerar uma visualização descrevendo-a em palavras após obter um resultado de consulta.

Formatar resultados

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

Baixe o conjunto de resultados

Os usuários do Space podem baixar até aproximadamente 1 GB de dados de resultados como CSV. O tamanho do download do arquivo final pode ser ou pouco maior ou menor que 1 GB, pois o limite de 1 GB é aplicado a uma etapa anterior ao download do arquivo final. Para baixar os resultados, clique no ícone de download na resposta.

Fornecer comentários de resposta

Cada resposta do AI/BI Genie inclui um botão de comentários de polegar para cima ou para baixo. O Databricks recomenda incentivar os usuários a fornecer comentários 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 . Quando o usuário tem 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 usuários empresariais podem ver as atualizações das perguntas que marcaram para revisão na página Histórico. Os usuários com pelo menos a permissão CAN MANAGE no espaço do Genie podem revisar a interação específica, comentar a solicitação e confirmar ou corrigir a resposta. Eles podem acessar comentários e solicitações de revisão na página de monitoramento. É possível usar os feedbacks para ajustar as respostas e iterar em seu espaço. Confira Histórico de revisões e feedback.

Histórico de revisões e feedback

Um espaço do Genie deve ser uma ferramenta de colaboração contínua para equipes de dados e usuários empresariais acumularem conhecimento, não uma implantação única. Entender as novas perguntas às quais os usuários empresariais precisam de respostas é essencial para a criação de conhecimento. Na página de monitoramento, você pode visualizar perguntas e respostas individuais, além de feedbacks positivos ou negativos fornecidos pelos usuários e perguntas marcadas para revisão. Para abrir a página de histórico, clique em 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 dos espaços do Genie podem entender proativamente as dúvidas levantadas pelos usuários de negócios e como o espaço do Genie respondeu.

Ao identificar as perguntas com as quais o Genie tem dificuldades, você pode atualizar o espaço do Genie com instruções específicas para melhorar suas respostas. Clique em uma pergunta para abrir o texto da pergunta e da resposta. Você também pode acessar a conversa de chat completa nessa exibição.

Editar SQL gerado

Você pode analisar 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. Frequentemente, os erros podem ser corrigidos com um pequeno ajuste manual na consulta SQL gerada. Para exibir o SQL gerado para qualquer resposta, clique em Mostrar código gerado para inspecionar a consulta.

Você pode editar a instrução SQL gerada para corrigi-la se tiver CAN EDIT ou privilégios superiores no espaço Genie. Depois de fazer suas correções, execute a consulta. Em seguida, você pode salvá-la como uma instrução para ensinar o Genie a responder no futuro. Para salvar a consulta editada, clique em Salvar como instrução.

Avalie as respostas com parâmetros de comparação

Os parâmetros de comparação permitem que você amplie o teste e a avaliação de respostas individuais em um espaço Genie. Ao contrário das instruções, os parâmetros de comparação destinam-se a avaliar, não informar, seu espaço Genie. O Genie não usa perguntas de parâmetro de comparação ou SQL de exemplo para melhorar o contexto do Genie.

Ao usar parâmetros de comparação, você pode executar uma coleção de perguntas de teste e usar as respostas para medir a precisão do Genie. Opcionalmente, você pode incluir uma instrução SQL que retorna os resultados esperados. Quando a pergunta de benchmark é executada, a resposta do Genie é comparada aos resultados fornecidos pela instrução SQL e pontuada quanto à precisão. Se nenhuma resposta do SQL tiver sido fornecida, a pergunta será marcada para revisão.

Consulte Usar parâmetros de comparação em um espaço Genie.

Compartilhar um espaço Genie

Os usuários de espaço do Genie devem ter permissões CAN USE no warehouse associado a um espaço do Genie e permissões de acesso nos objetos do Catálogo do Unity exibidos no espaço. Confira Quais dados devo usar?.

Os novos espaços Genie são salvos na pasta do usuário por padrão. Assim como outros objetos de workspace, eles herdam permissões de sua pasta delimitada. Você pode usar a estrutura de pastas do workspace para compartilhá-las com outros usuários. Consulte Organizar objetos de workspace 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 EXIBIR.

Para compartilhar com usuários ou grupos específicos:

1. Clique em Compartilhar.
2. Insira os usuários ou grupos com os quais deseja compartilhar o espaço. Em seguida, clique em Adicionar e defina os níveis de permissão adequados.
3. Utilize o botão Copiar link na parte inferior da caixa de diálogo Compartilhar para obter um link compartilhável para o espaço Genie. Usuários privilegiados podem clicar no link para abrir o espaço Genie em uma nova aba e fazer perguntas.

Clonar um espaço Genie

A clonagem de um espaço Genie cria uma cópia, incluindo todo o contexto e 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 do SQL

As conversas de chat existentes e os dados do Histórico 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 você deseja clonar.
2. Clique no menu de kebab no canto superior direito do espaço.
3. Clique em Clonar.
4. (Opcional) Na caixa de diálogo Clone , especifique um novo nome e um novo local de pasta da área de trabalho para o espaço Genie clonado.
5. Clique em Clonar para criar o novo espaço.

Privacidade e segurança

P: Qual modelo o Genie usa?

O Genie usa o modelo OpenAI do Azure.

P: Quais dados estão sendo enviados para o modelo?

Os espaços do Genie geram respostas a perguntas em linguagem natural usando metadados e instruções. O Genie não tem acesso a dados em nível de linha.

Para processar respostas, o Genie usa o seguinte:

• O prompt de linguagem natural enviado pelo usuário
• Nomes e descrições de tabelas
• Títulos e descrições de colunas
• Instruções gerais
• Exemplo de consultas SQL
• Funções do SQL

P: O Azure OpenAI coleta meus dados?

Não. A Databricks optou pelo programa de isenção de monitoramento de abuso e revisão humana, sob o qual a Microsoft não armazena nenhum prompt e conclusão enviado ao serviço Azure OpenAI. Para obter mais informações, consulte a documentação da Microsoft.

Práticas recomendadas para preparação de espaço

• Antes de construir, estabeleça um conjunto de perguntas bem definidas que você deseja que os usuários do espaço possam responder.
• Teste o espaço Genie para verificar a qualidade da resposta. Tente o seguinte para ver se o modelo fornece a resposta esperada:
  • Reformular as perguntas fornecidas.
  • Faça outras perguntas relacionadas aos conjuntos de dados.
• Adicione e refina as instruções de espaço Genie até que as perguntas forneçam a resposta esperada.

Para obter mais orientações sobre práticas recomendadas e ajuda na solução de problemas, veja Selecionar um espaço do Genie eficaz.