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

Crie e gerencie um Espaço Genie

Esta página explica como configurar e gerenciar um Genie Space, uma interface de bate-papo para usuários corporativos fazerem perguntas em linguagem natural sobre seus dados.

Requisitos e limites técnicos​

Os seguintes requisitos e limitações se aplicam ao usar o Genie Spaces:

  • Unity Catalog: Os dados do Genie Space devem ser registrados no Unity Catalog. Você pode adicionar até 30 mesas ou visualizações a um Espaço Genie .
  • Computação: Genie Spaces requer um SQL warehouse profissional ou serverless . Ao criar ou configurar um Genie Space, você deve ter pelo menos a permissão CAN USE no armazém selecionado. Suas credenciais compute estão incorporadas ao Genie Space e são usadas para processar todas as consultas de todos os usuários.
  • Taxa de transferência: Cada workspace pode processar até 20 perguntas por minuto em todos os Genie Spaces quando acessados pela interface do usuário Databricks . Ao acessar Genie Spaces usando o nível gratuito APIGenie (Prévia Pública), a Taxa de transferência é limitada a cinco perguntas por minuto por workspace, em todos Genie Spaces, na medida do possível. Esses limites default existem para evitar abusos. Para obter ajuda adicional, entre em contato com a equipe da sua account Databricks .
  • Capacidade: Cada Genie Space suporta até 10.000 conversas, e cada conversa pode incluir até 10.000 mensagens.

Permissões necessárias​

Para criar ou editar um Espaço Genie, você precisa ter as seguintes permissões e autorizações:

  • Direitos: O senhor deve ter o direito Databricks SQL workspace . Ver gerenciar direitos.
  • computar: Acesso CAN USE em pelo menos um profissional ou serverless SQL warehouse.
  • Acesso aos dados: privilégios SELECT sobre os dados usados no espaço.
  • ACLsGenie Space: pelo menos permissões CAN EDIT no Genie Space. Os criadores Genie Space têm automaticamente permissões CAN MANAGE nos espaços que criam. Consulte as ACLs do Genie Space.
nota

A configuração dos dados e o acesso a compute exigem permissões elevadas, geralmente restritas a um administrador. Consulte Criar um SQL warehouse e gerenciar privilégios em Unity Catalog.

gerenciar Genie access​

Genie usa recursos AI com tecnologia de parceiros, que devem ser habilitados nos níveis account e workspace . Para saber como gerenciar esses recursos para sua account, consulte o recurso AI com tecnologia de parceiros.

nota

Você precisa ser administrador account para gerenciar o acesso a este recurso. Se você desativar o recurso AI com tecnologia de parceiros, os usuários com a licença Databricks SQL ainda poderão clicar no ícone Genie Spaces na barra lateral, mas não poderão acessar nenhum Genie Space.

Crie um Espaço Genie​

Para criar um Espaço Genie :

  1. Clique em Genie Spaces na barra lateral.
  2. Clique em Novo no canto superior direito da tela.
  3. Escolha a fonte de dados que deseja incluir no seu Genie Space. Em seguida, clique em Criar .

A caixa de diálogo de conexão de dados com a fonte de dados selecionada.

Antes de compartilhar o espaço com os usuários, Databricks recomenda adicionar exemplos de consultas SQL , instruções e configurações do repositório de conhecimento para melhorar a precisão das respostas. Veja a qualidade do Tune Genie Space.

Revise as sugestões de consulta​

Para aprender sobre os dados do seu espaço, Genie acessa informações no seu workspace para entender melhor os relacionamentos entre tabelas e a semântica do seu negócio. Quando você adiciona dados ativos a um espaço, Genie pesquisa automaticamente por consultas populares relevantes workspace associadas a esses ativos. Suas credenciais de usuário são usadas para encontrar consultas relevantes para as quais você tem pelo menos permissões CAN VIEW. Se a pesquisa retornar consultas, uma notificação será exibida na tab Dados do painel Instruções . Clique em Revisar para ver as consultas sugeridas.

Para obter mais informações sobre permissões de acesso a consultas, consulte ACLs de consultas.

Revise a notificação de consultas sugeridas

Utilize a caixa de diálogo "Revisar consultas sugeridas" para revisar, editar, aceitar ou rejeitar as consultas sugeridas. Outros usuários com pelo menos permissão CAN EDIT no Genie Space podem revisar as consultas, desde que tenham pelo menos permissão CAN VIEW na própria consulta.

anotar revisão do diálogo de consultas sugeridas. As seções numeradas explicam como trabalhar com as consultas sugeridas.

  1. O texto do título vem pré-preenchido com uma pergunta. Revise ou edite a pergunta digitando no campo Título .
  2. O campo Code (Código ) contém o texto completo da consulta SQL sugerida. Esse campo não é editável. Para view a consulta completa, clique em ... mais linhas .
  3. Se o senhor tiver permissões suficientes para a consulta, poderá clicar em SQL query para abrir a consulta na UI da história da consulta . Veja o histórico da consulta de visualização.
  4. Depois de determinar se a consulta é relevante para seu espaço, clique em Aceitar ou Rejeitar para adicioná-la ao seu espaço ou descartar a sugestão adequadamente.
  5. Clique nas outras sugestões para expandir e revisar.

