Organize um espaço Genie eficaz

O objetivo da curadoria de um espaço Genie é criar um ambiente em que os usuários corporativos possam fazer perguntas em linguagem natural e receber respostas precisas e consistentes com base em seus dados. Genie spaces usar modelos avançados que geram consultas sofisticadas e compreendem o conhecimento geral do mundo.

A maioria das questões de negócios é específica de um domínio, portanto, o papel de um curador de espaço é preencher a lacuna entre esse conhecimento geral do mundo e a linguagem especializada usada em um domínio específico ou por uma empresa específica. Os curadores usam metadados e instruções para ajudar o Genie a interpretar e responder com precisão às perguntas dos usuários corporativos. Este artigo descreve as melhores práticas e princípios para guiá-lo no desenvolvimento de um espaço bem-sucedido.

Melhores práticas para definir um novo espaço

Ao construir seu espaço Genie, tenha em mente estes princípios orientadores:

• Forneça um conjunto de dados conciso e focado : resolva ambiguidades de coluna e pré-join ou desnormalize tabelas usando a visualização ou a visualização de métricas. Conjuntos de dados simplificados melhoram a capacidade do Genie de responder a perguntas sobre dados com precisão.
• Priorize expressões SQL e exemplos de SQL em vez de instruções em texto : Use expressões SQL para definir a semântica de negócios, como métricas e filtros. Use exemplos de SQL para ensinar o Genie a lidar com prompts ambíguos comuns. Reserve as instruções em texto para orientações gerais que não se encaixem em definições estruturadas.
• Escreva instruções claras e específicas por escrito : Evite instruções vagas. Por exemplo, em vez de "Faça perguntas para esclarecimento quando questionado sobre vendas", escreva "Quando os usuários perguntarem sobre vendas métricas sem especificar o nome do produto ou o canal de vendas, pergunte: Para prosseguir com a análise de vendas, especifique o nome do seu produto e o canal de vendas."
• Evite instruções conflitantes : Garanta a consistência em todos os tipos de instruções. Por exemplo, se as instruções de texto especificarem o arredondamento de decimais para duas casas decimais, as consultas SQL de exemplo também deverão arredondar para duas casas decimais.

As seções a seguir fornecem recomendações detalhadas para a construção de espaços e a resolução de problemas de precisão.

começar small

A curadoria de um espaço Genie é um processo iterativo. Ao criar um novo espaço, comece o mais pequeno possível, com instruções mínimas e um conjunto limitado de perguntas a serem respondidas. Em seguida, o senhor pode acrescentar algo à medida que for iterando com base no feedback e no monitoramento. Essa abordagem ajuda a simplificar a criação e a manutenção do seu espaço e permite que você o organize de forma eficaz em resposta às necessidades reais do usuário.

Use as seguintes diretrizes para ajudar a criar um pequeno espaço Genie:

• Mantenha o foco : inclua apenas as tabelas necessárias para responder às perguntas que você deseja que o espaço resolva. Procure cinco ou menos mesas. Quanto mais focada for sua seleção, melhor. O ideal é manter seu espaço estreitamente focado em uma pequena quantidade de dados, portanto, limite o número de colunas nas tabelas incluídas.
• Trabalhe dentro do limite de 25 tabelas : Genie spaces suportam até 25 tabelas ou visualizações. Se o seu tópico de dados exigir mais de 25 tabelas, pré-una as tabelas relacionadas na visualização ou na visualização de métricas antes de adicioná-las ao seu espaço. As métricas de visualização são particularmente eficazes para Genie spaces porque predefinem métricas, dimensões e agregações. Essa abordagem ajuda você a se manter dentro do limite, simplifica seu modelo de dados e pode melhorar a precisão da resposta do Genie. Consulte a seção "Gerenciar objetos de dados" para obter detalhes sobre como adicionar objetos de dados ao seu espaço.
• Planeje a iteração : comece com uma configuração mínima para o seu espaço, concentrando-se em tabelas essenciais e instruções básicas. Adicione orientações e exemplos mais detalhados à medida que você refina o espaço ao longo do tempo, em vez de buscar a perfeição inicialmente.
• Construir com base em tabelas bem anotadas : o site Genie usa nomes e descrições de colunas Unity Catalog para gerar respostas. Nomes e descrições claras das colunas ajudam a produzir respostas de alta qualidade. As descrições das colunas devem oferecer informações contextuais precisas. Evite detalhes ambíguos ou desnecessários. Inspecione todas as descrições geradas pelo AIquanto à precisão e clareza e use-as somente se estiverem alinhadas com o que o senhor forneceria manualmente.

