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

Este artigo explica como configurar e gerenciar um espaço do Genie, uma interface de chat para os usuários empresariais fazerem perguntas sobre seus dados em linguagem natural.

Requisitos técnicos e limites

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

• Catálogo do Unity: Os dados do espaço do Genie devem ser registrados no Catálogo do Unity. Você pode adicionar até 25 tabelas ou exibições a um espaço do Genie.
• Computação: os espaços do Genie exigem um SQL warehouse Pro ou sem servidor. Você precisa ter, no mínimo, a permissão CAN USE no warehouse selecionado. Se essa permissão estiver ausente, a criação de espaço falhará.
• Throughput: Cada workspace pode lidar com até 20 perguntas por minuto em todos os espaços do Genie quando acessados pela interface do usuário do Azure Databricks.
• Capacidade: Cada espaço do Genie pode dar suporte a até 10.000 conversas e cada conversa pode incluir até 10.000 mensagens.

Permissões necessárias

Para criar ou editar um espaço do Genie, você deve ter as seguintes permissões e direitos:

• Permissões: Você deve ter a permissão de acesso ao workspace do Databricks SQL. Consulte Gerenciar direitos.
• Computação: PODE USAR o acesso a pelo menos um SQL Warehouse profissional ou sem servidor.
• Acesso a dados:SELECT privilégios nos dados usados no espaço.
• ACLs de espaço do Genie: pelo menos as permissões de "PODE EDITAR" no espaço do Genie. Os criadores de espaço do Genie automaticamente recebem permissões CAN MANAGE nos espaços que criam. Consulte ACLs do espaço Genie.

Gerenciar o acesso do Genie

O Genie utiliza funcionalidades de IA impulsionadas por parceiros, que devem ser ativadas nos níveis de conta e espaço de trabalho. Para saber como gerenciar esses recursos para sua conta, consulte os recursos de IA habilitados para parceiros.

Criar um espaço do Genie

Para criar um espaço do Genie:

1. Clique em Genie na barra lateral.
2. Clique em Novo no canto superior direito da tela.
3. Escolha as fontes de dados que você deseja incluir no espaço do Genie. Em seguida, clique em Criar.

Examinar sugestões de consulta

Para saber mais sobre os dados do seu espaço, o Genie acessa informações em seu espaço de trabalho para compreender melhor as relações entre tabelas e sua semântica empresarial. Quando você adiciona ativos de dados a um espaço, o Genie pesquisa automaticamente consultas de workspace populares relevantes associadas a esses ativos. Suas credenciais de usuário são usadas para localizar consultas relevantes para as quais você tem pelo menos permissões CAN VIEW. Se a pesquisa retornar consultas, uma notificação será exibida na guia Dados do painel Instruções . Clique em Examinar para ver as consultas sugeridas.

Para obter mais informações sobre permissões de acesso à consulta, consulte ACLs de consulta.

Use a caixa de diálogo Revisar Consultas Sugeridas para examinar, editar, aceitar ou rejeitar as consultas sugeridas. Outros usuários com, pelo menos, acesso de edição no espaço do Genie podem revisar as consultas, desde que tenham pelo menos acesso de visualização na consulta em si.

1. O texto título é pré-preenchido com uma pergunta. Revise ou edite a pergunta digitando no campo Título .
2. O campo Código contém o texto completo da consulta SQL sugerida. Este campo não é editável. Para exibir a consulta completa, clique em ... mais linhas.
3. Se você tiver permissões suficientes na consulta, pode clicar em consulta SQL para abrir a consulta na UI de histórico de consultas. Veja Visualizar histórico de consultas.
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 ignorar a sugestão adequadamente.
5. Clique nas outras sugestões para expandir e revisar.

As consultas aceitas aparecem no contexto de Consultas SQL para o espaço. Depois que eles são adicionados ao espaço, as consultas sugeridas e as perguntas associadas são totalmente editáveis. Consulte Adicionar consultas e funções SQL de exemplo.

Se nenhuma consulta sugerida for retornada:

• Talvez você não tenha acesso suficiente a consultas relevantes.
• Pode não haver 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 do Genie não são consideradas. Por exemplo, consultas que executam apenas operações básicas de gravação nos ativos incluídos não são consideradas exemplos relevantes para o Genie.
• O Genie não sugere consultas em tabelas que não são adicionadas ao espaço. Se você criou tabelas ou exibições unidas especificamente para o espaço do Genie, mas consultas SQL relevantes do Databricks normalmente são executadas em uma tabela de origem diferente, o Genie não retorna essas consultas nos resultados.