As consultas aceitas aparecem no contexto de SQL Queries do espaço. Depois de adicionadas ao espaço, as consultas sugeridas e as perguntas associadas são totalmente editáveis. Consulte Adicionar exemplos de consultas e funções SQL.

Se nenhuma consulta sugerida for retornada:

  • Talvez você não tenha acesso suficiente às consultas relevantes.
  • Talvez não haja dados relevantes. Se as consultas não tiverem sido executadas em suas tabelas incluídas, a pesquisa poderá não retornar resultados.
  • Consultas irrelevantes para o Espaço Genie não serão consideradas. Por exemplo, consultas que realizam apenas operações básicas de gravação no ativo incluído não são consideradas exemplos relevantes para Genie.
  • O Genie não sugere consultas em tabelas que não foram adicionadas ao espaço. Se você criou tabelas ou visualizações unidas especificamente para o Genie Space, mas as consultas Databricks SQL normalmente são executadas em uma tabela de origem diferente, Genie não retornará essas consultas nos resultados.

gerenciar objetos de dados​

Para gerenciar quais objetos de dados estão incluídos em um Genie Space, clique em Configurar > Dados . Clique no botão Adicionar para adicionar mais tabelas. Clique no Ícone de lixo. À direita do nome da tabela, para remover a tabela do espaço.

Para view detalhes sobre um objeto de dados, clique no nome do objeto. A view do objeto de dados mostra duas abas:

  • Visão geral : Exibe as colunas no objeto de dados, incluindo nomes de colunas, tipos de dados e descrições.
  • Dados de exemplo : Exibe dados de exemplo da tabela para ajudar você a entender o contexto e o conteúdo dos dados.
nota

O Genie pode consultar tabelas além daquelas adicionadas explicitamente a um espaço. O acesso é controlado pelas permissões Unity Catalog , e não pelo próprio Genie Space. Embora Genie utilize as tabelas e visualizações anexadas por default, os usuários podem consultar outras tabelas solicitando junções ou editando SQL diretamente. Da mesma forma, se as instruções ou os metadados fizerem referência a tabelas fora do espaço, o Genie poderá incluí-los nas consultas geradas.

Definir configurações​

Personalize seu Genie Space configurando opções adicionais. Clique em Configurar > Configurações para acessar as seguintes configurações:

  • Título : O título aparece no navegador do espaço de trabalho com outros objetos do espaço de trabalho. Escolha um título que ajude os usuários finais a descobrir seu espaço Genie.
  • Depósito padrão : Este recurso compute alimenta as instruções SQL geradas no Genie Space. Ao salvar uma seleção de armazém, suas credenciais compute são incorporadas ao Genie Space e usadas para processar todas as consultas Genie para todos os usuários. Você precisa ter pelo menos permissões CAN EDIT no espaço para alterar o armazém. Se um autor diferente alterar o repositório posteriormente, as credenciais compute dele serão incorporadas. Um Genie Space pode usar um SQL warehouse profissional ou serverless . Para um desempenho ideal, Databricks recomenda o uso de um SQL warehouse serverless .
  • Etiquetas : Use tags para organizar e categorizar os Espaços Genie para facilitar o gerenciamento. Veja Adicionar tags.
  • Miniatura : Adicione uma imagem em miniatura ao Espaço Genie. As miniaturas aparecem na página inicial de bate-papo do Genie Space e no Genie.
  • Descrição : Os usuários veem a descrição ao abrir o Genie Space. Utilize este espaço de texto para descrever a finalidade do local. O campo de descrição suporta formatação Markdown, permitindo que você estilize seu texto e forneça links para contexto e referências úteis. Para obter mais informações sobre a sintaxe do Markdown, consulte o guia de referência rápida do Markdown.
  • Perguntas frequentes : As perguntas frequentes são opcionais. Eles aparecem nos chats para fornecer exemplos dos tipos de perguntas que os usuários podem fazer. Eles podem ser adicionados durante a criação ou posteriormente nas Configurações do espaço.

Espere fazer ajustes no seu Genie Space com base em testes e uso. Para orientações sobre as melhores práticas para criar e aprimorar um espaço, consulte Como criar um espaço Genie eficaz.

Adicionar tags​

Você precisa ter pelo menos permissões CAN EDIT em um Espaço Genie para adicionar uma tag. Para adicionar uma tag controlada, você também precisa ter a permissão ATRIBUIR na tag controlada. Para obter mais informações sobre tags, consulte Aplicar tags a objetos protegíveis Unity Catalog.

