Configurar e gerenciar um espaço AI/BI Genie

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 e limites técnicos

Os seguintes requisitos e limites se aplicam ao uso do site Genie spaces:

• Unity Catalog: Os dados do espaço Genie devem ser registrados em Unity Catalog. O senhor pode adicionar até 25 mesas ou visualizar em um espaço Genie.
• computar: Genie spaces requer um profissional ou serverless SQL warehouse. Você deve ter pelo menos a permissão CAN USE no depósito selecionado. Se essa permissão estiver ausente, a criação do espaço falhará.
• Taxa de transferência: Cada workspace pode lidar com até 20 perguntas por minuto em todos os Genie spaces.
• Capacidade: Cada espaço Genie pode suportar até 10.000 conversas, e cada conversa pode incluir até 10.000 mensagens.

Permissões necessárias

As seguintes permissões são necessárias para criar, editar e usar o site Genie spaces:

• Permissões de computação: os criadores, editores e usuários do espaço Genie precisam, no mínimo, de acesso CAN USE ao default SQL warehouse designado para o espaço.
• Permissões de acesso a dados: Os privilégios concedidos no Unity Catalog controlam quais usuários podem acessar objetos de dados específicos. Qualquer usuário que interaja com o espaço precisa de pelo menos privilégios SELECT nos dados usados nesse 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. Consulte ACLs do espaço Genie para obter um mapeamento completo dos privilégios e habilidades de um espaço Genie.

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 o recurso assistivo AI alimentado por parceiros que deve ser ativado no nível account. Para saber como gerenciar esses recursos para o seu account, consulte Enable and try Databricks Assistant.

nota

O senhor precisa ser um administrador do site account para gerenciar o acesso a esse recurso. Se o senhor desabilitar o recurso assistivo alimentado por parceiros AI, os usuários com o direito Databricks SQL ainda poderão clicar no ícone Genie na barra lateral, mas não poderão acessar o site Genie spaces.

Criar um espaço Genie

Para criar um espaço Genie:

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

nota

• Se o seu workspace tiver o Genie Data Sampling ativado, o senhor poderá gerenciar se os dicionários de valores serão adicionados ao contexto de um espaço Genie marcando ou desmarcando a caixa de seleção na caixa de diálogo Connect your data (Conectar seus dados ). Para obter detalhes, consulte Usar amostragem de valor para melhorar a precisão do Genie.
• Um espaço Genie pode incluir várias visualizações métricas. No entanto, se ela contiver visualizações métricas, não poderá incluir simultaneamente outros tipos de tabelas ou visualizações. Para saber mais sobre as visualizações métricas, consulte Unity Catalog métricas view.

Revise as sugestões de consulta

Quando o senhor adiciona dados ativos a um espaço, o site Genie pesquisa automaticamente as consultas workspace associadas a esses ativos. Suas credenciais de usuário são usadas para encontrar consultas relevantes para as quais o senhor tem pelo menos permissões de CAN VIEW. Consulte ACLs de consulta. Se a pesquisa retornar consultas, uma notificação será exibida em Data tab do painel Context (Contexto ). Clique em Revisar para ver as consultas sugeridas.

Use a caixa de diálogo Revisar consultas sugeridas para revisar, editar, aceitar ou rejeitar as consultas sugeridas. Outros usuários com pelo menos acesso CAN EDIT no espaço do Genie podem revisar as consultas, desde que tenham pelo menos acesso 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.
• As consultas irrelevantes para o espaço do Genie não são consideradas. Por exemplo, as 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 o senhor criou tabelas unidas ou visualizações especificamente para o espaço Genie, mas as consultas relevantes do Databricks SQL normalmente são executadas em uma tabela de origem diferente, o Genie não retorna essas consultas nos resultados.

gerenciar dados

Para gerenciar os dados incluídos em um espaço Genie, clique em Configure > Context > Data para view os dados ativos no espaço Genie. Clique no botão Adicionar para adicionar mais tabelas. Clique à direita do nome da tabela para remover uma tabela do espaço.

colunas de visualização

Para obter uma coluna detalhada view, clique no nome de uma tabela. O exemplo a seguir mostra uma amostra de uma tabela chamada account (conta ).