Peça a um especialista em domínio que defina o espaço

Um criador de espaço eficaz precisa entender os dados e as percepções que podem ser extraídas deles. Os analistas de dados que são proficientes em SQL normalmente têm o conhecimento e as habilidades para fazer a curadoria do espaço.

Defina a finalidade do seu espaço

Identificar o público e o propósito específicos do seu espaço ajuda você a decidir quais dados, instruções e perguntas de teste usar. Um espaço deve responder perguntas sobre um determinado tópico e público, não perguntas gerais sobre vários domínios. O senhor pode simplificar seu conjunto de dados unindo previamente as tabelas e removendo colunas desnecessárias antes de adicionar dados a um espaço. Ao adicionar dados ao seu espaço, mantenha-os bem focados na finalidade definida do espaço. Oculte todas as colunas que possam ser confusas ou sem importância. Consulte Ocultar ou mostrar colunas relevantes.

Adicionar metadados e sinônimos

O senhor pode adicionar sinônimos de coluna e descrições personalizadas aos dados em um espaço Genie. Esses metadados têm como escopo o espaço do Genie e não substituem os metadados armazenados no Unity Catalog. Descrições de colunas e sinônimos de qualidade ajudam o Genie a entender melhor a coluna, escolhê-la para perguntas relevantes e escrever SQL mais preciso. Consulte Editar metadados da coluna.

Use a amostragem de dados do Genie

A amostragem de dados melhora a precisão do site Genieao amostrar valores do conjunto de dados no espaço, ajudando-o a corresponder melhor os prompts do usuário às colunas e aos valores corretos. O Genie coleta automaticamente amostras de valores das tabelas à medida que o senhor cria o espaço. O senhor pode gerenciar quais colunas têm dados amostrados. Consulte Gerenciar objetos de dados e Criar um armazenamento de conhecimento para obter mais confiabilidade Genie spaces.

Forneça exemplos e instruções focados

Genie spaces têm melhor desempenho com um conjunto limitado e focado de instruções. A Databricks recomenda o uso de exemplos de consultas SQL para fornecer instruções em seu espaço. Os exemplos de consultas SQL permitem que o Genie combine as solicitações do usuário com consultas SQL verificadas e aprenda com os exemplos a responder a perguntas relacionadas. Consulte Adicionar exemplos de consultas e funções SQL.

Para o contexto que deve ser aplicado globalmente no espaço do Genie, um conjunto pequeno e bem organizado de instruções em texto simples também pode ajudar a manter a relevância e melhorar a qualidade da resposta. O excesso de instruções pode reduzir a eficácia, especialmente em conversas mais longas, porque o Genie pode ter dificuldade para priorizar as orientações mais importantes. Para obter detalhes, consulte Fornecer instruções.

Escolha o tipo de instrução correto

Use as seguintes diretrizes para decidir entre expressões SQL e consultas SQL de exemplo:

• Use expressões SQL para termos comerciais comuns : Ao definir métricas, filtros ou dimensões frequentemente usados que representam conceitos comerciais padrão, use expressões SQL no repositório de conhecimento. As expressões SQL são definições eficientes e reutilizáveis que ajudam o Genie a entender a sua lógica de negócios. Exemplos incluem margem bruta, vendas recentes e taxa de conversão. Consulte Definir expressões SQL.
• Use exemplos de consultas SQL para perguntas complexas : ao abordar perguntas complexas, multipartes ou difíceis de interpretar, forneça exemplos completos de consultas SQL. Esses exemplos mostram ao Genie como lidar com padrões de consulta complexos e lógica de várias etapas. Por exemplo, você pode criar consultas SQL para prompts como "detalhar o desempenho da minha equipe" ou "Para clientes que entraram recentemente, quais produtos estão tendo o melhor desempenho?". Veja Adicionar exemplos de consultas e funções SQL.

Genie da Instrução pode fazer perguntas para esclarecimento.

Para incentivar o Genie a fazer perguntas de esclarecimento em determinados cenários, seja explícito sobre quando pedir esclarecimentos e como proceder após o pedido. Utilize instruções claras e específicas que definam tanto as condições de ativação quanto o comportamento de esclarecimento esperado.