info

Visualização

Esse recurso está em Public Preview.

  1. Clique em Configurar > Configurações .

  2. Clique em Geral .

  3. Em tags , adicione ou atualize uma tag:

    • Se não houver tags, clique no botão Adicionar tags .
    • Se houver tags, clique em Ícone de edição Ícone Adicionar/Editar tags .

  4. Selecione uma chave tag existente e um valor ou insira o nome de uma nova tag.

    • As tags que são governadas estão no cabeçalho da seção Governado e têm um ícone de cadeadoÍcone de cadeado..
    • chave de tag são necessárias. Se um valor tag é necessário depende da key tag .

Compartilhe um espaço Genie​

nota

Genie Spaces utiliza credenciais compute incorporadas do autor que configurou o repositório. Todas as consultas são executadas usando essas credenciais compute incorporadas. No entanto, os usuários finais do espaço têm suas próprias credenciais de dados aplicadas às consultas, portanto, eles veem apenas os dados que devem ver. Qualquer pergunta sobre dados aos quais eles não têm acesso gera uma resposta vazia.

Para restringir os dados que cada usuário pode visualizar dentro do mesmo Genie Space, aplique segurança em nível de linha às tabelas subjacentes no Unity Catalog. Os filtros de linha e as máscaras de coluna definidos no Unity Catalog são aplicados automaticamente a cada usuário, independentemente de como o Genie Space é compartilhado. Consulte Filtros de linha e máscaras de coluna.

Ao compartilhar um Espaço Genie, os usuários devem ter as seguintes permissões para interagir com o espaço:

  • Direitos: O acesso do consumidor ou Databricks SQL workspace entitlement. Ver gerenciar direitos.
  • Computação: Execução de consultas usando as credenciais compute incorporadas pelo autor que configurou o data warehouse. Os usuários finais não precisam de permissões diretas de armazenamento.
  • Acesso aos dados: Pelo menos SELECT privilégios em todos os objetos de dados Unity Catalog usados no espaço. Os usuários visualizam apenas os dados aos quais têm permissão de acesso.
  • ACLsGenie Space: No mínimo, permissões CAN VIEW/CAN RUN no Genie Space. Consulte as ACLs do Genie Space.

Por default, os novos espaços Genie são salvos na sua pasta de usuário. Assim como outros objetos workspace , eles herdam as permissões da pasta que os contém. Você pode usar a estrutura de pastas do seu workspace para compartilhá-las com outros usuários. Consulte o navegador de espaço de trabalho.

Você também pode especificar determinados usuários ou grupos (incluindo todos os usuários account ) para compartilhar em um determinado nível de permissão: CAN MANAGE, CAN EDIT, CAN RUN e CAN VIEW.

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

  1. Clique em Compartilhar .
  2. Insira os usuários ou grupos com os quais você deseja compartilhar o espaço. Em seguida, clique em Adicionar e defina os níveis de permissão apropriados. Usuários individuais e membros de pequenos grupos recebem uma notificação no site email confirmando que o espaço foi compartilhado.
  3. Use o botão "Copiar link" na parte inferior da caixa de diálogo "Compartilhar" para obter um link compartilhável para o Genie Space. Usuários com privilégios podem clicar no link para abrir o Espaço Genie em uma nova tab e fazer perguntas.

Para compartilhar com todos os usuários account :

  1. Clique em Compartilhar .
  2. Selecione Todos os usuários account .
  3. Defina o nível de permissão apropriado.

Os usuários do espaço também podem compartilhar conversas individuais. Veja Partilhar uma conversa.

Clonar um Espaço Genie​

Clonar um Genie Space cria uma cópia que inclui todo o contexto de configuração e as instruções. A clonagem é útil quando você deseja testar alterações em um espaço separado ou reutilizar o contexto original em um novo. Após um espaço ser clonado, o novo espaço torna-se independente do original. Você pode fazer edições e ajustes sem afetar o original.

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

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

As conversas existentes e os dados da tab Monitor não são copiados para o novo espaço.

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

  1. Abra o espaço Genie que deseja clonar.
  2. Clique no menu de Ícone do menu Kebab. 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 local para a pasta workspace clonado Genie Space.
  5. Clique em Clonar para criar o novo espaço.

Exportar um Genie Space como uma viewde métricas​

Você pode exportar o contexto de um Genie Space como uma view de métricas. Isso cria uma view métrica baseada nos dados e no contexto semântico configurados no espaço.

Para exportar um Genie Space como uma view de métricas, faça o seguinte:

  1. Abra o espaço do Genie que deseja exportar.
  2. Clique no menu de Ícone do menu Kebab. kebab no canto superior direito do espaço.
  3. Selecione Exportar para viewde métricas .
  4. Selecione o caminho para a nova view de métricas.
  5. Clique em Criar .

Recurso adicional​

Nesta página