Gerenciar objetos de dados

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

Criar um repositório de conhecimento

Um repositório de conhecimento é uma coleção de definições semânticas selecionadas que melhora a compreensão do Genie sobre seus dados e aumenta a precisão da resposta. A criação de um repositório de conhecimento permite que você faça a curadoria de um espaço personalizando metadados locais e definindo instruções concisas e estruturadas. Ele contém alterações que têm como escopo um único espaço do Genie. O criador do espaço de trabalho não precisa de privilégios de escrita nas tabelas subjacentes para editar e iterar definições, descrições ou relações de tabela. Essas entradas ajudam o Genie a interpretar os dados e retornar respostas mais precisas e relevantes. Consulte Criar um repositório de conhecimento para espaços Genie mais confiáveis.

Adicionar exemplos e instruções do SQL

Você pode adicionar consultas SQL de exemplo, funções do Catálogo do Unity e instruções de texto sem formatação para ajudar a gerar respostas precisas. Clique em Configurar>Instruções. Use a guia Consultas SQL para gerenciar consultas e funções do Catálogo do Unity. Use a guia Texto para adicionar instruções de texto sem formatação.

Você pode adicionar até 100 instruções no total para um espaço do 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 do Genie visa fornecer respostas consistentes e previsíveis com base em diretrizes claras e precisas. Como o Genie opera de maneira não determinística, é importante tornar as diretrizes livres de informações conflitantes ou ambíguas para minimizar o risco de respostas indesejáveis. Ao configurar o espaço, uma tarefa-chave é examinar e resolver quaisquer inconsistências. Isso ajuda a obter resultados confiáveis.

Adicionar funções e consultas SQL de exemplo

Use a guia Consultas SQL 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 do usuário. As consultas podem ser estáticas ou parametrizadas. Para cada exemplo de consulta SQL, forneça o SQL e use a frase mais típica da pergunta do usuário como o título. Isso melhora a capacidade do Genie de associar prompts aos exemplos. 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. Os usuários com privilégios CAN EDIT no espaço podem exibir a consulta usada para gerar a resposta, o que ajuda na solução de problemas e refinamento.

• Funções SQL: Para perguntas que não podem ser respondidas com uma consulta SQL estática ou parametrizada, você pode registrar uma função personalizada no Catálogo do Unity. As funções podem ser compartilhadas entre suas equipes e usadas pelo Genie para responder perguntas específicas. As respostas que são respondidas usando uma função SQL são marcadas como Confiáveis. Para saber mais sobre como usar funções SQL em seu espaço do Genie, consulte Usar ativos confiáveis em espaços Genie de IA/BI.

Como o Genie usa consultas de exemplo

Consultas de exemplo mostram ao Genie como usar os dados disponíveis para responder a perguntas. Insira uma pergunta de exemplo no campo de texto e insira uma consulta SQL que responda a essa pergunta. Escreva a pergunta de exemplo da maneira que um usuário faria naturalmente. Quando o Genie recebe uma pergunta correspondente, ele pode usar a consulta de exemplo diretamente para fornecer uma resposta. Quando o Genie obtém uma pergunta semelhante, ele usa pistas da consulta de exemplo para aprender e 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 de consulta

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

Fornecer diretrizes de uso

Você pode fornecer contexto adicional ao Genie para explicar quando uma consulta de exemplo é particularmente relevante.

Para adicionar diretrizes de uso:

1. Clique em Configurar>Instruções>de Consultas SQL para acessar a lista de consultas de exemplo.
2. Clique em uma consulta de exemplo.
3. Clique Diretrizes de Uso no final da tela.
4. Insira detalhes sobre como e quando usar esta consulta de exemplo.

Como o Genie usa 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 Catálogo do Unity e podem ser chamados pelo Genie usando parâmetros fornecidos pelo usuário. O Genie não pode exibir ou modificar o SQL usado na função, tornando essa abordagem adequada para a lógica que não deve ser exibida ou alterada. Para obter diretrizes sobre como registrar uma função no Catálogo do Unity, consulte Criar uma função de tabela SQL e UDFs (funções definidas pelo usuário) no Catálogo do Unity.

Fornecer instruções

Clique na guia Texto para escrever instruções de texto sem formatação que ajudam 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 melhor organização.

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