Por exemplo, adicione o seguinte tipo de instrução ao seu espaço:

Quando os usuários perguntam sobre a análise do desempenho de vendas, mas não incluem o período, o canal de vendas ou quais KPIs em sua solicitação, você deve primeiro fazer uma pergunta de esclarecimento para coletar as informações necessárias. Por exemplo: "Por favor, especifique o intervalo de tempo e o canal de ventilação que você está procurando."

Estruture suas instruções de esclarecimento com estes componentes:

• Condição de ativação : Defina quais tópicos ou cenários exigem esclarecimento (por exemplo, "Quando os usuários perguntam sobre o tópico X...")
• Informações em falta : Especifique quais informações devem estar presentes (por exemplo, "...mas não inclua detalhes Y...")
• Ação necessária : Indique que o Genie deve pedir esclarecimentos (por exemplo, "...você deve fazer uma pergunta para esclarecer a dúvida primeiro...")
• Exemplo de esclarecimento : Forneça a pergunta específica que o Genie deve fazer (por exemplo, "Por favor, especifique...")

Adicione instruções para perguntas de esclarecimento ao final das suas instruções gerais para ajudar o Genie a priorizar esse comportamento ao responder a perguntas ambíguas.

Teste e ajuste

Você deve ser o primeiro usuário do seu espaço. Depois que o senhor criar um novo espaço, comece a fazer perguntas. Examine cuidadosamente o SQL gerado em resposta às suas perguntas. Se o Genie interpretar mal os dados, as perguntas ou o jargão comercial, o senhor poderá intervir editando o SQL gerado ou fornecendo outras instruções específicas. Continue testando e editando até obter respostas confiáveis.

Depois de analisar uma pergunta, você pode adicioná-la como uma pergunta de referência que pode ser usada para testar e avaliar sistematicamente seu espaço em termos de precisão geral. O senhor pode usar variações e frases de perguntas diferentes para testar as respostas do Genie. Consulte Usar benchmarks em um espaço Genie.

Para obter ideias sobre como corrigir respostas errôneas, consulte Solução de problemas Genie spaces.

Realizar testes com usuários

Depois de verificar a qualidade da resposta por meio de testes, recrute um usuário corporativo para experimentar o espaço Genie. Use as diretrizes a seguir para proporcionar uma jornada tranquila ao usuário e coletar feedback para melhoria contínua:

• Defina expectativas de que o trabalho deles é ajudar a refinar o espaço.
• Peça que eles concentrem seus testes no tópico e nas perguntas específicas que o espaço foi projetado para responder.
• Se receberem uma resposta incorreta, incentive os usuários a adicionarem instruções e esclarecimentos adicionais no chat para refinar a resposta. Quando uma resposta correta é fornecida, eles devem votar positivamente na consulta final para minimizar erros semelhantes em interações futuras.
• Diga aos usuários para votarem a favor ou contra as respostas usando o mecanismo de feedback integrado.
• Convide os usuários a compartilhar feedback adicional e perguntas não resolvidas diretamente com os autores do espaço. Os autores e editores podem usar o feedback para refinar as instruções, os exemplos e o ativo confiável.

Considere fornecer materiais de treinamento ou um documento escrito com diretrizes para testar o espaço e fornecer feedback. Oriente os usuários empresariais a usar um espaço Genie para explorar dados empresariais e ajudá-los a começar a trabalhar com um novo espaço Genie.

À medida que os usuários corporativos testam o espaço, os usuários com pelo menos CAN MANAGE permissões podem ver as perguntas que fizeram no monitoramento tab. Continue adicionando contexto para ajudar o Genie a interpretar corretamente as perguntas e os dados para fornecer respostas precisas. Consulte Monitorar o espaço para saber mais sobre o monitoramento Genie spaces. O senhor também pode usar os logs de auditoria para monitorar o feedback do espaço Genie e as solicitações de revisão. Consulte Monitorar o uso do AI/BI com auditoria logs e alerta.

nota

Os usuários corporativos devem ser membros do site workspace de origem para acessar seu espaço. Consulte Permissões necessárias para saber como fornecer as permissões apropriadas para interagir com o espaço.

Para solucionar problemas comuns com Genie spaces, consulte Solução de problemas Genie spaces.