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

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

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

• Catálogo Unity: Os dados para o espaço Genie devem ser registrados no Catálogo Unity. Pode adicionar até 25 tabelas ou vistas a um espaço Genie.
• Calcular: Os espaços Genie requerem um armazém SQL profissional ou sem servidor. Você deve ter pelo menos a permissão 'CAN USE' no armazém selecionado. Se essa permissão estiver faltando, a criação de espaço falhará.
• Rendimento: Cada espaço de trabalho pode responder a até 20 perguntas por minuto em todos os espaços Genie quando acedido através da interface do Azure Databricks.
• Capacidade : Cada espaço Genie pode suportar 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ê deve ter as seguintes permissões e direitos:

• Direitos: Você deve ter o direito ao espaço de trabalho Databricks SQL. Consulte Gerenciar direitos.
• Calcular: PODE USAR o acesso em pelo menos um SQL warehouse profissional ou sem servidor.
• Acesso aos dados:SELECT privilégios sobre os dados usados no espaço.
• ACLs de espaço Genie: Pelo menos PODE EDITAR permissões no espaço Genie. Os criadores de espaço Genie têm automaticamente permissões CAN MANAGE nos espaços que criam. Consulte ACLs do espaço Genie.

Gerencie o acesso ao Genie

O Genie usa recursos de IA baseados em parceiros, que devem ser habilitados nos níveis de conta e espaço de trabalho. Para saber como gerenciar esses recursos para sua conta, consulte Recursos de IA baseados em parceiros.

Crie um espaço Genie

Para criar um espaço Genie:

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

Rever 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 entender melhor as relações entre tabelas e a semântica do seu negócio. Quando você adiciona ativos de dados a um espaço, o Genie procura automaticamente consultas de espaço de trabalho populares relevantes 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 guia Dados do painel Instruções . Clique em Rever para ver as sugestões de pesquisa.

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

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 Genie podem revisar consultas, desde que tenham pelo menos acesso CAN VIEW na própria consulta.

1. O texto do 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 visualizar a consulta completa, clique em ... mais linhas.
3. Se tiveres permissões suficientes na consulta, podes clicar em Consulta SQL para abri-la na interface de histórico de consultas. Consulte Exibir histórico de consultas.
4. Depois de determinar se a consulta é relevante para o seu espaço, clique em Aceitar ou Rejeitar para adicioná-la ao seu espaço ou rejeitar a sugestão de acordo.
5. Clique nas outras sugestões para expandir e analisar.

As consultas aceitas aparecem no contexto Consultas SQL para o 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:

• Poderá não ter acesso suficiente a consultas relevantes.
• Pode não haver dados relevantes. Se as consultas não tiverem sido executadas nas tabelas incluídas, a pesquisa pode não retornar resultados.
• Consultas irrelevantes para o espaço 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 de trabalho. Se você criou tabelas ou exibições associadas especificamente para o espaço Genie, mas as consultas Databricks SQL relevantes geralmente 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 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.

Crie um repositório de conhecimento

Um armazenamento 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 organizar um espaço personalizando metadados locais e definindo instruções concisas e estruturadas. Ele contém alterações que abrangem um espaço único do Genie. O criador de espaço 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 armazenamento de conhecimento para espaços Genie mais fiáveis.

Adicionar exemplos e instruções SQL

Você pode adicionar consultas SQL de exemplo, funções do Catálogo Unity e instruções de texto simples para ajudar a gerar respostas precisas. Clique em Configurar>instruções. Use o separador Consultas SQL para gerir consultas e funções do Catálogo 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 Genie. Tipos de instruções 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 Instruções gerais conta como um.

Um espaço Genie visa fornecer respostas consistentes e previsíveis com base em orientações claras e precisas. Como o Genie opera de maneira não determinística, é importante tornar a orientação livre de informações conflitantes ou ambíguas para minimizar o risco de respostas indesejáveis. Ao configurar o espaço, uma tarefa fundamental é rever e resolver quaisquer inconsistências. Isso ajuda a alcançar resultados confiáveis.

Adicionar exemplos de consultas e funções SQL

Use o separador Consultas SQL para adicionar o seguinte conteúdo:

• Exemplos de consultas (recomendado): Exemplos de consultas SQL 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 o fraseado mais típico da pergunta do usuário como título. Isso melhora a capacidade do Genie de combinar prompts com o 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. Os usuários com privilégios CAN EDIT no espaço podem visualizar 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 Unity Catalog. As funções podem ser compartilhadas entre suas equipes e usadas pelo Genie para responder a perguntas específicas. As respostas 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 Genie, consulte Usar ativos confiáveis em espaços do AI/BI Genie.

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, em seguida, insira uma consulta SQL que responda a essa pergunta. Escreva a pergunta de exemplo da maneira que um usuário naturalmente faria. 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 exemplos que destaquem a lógica exclusiva da sua organização e dos 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 tempo de execução. Para saber mais sobre como trabalhar com consultas parametrizadas, consulte Usar parâmetros em consultas SQL.

Fornecer orientação de uso

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

Para adicionar orientações de utilização:

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ções de utilização na parte inferior do ecrã.
4. Insira detalhes sobre como e quando usar esta consulta de exemplo.

Como o Genie usa as funções SQL?

As funções SQL são úteis quando uma pergunta envolve 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. O Genie não pode visualizar ou modificar o SQL usado na função, tornando essa abordagem adequada para lógica que não deve ser apresentada ou alterada. Para obter orientação sobre como registrar 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.

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 uma 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. As instruções gerais de texto aplicam-se a todos os prompts. Se uma instrução for relevante apenas para um subconjunto de prompts, ela deve 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 contexto que deve ser aplicado globalmente e não se encaixam nos outros formatos.

O exemplo a seguir inclui informações que você pode incluir em 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"

Configurar definições

Personalize seu espaço Genie definindo configurações adicionais. Clique em Configurar>configurações para acessar as seguintes configurações:

• Título: O título aparece no explorador do espaço de trabalho juntamente com outros objetos do espaço de trabalho. Escolha um título que ajude os utilizadores finais a descobrir o seu espaço Genie.
• Default warehouse: Este recurso de computação alimenta as instruções SQL geradas nos espaços Genie. Os usuários finais precisam ter acesso a esse armazém para interagir com o espaço. Um espaço Genie pode usar um armazém de dados SQL profissional ou sem servidor. Para um desempenho ideal, o Databricks recomenda o uso de um SQL warehouse sem servidor.
• Descrição: Os usuários veem a descrição quando abrem o espaço Genie. Use esta área de texto para descrever a finalidade do espaço. O campo de descrição suporta formatação Markdown para que você possa estilizar seu texto e fornecer links para contexto e referências úteis. Para obter mais informações sobre sintaxe de markdown, consulte o Markdown Guide cheat sheet.
• Carregamento de ficheiros Genie: Se os carregamentos de ficheiros (Pré-visualização Pública) estiverem ativados para o seu espaço Genie, pode selecionar Permitir que os utilizadores carreguem ficheiros para conversações. Consulte Carregar um ficheiro.
• Exemplos de perguntas: As 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 posteriormente a partir das Configurações do espaço.
• Tags: Use tags para organizar e categorizar espaços Genie para facilitar o gerenciamento. Consulte Adicionar tags.

Espere iterar no seu espaço Genie com base em testes e uso. Para obter informações sobre as melhores práticas para criar e iterar sobre um espaço, consulte Curate um espaço Genie eficiente.

Adicionar tags

Você deve ter pelo menos permissões CAN EDIT em um espaço do Genie para adicionar uma tag. Para adicionar uma tag governada, você também deve ter a permissão ASSIGN na tag governada. A pesquisa não é suportada usando tags de espaço do Genie. Para obter mais informações sobre etiquetas, consulte Aplicar etiquetas a objetos seguros do Unity Catalog.

1. Clique em Definir>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 no ícone Adicionar /Editar tags.

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

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

Teste o seu espaço Genie

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

Exemplos de perguntas configuradas nas configurações de espaço aparecem na janela de chat. 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 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 bate-papo.

Para iniciar uma nova conversa:

1. Clique em Nova conversa para iniciar uma nova conversa. Clique no para abrir uma conversa anterior.
2. Digite a sua pergunta no campo de texto Faça a sua pergunta....

Revisão de respostas

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

Feedback sobre a resposta

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

• Sim: Confirma que a resposta parece correta.
• Corrija-o: Sinaliza a resposta como incorreta. Os usuários podem selecionar entre problemas comuns ou inserir sua própria explicação. Podem, então:
  • Clique em Enviar e tente novamente gerar novamente a resposta usando os comentários fornecidos.
  • Clique em Enviar para enviar o feedback sem regenerar a resposta.