• Descrição: O Genie usa metadados para entender seus dados e gerar respostas precisas. A descrição da tabela default neste view mostra os metadados Unity Catalog associados ao seu ativo de dados. O senhor pode editar essa descrição para adicionar um contexto específico ao seu espaço Genie. Todas as alterações feitas aqui têm escopo para esse espaço e não substituem os metadados armazenados no Unity Catalog. Clique em Reset (Redefinir ) para restaurar a descrição do Unity Catalog.

• Colunas: os nomes e as descrições das colunas estão incluídos na lista de colunas. Cada coluna tem um rótulo com tags que mostram se ela inclui valores de exemplo ou um dicionário de valores (visualização pública). Consulte Usar amostragem de valores para melhorar a precisão do Genie e Editar metadados de coluna.

Ativar ou desativar a amostragem de valores

Se a amostragem de dados doGenie (Public Preview) estiver ativada no seu workspace, o Genie automaticamente fará a amostragem dos valores das tabelas que o senhor adicionar durante a criação do espaço. Consulte Usar amostragem de valores para aumentar a precisão do Genie. Se a amostragem de valores não estava ativada quando seu espaço foi criado, você pode habilitá-la para cada tabela em seu espaço.

Para ativar a amostragem de valores para todas as colunas:

1. Clique no menu kebab no título Colunas .
2. Clique em Ativar amostragem de valores para todas as colunas .

Para desativar a amostragem de valores para todas as colunas:

1. Clique no menu kebab no título Colunas .
2. Clique em Desativar amostragem de valores para todas as colunas .

Mostrar ou ocultar colunas

Dados desnecessários podem ser confusos para o Genie interpretar. Para removê-las do contexto do Genie, passe o mouse sobre a coluna e clique no link à direita do nome da coluna. Isso exclui a coluna do contexto espacial do Genie. Clique no ícone novamente para adicionar a coluna de volta ao seu espaço.

Editar metadados da coluna

Para editar os metadados da coluna, definir sinônimos da coluna e acessar as configurações avançadas, passe o mouse sobre a coluna e clique no ícone de edição. Na caixa de diálogo da coluna, você pode editar o seguinte:

• Descrição: Digite uma descrição da coluna para seu espaço Genie. Sua descrição tem como escopo esse espaço do Genie. Ele não substitui os metadados armazenados no Unity Catalog. Clique em Reset (Redefinir ) para restaurar a descrição do Unity Catalog.

• Sinônimos: A adição de sinônimos e palavras-chave pode melhorar a capacidade do Genie de fazer a correspondência entre o idioma usado nos prompts do usuário e a coluna apropriada. Insira uma lista de palavras separadas por vírgulas que os usuários corporativos podem usar nas solicitações quando quiserem se referir a essa coluna.

• Avançado: use configurações avançadas para controlar o acesso a valores de exemplo e criar dicionários de valores. Genie O Data Sampling (Public Preview) controla o acesso a esses recursos no nível workspace. Consulte os requisitos. Se a amostragem de valores estiver desativada para todas as colunas, as configurações avançadas não poderão ser modificadas.

  • Exemplo de valores : Habilitada por default, essa configuração permite que Genie faça uma amostragem de alguns valores da coluna para entender melhor como usá-la. Desative essa configuração para desativar a amostragem de valores de exemplo.
  • Crie um dicionário de valores : Os dicionários de valores melhoram a compreensão que o Genie tem de seus dados. Consulte Usar amostragem de valores para aumentar a precisão do Genie. Use essa configuração para controlar quais colunas têm dicionários de valores.

Adicione exemplos e instruções

O senhor pode adicionar exemplos de consultas SQL, funções do Unity Catalog e instruções de texto simples para ajudar a gerar respostas precisas. Clique em Configurar contexto >. Use o site SQL Queries tab para gerenciar consultas e funções Unity Catalog. Use o site Instructions tab para adicionar instruções em texto simples.

O senhor pode adicionar até 100 instruções no total para um espaço Genie. Os tipos de instrução contribuem para a contagem das seguintes maneiras:

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

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

Adicionar exemplos de consultas e funções SQL

Use o site SQL Queries tab para adicionar o seguinte:

• Consultas de exemplo (recomendadas): Os exemplos de consultas SQL ajudam o Genie a gerar o SQL correto para responder às perguntas dos usuários. As consultas podem ser estáticas ou parametrizadas. Para cada exemplo de consulta SQL, o senhor fornece um exemplo de pergunta e o SQL correspondente que retorna o resultado esperado. O Genie pode usar diretamente o exemplo para fazer perguntas de correspondência ou aprender com ele para responder a perguntas relacionadas. Quando uma consulta parametrizada é usada para gerar uma resposta, ela é marcada como Confiável. Os usuários com privilégios CAN EDIT no espaço podem view a consulta usada para gerar a resposta, o que pode ajudar na solução de problemas e no refinamento.

• SQL funções: Para perguntas que não podem ser respondidas com uma consulta SQL estática ou parametrizada, o senhor pode registrar uma função personalizada para 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 respondidas usando uma função SQL são marcadas como Confiáveis . Para saber mais sobre o uso das funções SQL em seu espaço Genie, consulte Use trusted ativo in AI/BI Genie spaces .

Como o Genie usa consultas de exemplo

As consultas de exemplo mostram ao Genie como usar os dados disponíveis para responder às perguntas. Insira uma pergunta de amostra no campo de texto e, em seguida, insira uma consulta SQL que responda a essa pergunta. 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 pistas da consulta de exemplo para aprender e estruturar o SQL fornecido na resposta. Concentre-se em fornecer amostras que destaquem a lógica exclusiva de sua organização e de 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

Exemplos de consultas parametrizados permitem que os usuários do espaço especifiquem um valor específico a ser inserido na consulta em tempo de execução. Para saber mais sobre como trabalhar com consultas parametrizadas, consulte Usar parâmetros em consultas SQL.

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 Configure > Context > SQL Queries para acessar a lista de exemplos de consultas.
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 em Instructions (Instruções ) tab para escrever instruções em texto simples que ajudem o 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 uma 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 espaço Genie configurando definições adicionais. Clique em Definir 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.
• armazém padrão : Esse recurso do compute alimenta as declarações do SQL geradas no Genie spaces. Os usuários finais precisam acessar esse depósito para interagir com o espaço. Um espaço Genie pode usar um profissional ou serverless SQL warehouse. Para um desempenho ideal, o site Databricks recomenda o uso de um serverless SQL warehouse.
• Descrição : Os usuários veem a descrição quando abrem o espaço do Genie. Use essa área de texto para descrever a finalidade do espaço. O campo de descrição oferece suporte à formatação Markdown para que você possa estilizar seu texto e fornecer links para contextos e referências úteis. Para obter mais informações sobre a sintaxe do Markdown, consulte o guia Markdown cheat sheet.
• Genie file upload : Se o upload de arquivos (Public Preview) estiver ativado para o seu espaço Genie, o senhor poderá selecionar Enable users upload files to conversations . Veja carregar um arquivo.
• Exemplos de perguntas : os exemplos de perguntas são opcionais. Eles aparecem nos bate-papos 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.

O espaço do Genie deve ser repetido com base em testes e uso. Para obter orientação sobre as práticas recomendadas para criar e iterar em um espaço, consulte Curadoria de um espaço Genie eficaz.

Teste seu espaço Genie

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, o senhor pode view feedback e respostas sinalizadas na interface Genie. O comportamento do seu espaço Genie não muda apenas com base 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 fornecer feedback sobre o espaço usando esse mecanismo.

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

Perguntas complementares sugeridas

O Genie usa instruções espaciais e o contexto da conversa para sugerir perguntas de acompanhamento. Essas perguntas podem ajudar os usuários a explorar os dados de diferentes ângulos ou obter novas percepções.

Outras ações de resposta

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

• baixar todas as linhas: Os usuários de espaço podem download até aproximadamente 1GB de dados de resultados como um CSV. O tamanho final do download do arquivo pode ser um pouco maior ou menor que 1 GB, pois o limite de 1 GB é aplicado a uma etapa anterior ao download final do arquivo. Para fazer o download dos resultados, clique no ícone de download na resposta.
• 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.
• 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 kebab: Os usuários podem copiar a resposta CSV para a área de transferência ou refresh os dados executando a consulta gerada anteriormente.

Para editar uma visualização, clique no ícone de edição no canto superior direito da visualização. Você também pode gerar uma visualização descrevendo-a em palavras depois de obter o resultado da consulta. Consulte Gerar visualizações.

