Configure e gerencie um Espaço Genie

Este artigo 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 .

Antes de compartilhar o espaço com os usuários, Databricks recomenda a criação de um repositório de conhecimento e a adição de exemplos de consultas SQL e instruções para melhorar a precisão das respostas. As seções abaixo descrevem cada opção de configuração.

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.

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.

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 À 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.

Crie uma loja de conhecimento

Um repositório de conhecimento é uma coleção de definições semânticas selecionadas que aprimora a compreensão dos seus dados pelo Genie e aumenta a precisão das respostas. Todas as configurações do repositório de conhecimento são específicas para o seu Genie Space e não afetam os metadados Unity Catalog nem outros ativos Databricks . Consulte Criar um repositório de conhecimento para Genie Spaces mais confiáveis para obter detalhes completos. O repositório de conhecimento inclui o seguinte:

• Personalização de metadados : adicione descrições de tabelas e colunas específicas para cada espaço e defina sinônimos que mapeiem termos comerciais para nomes de colunas. Veja as colunas de visualização.
• Correspondência de prompts : A assistência de formatação e a correspondência de entidades ajudam o Genie a associar a linguagem do usuário aos valores reais dos dados, corrigir erros ortográficos e gerar SQL mais preciso. Consulte a Visão geral da correspondência de prompts.
• Relações de junção : Defina relações entre tabelas para que Genie possa construir declarações JOIN precisas. Você pode join em uma única coluna usando a sintaxe de igualdade de coluna (por exemplo, accounts.id = opportunity.accountid), ou clicar em Usar expressão SQL para inserir condições join mais complexas, como junção de várias colunas ou junção usando expressões SQL em vez de simples igualdade de coluna. Consulte Definir relações join.
• Expressões SQL : Defina medidas, filtros e dimensões reutilizáveis que capturem a lógica de negócios, como KPIs e condições de filtragem comuns. Consulte Definir expressões SQL.

Adicionar exemplos e instruções SQL

Você pode adicionar exemplos de consultas SQL, funções do Unity Catalog e instruções em texto simples para ajudar a gerar respostas precisas. Clique em Configurar > Instruções . Use a tab ConsultasSQL para gerenciar consultas e funções Unity Catalog . Use a tab Texto para adicionar instruções em texto simples.

Cada Espaço Genie possui dois limites distintos:

• Instruções (100 por espaço) : Cada exemplo de consulta SQL, cada função SQL e todo o bloco de texto de instruções gerais contam como uma instrução.
• Trechos do repositório de conhecimento (200 por espaço) : Descrições de tabelas, relações join e expressões SQL (medidas, filtros e dimensões) compartilham esse limite. Consulte Exibir colunas, Definir relações join e Definir expressões SQL.

A Genie Space tem como objetivo fornecer respostas consistentes e previsíveis com base em orientações claras e precisas. Como Genie opera de forma não determinística, é importante que as orientações estejam livres de informações conflitantes ou ambíguas para minimizar o risco de respostas indesejáveis. Ao preparar o espaço, uma tarefa key é revisar e resolver quaisquer inconsistências. Isso ajuda a alcançar resultados confiáveis.

Adicionar exemplos de consultas e funções SQL

Use o site SQL Queries tab para adicionar o seguinte:

• Consultas de exemplo (recomendado): consultas SQL de exemplo ajudam o Genie a gerar o SQL correto para responder a perguntas comuns dos usuários. As consultas podem ser estáticas ou parametrizadas. Para cada exemplo de consulta SQL, forneça o SQL e use a formulação mais típica da pergunta do usuário como título. Isso melhora a capacidade do Genie de associar prompts ao exemplo. O Genie pode usar a consulta de exemplo diretamente ou aprender com ela para lidar com perguntas semelhantes. Quando uma consulta parametrizada é usada, a resposta é marcada como Confiável . Usuários com privilégios CAN EDIT no espaço podem view a consulta usada para gerar a resposta, o que ajuda na solução de problemas e no refinamento.

• FunçõesSQL : Para perguntas que não podem ser respondidas com uma consulta SQL estática ou parametrizada, você pode registrar uma função personalizada no Unity Catalog. As funções podem ser compartilhadas entre suas equipes e usadas pelo Genie para responder a perguntas específicas. As respostas que são obtidas usando uma função SQL são marcadas como confiáveis . Para saber mais sobre como usar funções SQL no seu Genie Space, consulte Ativo confiável.