O exemplo a seguir inclui informações que podem ser incluídas 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 o espaço do Genie definindo configurações adicionais. Clique em Definir>Configurações para acessar as seguintes configurações:

• Título: O título aparece no navegador da área de trabalho com outros objetos da área de trabalho. Escolha um título que ajudará os usuários finais a descobrir o espaço Genie.
• Warehouse padrão: esse recurso de computação ativa as instruções SQL geradas nos espaços do Genie. Os usuários finais precisam de acesso a esse warehouse para interagir com o espaço. Um espaço do Genie pode usar um SQL warehouse pro ou sem servidor. Para um desempenho ideal, o Databricks recomenda usar um warehouse SQL sem servidor.
• 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 dá suporte à formatação markdown para que você possa definir o estilo do texto e fornecer links para referências e contexto úteis. Para obter mais informações sobre a sintaxe Markdown, consulte o guia rápido do Guia de Markdown.
• Upload de arquivo do Genie: se os uploads de arquivo (Visualização Pública) estiverem habilitados para o espaço do Genie, você poderá selecionar Habilitar o carregamento de arquivos por usuários nas conversas. Confira Carregar um arquivo.
• 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. Eles podem ser adicionados durante a criação ou posterior nas Configurações do espaço.
• Marcas: use marcas para organizar e categorizar espaços do Genie para facilitar o gerenciamento. Veja Adicionar tags.

Aguarde uma iteração no seu espaço do Genie com base no teste e no uso. Para obter diretrizes sobre as melhores práticas de criação e iteração em um espaço, veja Coletar um espaço eficaz do Genie.

Adicionar etiquetas

Você deve ter pelo menos a permissão CAN EDIT em um espaço do Genie para adicionar um tag. Para adicionar uma etiqueta governada, você também deve possuir a permissão ASSIGN para a etiqueta governada. Não há suporte para a pesquisa usando etiquetas de espaço do Genie. Para obter mais informações sobre marcas, consulte Aplicar marcas a objetos protegíveis do Catálogo do Unity.

1. Clique em Definir>Configurações.

2. Clique em Geral.

3. Em Marcas, adicione ou atualize uma marca:

   • Se não houver marcas, clique no botão Adicionar marcas.
   • Se houver marcas, clique no ícone Adicionar/Editar marcas.

4. Selecione uma tag existente de Key e Value ou insira o nome de uma nova tag.

   • As marcas que são governadas estão no cabeçalho da seção Governada e têm um ícone de bloqueio.
   • As chaves de marcas são obrigatórias. A necessidade de um valor de etiqueta depende da chave da etiqueta.

Teste o espaço do Genie

A maioria das interações do usuário ocorre na janela de chat. 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 empresariais façam.

Perguntas de exemplo configuradas nas configurações de espaço aparecem na janela de chat. O Genie também pode gerar perguntas de exemplo 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 uma pergunta de exemplo 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 de chat.

Para iniciar uma nova conversa:

1. Clique em Novo chat para iniciar um novo chat. Clique no Para abrir uma conversa anterior.
2. Digite sua pergunta no campo de entrada de texto Faça sua pergunta….

Examinar respostas

Normalmente, as respostas são entregues como respostas de linguagem natural para as 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.

Comentários de resposta

Cada resposta solicita que o usuário responda Se isso estiver correto?. Os usuários podem responder de uma das seguintes maneiras:

• Sim: Confirma que a resposta parece precisa.
• Corrija-o: Sinaliza a resposta como incorreta. Os usuários podem selecionar entre problemas comuns ou inserir sua própria explicação. Em seguida, eles podem:
  • Clique em Enviar e tente novamente regenerar a resposta usando os comentários fornecidos.
  • Clique em Enviar para enviar os comentários sem regenerar a resposta.
• Revisão de solicitação: Sinaliza a resposta para revisão manual. Os usuários podem adicionar um comentário opcional para fornecer contexto adicional.

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

Os usuários empresariais podem exibir atualizações para as perguntas que marcaram para revisão na página Monitoramento . Os usuários que tenham pelo menos a permissão CAN MANAGE no espaço do Genie podem examinar a troca específica, comentar a solicitação e confirmar ou corrigir a resposta. Eles podem acessar comentários e examinar solicitações na página de monitoramento. Em seguida, você pode usar esse feedback para ajustar as respostas e fazer melhorias 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 você interaja com os dados retornados.

• Copiar CSV: Os usuários de espaço podem baixar até aproximadamente 1 GB de dados de resultados como um 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.

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