Formatar resultados

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

Edite e salve consultas

As consultas SQL do Genie podem ser revisadas quanto à precisão e editadas conforme necessário. 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 um pequeno ajuste manual na consulta SQL gerada. Clique em Show generated code (Mostrar código gerado) para inspecionar a consulta e view o SQL gerado para qualquer resposta.

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

Gere visualizações

Você pode solicitar que uma visualização específica seja incluída em uma resposta. Para muitas perguntas, o Genie gera automaticamente uma visualização junto com o conjunto de resultados. Para ocultar uma visualização gerada automaticamente, clique no ícone de colapso. Para mostrá-la novamente, clique em Mostrar visualização .

Você pode editar visualizações na janela de bate-papo.

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

• Área
• Barras
• Linha
• Pizza
• Mapa de pontos
• Dispersão

Para editar uma visualização:

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

Monitore o espaço

Um espaço Genie pode ser considerado como uma ferramenta de colaboração de longo prazo entre as equipes de dados e os usuários corporativos. Ele acumula conhecimento ao longo do tempo, em vez de servir como uma implantação única. À medida que os usuários fazem novas perguntas, você pode refinar o espaço para melhorar a cobertura 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.

O monitoramento tab 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 editores do espaço Genie podem entender proativamente as consultas levantadas pelos usuários corporativos e como o espaço Genie respondeu.

Identificar as perguntas com as quais o Genie tem dificuldade pode ajudar o senhor a 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 e em view o tópico completo do bate-papo.

Compartilhe um espaço Genie

important

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

Os usuários do espaço Genie devem ter permissões CAN USE no armazém anexado a um espaço Genie e permissões de acesso aos objetos do Unity Catalog exibidos no espaço. Consulte Quais dados devo usar?.

Os novos Genie spaces são salvos na sua pasta de usuário por default. Como outros objetos workspace, eles herdam as permissões da pasta que os contém. O senhor pode usar a estrutura de pastas do site workspace para compartilhá-las com outros usuários. Consulte Organizar objetos do site workspace em pastas.

O senhor também pode especificar determinados usuários ou grupos com os quais compartilhar em um determinado nível de permissão: CAN MANAGE (Pode gerenciar), CAN EDIT (Pode editar), CAN RUN (Pode executar) e CAN VIEW (Pode visualizar).

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 espaço do Genie. Os usuários privilegiados podem clicar no link para abrir o espaço Genie em um novo tab e fazer perguntas.

Clonar um espaço Genie

A clonagem de um espaço Genie cria uma cópia que inclui todo o contexto e as instruções de configuração. A clonagem é útil quando você deseja testar as alterações em um espaço separado ou reutilizar o contexto original em um novo. Depois que um espaço é clonado, o novo espaço é independente do original. Você pode fazer 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 bate-papo existentes e os dados de monitoramento não são copiados para o novo espaço.

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

1. Abra o espaço do Genie que o senhor 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 o local da pasta workspace para o espaço Genie clonado.
5. Clique em Clonar para criar o novo espaço.

Melhores práticas para preparação de espaço

Para obter orientação sobre as práticas recomendadas e ajuda para solucionar problemas, consulte Organizar um espaço Genie eficaz.

Monitore o uso

O senhor pode usar os logs de auditoria para monitorar o uso do espaço do Genie. Veja os eventos do AI/BI Genie.

Use a API de conversação do Genie

info

Visualização

Esse recurso está em Public Preview.

A API Genie Conversation expõe um endpoint para um espaço Genie existente, onde o senhor pode fazer perguntas, recuperar SQL gerado e resultados de consultas ou obter os detalhes associados a um espaço Genie. As taxas de transferência para o Conversations API são de melhor esforço e dependem da capacidade do sistema. Em condições normais ou de baixo tráfego, as solicitações são limitadas a 5 consultas por minuto por workspace. Durante os períodos de pico de uso, a Taxa de transferência real pode ser menor, pois as solicitações são processadas com base na capacidade disponível. Para começar a trabalhar com a API do Genie Conversation, consulte Use a API do Genie Conversation para integrar o Genie aos seus aplicativos.

Crie um sistema multiagente

Para saber como criar um sistema multiagentes usando o Mosaic AI Agent Framework, consulte Usar o Genie em sistemas multiagentes.