Como o Genie usa consultas de exemplo

Consultas de exemplo mostram ao Genie como usar os dados disponíveis para responder perguntas. Insira uma pergunta de exemplo no campo de texto e, em seguida, insira uma consulta SQL que responda a essa pergunta. Escreva a pergunta de exemplo da maneira como um usuário a faria naturalmente. Quando o Genie recebe uma pergunta correspondente, ele pode usar a consulta de exemplo diretamente para fornecer uma resposta. Quando o Genie recebe uma pergunta semelhante, ele usa dicas da consulta de exemplo para aprender e estruturar o SQL fornecido na resposta. Concentre-se em fornecer amostras que destaquem a lógica exclusiva da sua organização e dos seus dados, como no exemplo a seguir:

SQL

  -- 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 de consulta

As consultas de exemplo parametrizadas permitem que os usuários do espaço especifiquem um valor que será inserido na consulta em tempo de execução. Com parâmetros, Genie pode receber entradas específicas das perguntas do usuário e reutilizar a estrutura de uma consulta de exemplo para fornecer respostas verificadas rotuladas como Confiáveis .

Para adicionar um parâmetro a uma consulta:

1. Posicione o cursor onde deseja inserir o parâmetro.

2. Clique em Adicionar parâmetro .

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

Para editar um parâmetro, clique ao lado do nome do parâmetro. A caixa de diálogo Detalhes do parâmetro inclui as seguintes opções:

• Palavra-chave : A palavra-chave que representa o parâmetro na consulta. Você só pode alterá-lo editando diretamente o texto da consulta.
• Nome de exibição : O nome legível que o Genie usa na resposta do chat. Quando o Genie gera uma resposta usando uma consulta parametrizada, ele inclui o nome de exibição e o valor.
• Tipo : Os tipos suportados incluem strings , data , data e hora e numérico . O default são strings . Para valores numéricos , você pode especificar Decimal (default) ou Inteiro .

nota

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

Quando o texto exato de uma consulta parametrizada é usado em uma resposta, a resposta é rotulada como Confiável . Veja Ativo confiável.

Ativo confiável

Os ativos confiáveis são exemplos de consultas e funções SQL que fornecem respostas verificadas para perguntas SQL você prevê que os usuários possam fazer. Quando Genie usa um ativo confiável para responder a uma pergunta, a resposta é rotulada como Confiável , dando aos usuários do espaço uma camada extra de confiança na precisão do resultado.

Ativos confiáveis incluem:

• Exemplos de consultas SQL parametrizadas : Quando o texto exato de uma consulta parametrizada é usado para gerar uma resposta, a resposta é rotulada como Confiável . Os usuários do espaço podem editar o valor do parâmetro e executar a consulta novamente. Consulte Adicionar parâmetros de consulta.
• Funções SQL : Funções SQL registradas no Unity Catalog podem ser adicionadas a um Genie Space. As respostas geradas usando uma função SQL são rotuladas como Confiáveis . Veja Como o Genie usa funções SQL?

Usuários com pelo menos permissão CAN EDIT em um Genie Space podem adicionar ou remover ativos confiáveis. Os usuários do espaço devem ter permissão EXECUTE em quaisquer funções SQL usadas como ativas confiáveis.

Forneça orientação de uso

O senhor pode fornecer ao Genie um contexto adicional para explicar quando uma consulta de exemplo é particularmente relevante.

Para adicionar orientação de uso:

1. Clique em Configurar > Instruções > Consultas SQL para acessar a lista de consultas de exemplo.
2. Clique em um exemplo de consulta.
3. Clique em Orientação de uso na parte inferior da tela.
4. Insira detalhes sobre como e quando usar esse exemplo de consulta.

Como o Genie usa as funções SQL?

As funções SQL são úteis quando uma pergunta envolve uma lógica complexa que não pode ser capturada com uma consulta estática ou parametrizada. Eles são armazenados no Unity Catalog e podem ser chamados pelo Genie usando parâmetros fornecidos pelo usuário. Genie não pode view ou modificar o SQL usado na função, o que torna essa abordagem adequada para a lógica que não deve ser apresentada ou alterada. Para obter orientação sobre o registro de 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.

