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 empresariais são específicas 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 determinada empresa. Os curadores usam metadados e instruções para ajudar a Genie a interpretar e responder com precisão às perguntas dos usuários corporativos. Esta página descreve as melhores práticas e princípios para orientá-lo no desenvolvimento de um espaço de sucesso.

Melhores práticas para definir um novo espaço

Considere Genie como um novo analista de dados que se junta à sua empresa. Assim como qualquer novo membro da equipe, Genie precisa de um contexto claro para ser eficaz. Ele se baseia em descrições de tabelas e colunas de alta qualidade para entender o que os dados representam, em exemplos de consultas SQL para aprender a resolver problemas comuns, em expressões SQL para definir a terminologia de negócios e em instruções textuais somente quando outros métodos não se aplicam. Quanto mais contexto estruturado você fornecer por meio de metadados e exemplos, mais precisamente o Genie poderá interpretar as perguntas e gerar resultados corretos.

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

• Forneça um conjunto de dados conciso e bem documentado : Descrições de tabelas e colunas de qualidade no Unity Catalog são essenciais para a precisão Genie . Resolva ambiguidades de coluna e pré-join ou desnormalize tabelas usando view ou métricas view. Um conjunto de dados bem documentado e simplificado melhora 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. Utilize instruções em texto apenas como último recurso, quando expressões e exemplos SQL não forem suficientes para atender à necessidade. Definições estruturadas por meio de SQL são mais confiáveis e fáceis de manter do que orientações em texto simples.
• 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 30 tabelas : Genie spaces suportam até 30 tabelas ou visualizações. Se o seu tópico de dados exigir mais de 30 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 função de correspondência Genie

A correspondência de prompts permite que o Genie encontre os valores mais relevantes para a pergunta do usuário e corrija erros de ortografia nos prompts. Isso melhora a precisão do Genie, ajudando-o a associar melhor as solicitações do usuário às colunas e valores corretos. O Genie fornece automaticamente sugestões de correspondência à medida que você adiciona mesas ao espaço. Você pode gerenciar quais colunas têm a correspondência de prompts ativada. Consulte Gerenciar objetos de dados e Criar um repositório de conhecimento para Genie spacesmais confiáveis.

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

Utilize as seguintes diretrizes para decidir entre expressões SQL, exemplos de consultas SQL e instruções em texto:

• 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. Por exemplo, use expressões SQL para definir revenue, active_customers, gross_margin ou recent_sales. 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.
• Utilize instruções de texto apenas como último recurso : As instruções de texto devem ser usadas com moderação, somente quando as expressões e exemplos SQL não forem suficientes para atender à necessidade. Use instruções em texto para orientações que exigem explicação em linguagem natural, como "Quando os usuários perguntarem sobre o desempenho do cliente sem especificar um período, peça que esclareçam o período" ou "Sempre arredonde as porcentagens para duas casas decimais nos resumos". Evite usar instruções de texto para definir métricas, filtros ou padrões de consulta que podem ser expressos por meio de 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.

Personalizar resumos

O Genie fornece resumos em linguagem natural juntamente com os resultados da consulta para ajudar os usuários a entender os dados. Você pode personalizar a forma como o Genie gera esses resumos adicionando instruções específicas às instruções de texto do seu espaço. As instruções resumidas de personalização aplicam-se a todas as respostas neste espaço.

Para personalizar o comportamento do resumo, adicione uma seção específica ao final das suas instruções de texto com o título "Instruções que você deve seguir ao fornecer resumos".

Exemplo de instruções de personalização resumidas:

Instruções que você deve seguir ao fornecer resumos

• Ao fornecer resumos, responda sempre em francês.
• Cite os nomes das tabelas e colunas usados em sua análise.
• Use marcadores para estruturar resumos em várias partes.
• Inclua o intervalo de datas abrangido pelos resultados.

nota

• Somente as instruções de texto afetam a geração do resumo. Os exemplos e expressões SQL não influenciam a forma como Genie SQL resumos.
• Algumas opções de personalização não estão disponíveis, como controlar o tamanho do resumo e o nível de detalhes.

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 de negócios testam o espaço, os usuários com pelo menos permissões CAN MANAGE podem ver as perguntas que fizeram na tab de monitoramento . Continue adicionando contexto para ajudar o Genie a interpretar corretamente as perguntas e os dados, a fim de fornecer respostas precisas. Consulte a seção Monitorar o espaço para saber mais sobre como monitorar Genie spaces. Você também pode usar logs de auditoria para monitorar o feedback do espaço Genie e as solicitações de revisão. Consulte o monitoramento do uso Genie spaces com logs de auditoria e alertas.

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.