• Solicitar revisã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 visualizar comentários e respostas sinalizadas na interface do Genie. O comportamento do seu espaço Genie não muda apenas com base no feedback dos utilizadores. 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 visualizar atualizações das perguntas marcadas para revisão na página Monitoramento . Os usuários com pelo menos permissão CAN MANAGE no espaço Genie podem revisar a troca específica, comentar a solicitação e confirmar ou corrigir a resposta. Eles podem acessar comentários e revisar solicitações na página de monitoramento. De seguida, poderá usar esse feedback para aprimorar as respostas e aperfeiçoar o seu espaço. Veja Monitorizar 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 utilizadores do espaço podem transferir até 1 GB de dados de resultados, aproximadamente, em formato CSV. O tamanho final do download do arquivo pode ser um pouco maior ou menor que 1GB, pois o limite de 1GB é aplicado a uma etapa anterior ao download do arquivo final. Para baixar resultados, clique no ícone de download na resposta.

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

• O Aceda às seguintes ações:

  • Copiar CSV: copie o CSV da resposta para a área de transferência.
  • Adicionar como instrução: Para interações que possam ser úteis para ensinar o Genie a responder a 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 SQL geradas. Você pode deixar o exemplo como escrito ou editar e salvar para fazer alterações. Consulte Adicionar exemplos de consultas e funções SQL.
  • Adicionar como referência: Adicione a pergunta como uma pergunta de referência. Veja Utilizar benchmarks num espaço Genie.
  • Atualizar dados: atualize os dados executando a consulta gerada anteriormente.
  • Regenere a resposta: envie a pergunta novamente e peça ao Genie que 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. Muitas vezes, os erros podem ser corrigidos com uma pequena quantidade de ajuste manual para a consulta SQL gerada. Clique em Mostrar código gerado para inspecionar a consulta e exibir o SQL gerado para qualquer resposta.

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

Monitorize o espaço

Um espaço Genie pode ser pensado 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 revisar perguntas e respostas individuais, exibir comentários de usuários e identificar respostas sinalizadas para revisão.

A guia de monitoramento mostra todas as perguntas e respostas que foram feitas no espaço. Você pode filtrar perguntas por tempo, classificação, usuário ou status. Ao monitorar o espaço, os usuários com permissões CAN MANAGE 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 se debate 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 da pergunta e da resposta e visualizar o tópico de bate-papo completo.

Partilhe uma sala do Genie

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

• Permissões: A permissão de acesso do consumidor ao espaço de trabalho Databricks SQL. Consulte Gerenciar direitos.
• Calcular: Pelo menos a permissão CAN USE no armazém padrão designado para o espaço Genie.
• Acesso aos dados: Pelo menos SELECT privilégios em todos os objetos de dados do Unity Catalog utilizados no espaço.
• ACLs de espaço Genie: Pelo menos as permissões CAN VIEW/CAN RUN no espaço Genie. Consulte ACLs do espaço Genie.

Os novos espaços Genie são guardados na sua pasta de utilizador por predefinição. Como outros objetos de espaço de trabalho, eles herdam permissões de sua pasta anexa. Você pode usar a estrutura de pastas do espaço de trabalho para compartilhá-las com outros usuários. Consulte Navegador de 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: PODE GERENCIAR, PODE EDITAR, PODE EXECUTAR e PODE VISUALIZAR.

Para partilhar com utilizadores ou grupos específicos:

1. Clique Partilhar.
2. Introduza os utilizadores ou grupos com os quais pretende partilhar 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 por e-mail confirmando que o espaço foi compartilhado.
3. Use o botão Copiar link na parte inferior do diálogo de Partilha para obter um link partilhável para o espaço do Genie. Os utilizadores privilegiados podem clicar no link para abrir o espaço do Genie numa nova guia e colocar questões.

Clone um espaço do Genie

A clonagem de um espaço Genie cria uma cópia que inclui todo o contexto e instruções de configuração. 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 Genie clonado:

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

Os tópicos de chat existentes e os dados de monitoramento não são copiados para o novo espaço.

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

1. Abra o espaço do Genie que deseja clonar.
2. Clique no 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 novo local de pasta de espaço de trabalho para o espaço clonado do Genie.
5. Clique em Clone para criar o novo espaço.

Recursos adicionais

• Para obter orientação sobre práticas recomendadas e ajuda com a resolução de problemas, consulte Como organizar eficazmente um espaço Genie.
• Para saber como usar logs de auditoria para rastrear atividades e uso em um espaço do Genie, consulte Eventos do AI/BI Genie.
• Veja Use a API do Genie para integrar o Genie nas suas aplicações e aprenda a gerir programaticamente os espaços Genie e a usar a API de conversação do Genie. Veja também a referência da API do Genie.
• Para saber como criar um sistema multiagente usando o Mosaic AI Agent Framework, consulte Usar o Genie em sistemas multiagente.