Forneça instruções

Clique na tab Texto para escrever instruções em texto simples que ajudem Genie a entender como responder a perguntas específicas sobre sua empresa. Você pode formatar as instruções como uma única nota abrangente ou categorizá-las por tópico para melhor organização.

As instruções ajudam a guiar as respostas do Genie para que ele possa processar o jargão, a lógica e os conceitos exclusivos de um determinado domínio. As instruções gerais de texto se aplicam a todas as solicitações. Se uma instrução for relevante somente para um subconjunto de solicitações, ela deve ser incluída como um exemplo de consulta ou função, ou documentada na tabela relevante como comentários ou metadados. As instruções de texto são apenas para contextos que devem ser aplicados globalmente e não se encaixam em outros formatos.

O exemplo a seguir inclui informações que o senhor poderia incluir nas instruções gerais:

- **Company-specific business information**:
  - Fiscal year starts in February, for example fiscal year 26 or FY26 is February 1, 2026 through January 31, 2027
- **Formatting**:
  - Always respond in Spanish
  - If no other specification exists, round all decimals to two places
  - Omit commas in results for any column including "Id" or "id" or "\_id"

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 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.
   • chave de tag são necessárias. Se um valor tag é necessário depende da key tag .

Teste seu Genie Space

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

Exemplos de perguntas configuradas nas configurações do espaço aparecem na janela de bate-papo. O Genie também pode gerar exemplos de perguntas com base no contexto do espaço para ajudar os usuários a começar a explorar os dados. Os usuários podem clicar em um exemplo de pergunta ou inserir suas próprias perguntas no campo de texto na parte inferior da tela.

As respostas aparecem acima do campo de texto. Depois que um usuário insere uma pergunta, ela é salva no histórico do chat.

Para começar uma nova conversa:

1. Clique em New chat (Novo bate-papo ) para iniciar um novo bate-papo. Clique para abrir uma conversa anterior.
2. Digite sua pergunta no campo de entrada de texto Faça sua pergunta...

Revise as respostas

As respostas geralmente são fornecidas como respostas em linguagem natural às perguntas e uma tabela mostrando o conjunto de resultados relevante. Quando o Genie detecta que uma visualização poderia melhorar a clareza da resposta, ele também retorna uma visualização. A estrutura de resposta precisa varia de acordo com a pergunta. Se uma consulta SQL foi gerada para responder à pergunta, ela será incluída na resposta.

nota

Como outros modelos de linguagem de grande porte (LLMs), o Genie pode apresentar comportamentos não determinísticos. Isso significa que, ocasionalmente, você pode receber saídas diferentes ao enviar a mesma solicitação várias vezes. Fornecer exemplos de consultas SQL com as quais o Genie pode aprender pode ajudar a tornar o Genie mais consistente. Consulte Adicionar exemplos de consultas e funções SQL.

Feedback de resposta

Cada resposta solicita que o usuário responda Está correto ? . Os usuários podem responder de uma das seguintes formas:

• Sim: confirma que a resposta parece correta.

• Corrija: sinaliza a resposta como incorreta. Os usuários podem escolher entre problemas comuns ou inserir sua própria explicação. Eles podem então:

  • Clique em Enviar e tente novamente gerar a resposta usando o feedback fornecido.
  • Clique em Enviar para enviar o feedback sem regenerar a resposta.

• Solicitar revisão: sinaliza a resposta para análise manual. Os usuários podem adicionar um comentário opcional para fornecer contexto adicional.

Como editor, você pode view o feedback e as respostas sinalizadas na interface Genie . O comportamento do seu Genie Space não muda com base apenas no feedback do usuário. Você deve usar o feedback para identificar oportunidades de melhoria ou responder diretamente às perguntas dos usuários. A Databricks recomenda incentivar os usuários a fornecerem feedback sobre o espaço usando esse mecanismo.

Os usuários corporativos podem view as atualizações das perguntas que marcaram para revisão em sua página de monitoramento . Usuários com pelo menos a permissão CAN MANAGE no Genie Space podem revisar a troca específica, comentar na solicitação e confirmar ou corrigir a resposta. Eles podem acessar solicitações de feedback e revisão na página de monitoramento. Em seguida, você pode usar esse feedback para ajustar as respostas e iterar no seu espaço. Veja Monitorar o espaço.