• O menu kebab: Acesse as seguintes ações:

  • Copiar CSV: Copie a resposta CSV para sua área de transferência.
  • Adicione como instrução: Para interações que podem ser úteis para ensinar o Genie a responder perguntas semelhantes, clique em Adicionar como instrução. Isso abre a interface do usuário para salvar consultas SQL de exemplo, preenchidas com a pergunta e o SQL gerado. Você pode deixar o exemplo como escrito ou editar e salvar para fazer alterações. Consulte Adicionar consultas e funções SQL de exemplo.
  • Adicionar como referência: Adicionar a pergunta como uma pergunta de referência. Veja Usar parâmetros de comparação em um espaço do Genie.
  • Atualizar dados: atualize os dados executando a consulta gerada anteriormente.
  • Regenere a resposta: envie a pergunta novamente e fazer com que o Genie regenere a resposta.

Editar e salvar 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. Frequentemente, 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 exibir o SQL gerado para qualquer resposta.

Você poderá 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, 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.

Monitorar o espaço

Um espaço do Genie pode ser considerado como uma ferramenta de colaboração de longo prazo entre equipes de dados e usuários de negócios. 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 a guia Monitoramento para examinar perguntas e respostas individuais, exibir comentários do usuário e identificar as respostas sinalizadas para revisão.

A guia de monitoramento mostra todas as perguntas e respostas que foram realizadas no espaço. Você pode filtrar perguntas por tempo, classificação, usuário ou status. Ao monitorar o espaço, os usuários com permissões CAN MANAGE podem entender proativamente as consultas levantadas pelos usuários empresariais e como o espaço do Genie respondeu.

Identificar as perguntas com as quais o Genie luta pode ajudá-lo a atualizar o espaço do Genie com instruções específicas para melhorar suas respostas. Clique em uma pergunta para abrir o texto de pergunta e resposta e exibir o thread de chat completo.

Compartilhar um espaço do Genie

Quando você compartilha um espaço do Genie, os usuários devem ter as seguintes permissões para interagir com o espaço:

• Direitos: o acesso do consumidor ou o direito ao workspace do Databricks SQL. Consulte Gerenciar direitos.
• Computação: pelo menos a permissão PODE USAR no armazém padrão designado para o espaço do Genie.
• Acesso a dados: Pelo menos SELECT privilégios para todos os objetos de dados no Catálogo do Unity usados no espaço.
• ACLs de espaço do Genie: Pelo menos pode exibir/pode executar permissões no espaço do Genie. Consulte ACLs do espaço Genie.

Os novos espaços Genie são salvos na pasta do usuário por padrão. Assim como outros objetos do espaço de trabalho, eles herdam permissões de sua pasta envolvente. Você pode usar a estrutura de pastas do workspace para compartilhá-las com outros usuários. Consulte o navegador do espaço de trabalho.

Você também pode especificar determinados usuários ou grupos com os quais 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 definir os níveis de permissão apropriados. Usuários individuais e membros de pequenos grupos recebem uma notificação por email confirmando que o espaço foi compartilhado.
3. Utilize o botão Copiar link na parte inferior da janela de compartilhamento para obter um link para compartilhamento para o espaço do Genie. Usuários com privilégios podem clicar no link para abrir o espaço do Genie em uma nova aba e fazer perguntas.

Clonar um espaço do Genie

A clonagem de um espaço do Genie cria uma cópia que inclui todo o contexto de instalação e instruções. A clonagem é útil quando você deseja testar 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 clonado do Genie:

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

Os threads de chat 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 você quer clonar.
2. Clique no Menu kebab no canto superior direito do espaço.
3. Clique em Clonar.
4. (Opcional) Na caixa de diálogo Clonar, especifique um novo nome e um local para a pasta de trabalho do espaço clonado do Genie.
5. Clique em Clonar para criar o espaço.

Recursos adicionais

• Para obter diretrizes sobre as práticas recomendadas e ajudar a solucionar problemas, consulte Organizar um espaço Genie eficaz.
• Para saber como usar logs de auditoria para acompanhar a atividade e o uso em um espaço do Genie, consulte eventos de IA/BI do Genie.
• Consulte Usar a API do Genie para integrar o Genie em seus aplicativos para saber como gerenciar os espaços do Genie programaticamente e usar a API de conversa do Genie. Consulte também a referência da API do Genie.
• Para saber como criar um sistema de vários agentes usando o Mosaic AI Agent Framework, consulte Usar o Genie em sistemas de vários agentes.