Outras ações de resposta

Para respostas que incluem SQL gerado, opções adicionais permitem que o senhor interaja com os dados retornados.

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

• Mostrar código: Clique em Show code (Mostrar código) para view a consulta gerada. Isso pode ser útil para solucionar problemas de respostas não confiáveis. Consulte Editar e salvar consultas.

• O Menu de kebab: Acesse as seguintes ações:

  • Copiar CSV : Copie o CSV de resposta para sua área de transferência.
  • Adicionar como instrução: Para interações que possam ser úteis para ensinar o Genie a responder perguntas semelhantes, clique em Add as instruction (Adicionar como instrução ). Isso abre a interface do usuário para salvar exemplos de consultas SQL, preenchidas com a pergunta e o SQL gerado. Você pode deixar o exemplo como está escrito ou editar e salvar para fazer alterações. Consulte Adicionar exemplos de consultas e funções SQL.
  • Adicionar como referência : Adicione a questão como uma questão de referência. Consulte Usar benchmarks em um Genie Space.
  • atualizar dados : atualizar os dados executando a consulta gerada anteriormente.
  • Regenerar resposta : envie a pergunta novamente e peça ao Genie para regenerar a resposta.

Edite e salve consultas

As consultas SQL do Genie podem ser revisadas para verificar a precisão e editadas conforme necessário. Os autores do Genie Space geralmente 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 um pequeno ajuste manual na consulta SQL gerada. Clique em "Mostrar código gerado" para inspecionar a consulta e view o SQL gerado para qualquer resposta.

Você pode editar a instrução SQL gerada para corrigi-la se tiver privilégios CAN EDIT ou superiores no Espaço Genie . Após efetuar as 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 Adicionar como instrução .

Monitore o espaço

O Genie Space pode ser considerado uma ferramenta de colaboração de longo prazo entre equipes de dados e usuários de negócios. Acumula conhecimento ao longo do tempo, em vez de servir como uma implementação única. À medida que os usuários fazem novas perguntas, você pode refinar o espaço para melhorar a abrangência e a precisão.

Use o monitoramento tab para revisar perguntas e respostas individuais, view comentários de usuários e identificar respostas marcadas para revisão.

A tab de monitoramento mostra todas as perguntas e respostas que foram feitas no espaço. Você pode filtrar as perguntas por horário, classificação, usuário ou status. Ao monitorar o espaço, os usuários com permissões CAN MANAGE podem entender proativamente as dúvidas levantadas pelos usuários de negócios e como o Genie Space respondeu.

Identificar as perguntas com as quais o Genie tem dificuldades pode ajudar você a atualizar o Espaço Genie com instruções específicas para melhorar suas respostas. Clique em uma pergunta para abrir o texto da pergunta e da resposta e view a conversa completa.

Analise as conversas para garantir a qualidade.

Quando uma conversa é definida como "Revisável pelos administradores do espaço" , os usuários com a permissão CAN MANAGE podem abrir a conversa na tab de monitoramento para revisar toda a troca de mensagens. Isso permite avaliar a qualidade da resposta do Genie, responder ao feedback do usuário e identificar áreas onde instruções adicionais ou exemplos de consultas melhorariam a precisão. Em conversas definidas como Privadas , os administradores do espaço podem ver as mensagens dos usuários, mas não os resultados das consultas.

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

Os tópicos de bate-papo existentes e os dados de monitoramento 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 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.

Recurso adicional

• Para obter orientações sobre as melhores práticas e ajuda na resolução de problemas, consulte Criar um espaço Genie eficaz.
• Para aprender como usar logs de auditoria para rastrear a atividade e o uso em um Genie Space, consulte EventosGenie Space.
• Consulte a seção "Use a API do Genie para integrar o Genie aos seus aplicativos" para aprender como importar e exportar Espaços do Genie programaticamente e usar a API de conversação do Genie. Veja também a referência da API Genie.
• Para aprender como criar um sistema multiagente usando Mosaic AI Agent Framework, consulte Usar Genie em sistemas multiagentes (servindo modelo).