Organize um espaço Genie eficaz

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

A maioria das questões de negócios são específicas do domínio, então 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 em particular. 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 de sucesso.

Melhores práticas para definir um novo espaço

Tenha em mente estes princípios orientadores enquanto constrói o seu espaço Genie:

• Fornecer conjuntos de dados concisos e focados: Resolver ambiguidades das colunas e pré-juntar ou desnormalizar tabelas usando vistas ou vistas métricas. Conjuntos de dados simplificados melhoram a capacidade do Genie de responder com precisão às perguntas sobre dados.
• Priorize expressões SQL e exemplos de SQL em vez de instruções de texto: Use expressões SQL para definir semântica de negócio como métricas e filtros. Usa SQL de exemplo para ensinar o Genie a lidar com prompts ambíguos comuns. Reserve instruções em texto para orientações gerais que não se enquadrem em definições estruturadas.
• Escreva instruções claras e específicas em texto: Evite instruções vagas. Por exemplo, em vez de "Faça perguntas de esclarecimento quando questionado sobre vendas", escreva "Quando os utilizadores perguntam sobre métricas de vendas sem especificar o nome do produto ou o canal de vendas, pergunte: Para avançar com a análise de vendas, especifique o nome do seu produto e canal de vendas."
• Evite instruções conflitantes: Garanta consistência entre todos os tipos de instruções. Por exemplo, se instruções de texto especificarem arredondar decimais para dois dígitos, então consultas SQL de exemplo também devem arredondar para dois dígitos.

As secções seguintes fornecem recomendações detalhadas para construir espaços e resolver desafios de precisão.

Comece pequeno

A curadoria de um espaço Genie é um processo iterativo. Ao criar um novo espaço, comece o menor possível, com instruções mínimas e um conjunto limitado de perguntas para responder. Em seguida, pode-se adicionar conforme for iterando com base no feedback e na monitorização. Esta abordagem ajuda a agilizar a criação e manutenção do seu espaço e permite-lhe organizá-lo de forma eficaz em resposta às necessidades reais dos utilizadores.

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 trate. Procure ter cinco ou menos tabelas. Quanto mais focada for a sua seleção, melhor. Manter seu espaço estritamente focado em uma pequena quantidade de dados é ideal, portanto, limite o número de colunas em suas tabelas incluídas.
• Trabalhe dentro do limite de 25 tabelas: os espaços Genie suportam até 25 tabelas ou vistas. Se o seu tema de dados exigir mais de 25 tabelas, pré-junte tabelas relacionadas em vistas ou vistas métricas antes de as adicionar ao seu espaço. As vistas métricas são particularmente eficazes para espaços Genie porque pré-definem métricas, dimensões e agregações. Essa abordagem ajuda você a ficar dentro do limite, simplifica seu modelo de dados e pode melhorar a precisão de resposta do Genie. Consulte Gerenciar objetos de dados para obter detalhes sobre como adicionar objetos de dados ao seu espaço.
• Planeie um processo iterativo: Comece com uma configuração mínima para o seu espaço, concentrando-se em mesas essenciais e instruções básicas. Adicione orientações e exemplos mais detalhados à medida que refina o espaço ao longo do tempo, em vez de ter como objetivo alcançar a perfeição inicialmente.
• Crie com base em tabelas bem anotadas: o Genie usa nomes de colunas e descrições do Unity Catalog para gerar respostas. Nomes de colunas claros e descrições 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 por IA quanto à precisão e clareza, e use-as somente se estiverem alinhadas com o que você 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 os insights que podem ser extraídos deles. Os analistas de dados que são proficientes em SQL normalmente têm o conhecimento e as habilidades para organizar o espaço.

Defina o propósito do seu espaço

Identificar o público e a finalidade específicos do seu espaço ajuda você a decidir quais dados, instruções e perguntas de teste usar. Um espaço deve responder a perguntas para um determinado tópico e público, não a perguntas gerais em vários domínios. Você pode simplificar seus conjuntos de dados pré-unindo tabelas e removendo colunas desnecessárias antes de adicionar dados a um espaço. À medida que adiciona dados ao seu espaço, mantenha-o firmemente focado na finalidade definida do espaço. Oculte quaisquer colunas que possam ser confusas ou sem importância. Consulte Ocultar ou mostrar colunas relevantes.

Adicionar metadados e sinónimos

Você pode adicionar sinônimos de coluna e descrições personalizadas aos dados em um espaço do 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 de qualidade e sinônimos ajudam o Genie a entender melhor a coluna, escolhê-la para perguntas relevantes e escrever SQL mais preciso. Consulte Editar metadados da coluna.

Usar amostragem de dados do Genie

A amostragem de dados melhora a precisão do Genie ao amostrar valores de conjuntos de dados no espaço, ajudando-o a corresponder melhor os prompts do usuário às colunas e valores corretos. O Genie coleta automaticamente amostras de valores de tabelas à medida que você cria o espaço. Você pode gerenciar quais colunas têm dados amostrados. Consulte Gerenciar objetos de dados e Criar um repositório de conhecimento para espaços Genie mais confiáveis.

Forneça exemplos e instruções focados

Os espaços Genie têm o melhor desempenho com um conjunto limitado e focado de instruções. O Databricks recomenda aproveitar consultas SQL de exemplo para fornecer instruções em seu espaço. Exemplos de consultas SQL permitem que o Genie faça a correspondência entre prompts do usuário e consultas SQL verificadas e aprenda com exemplos para responder a perguntas relacionadas. Consulte Adicionar exemplos de consultas e funções SQL.

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

Escolha o tipo de instrução certo

Use as diretrizes a seguir 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 usados com freqüência que representam conceitos de negócios 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 sua lógica de negócios. Os exemplos incluem margem bruta, vendas recentes e taxa de conversão. Veja Definir expressões SQL.
• Use consultas SQL de exemplo para perguntas complexas: Ao abordar perguntas difíceis de interpretar, com várias partes ou complexas, forneça consultas SQL de exemplo completo. Estes 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 aderiram recentemente, quais produtos estão fazendo melhor?". Consulte Adicionar exemplos de consultas e funções SQL.

Incentive o Génio a fazer perguntas de esclarecimento

Para incentivar o Génio a fazer perguntas de esclarecimento em certos cenários, seja explícito sobre quando pedir esclarecimentos e como fazer seguimento. Use instruções claras e específicas que definam tanto as condições desencadeadoras como o comportamento de esclarecimento esperado.

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

Quando os utilizadores perguntam sobre a divisão do desempenho das vendas, mas não incluem o intervalo temporal, o canal de vendas, ou quais os KPIs na sua pergunta, deve primeiro fazer uma pergunta de esclarecimento para recolher a informação necessária. Por exemplo: "Por favor, especifique o intervalo temporal e o canal de vendas que procura."

Estrutura as tuas instruções de esclarecimento com estes componentes:

• Condição de gatilho: Defina que tópicos ou cenários requerem esclarecimento (por exemplo, "Quando os utilizadores perguntam sobre o tema X...")
• Detalhes em falta: Especifique que informação deve estar presente (por exemplo, "... mas não incluam detalhes Y...")
• Ação obrigatória: Declarar que o Génio deve pedir esclarecimento (por exemplo, "... tens de fazer primeiro uma pergunta de esclarecimento...")
• Exemplo de esclarecimento: Forneça a pergunta específica que o Génio deve colocar (por exemplo, "Por favor, especifique...")

Acrescenta instruções para perguntas de esclarecimento no final das tuas instruções gerais para ajudar o Genie a priorizar este comportamento ao responder a perguntas ambíguas.

Testar e ajustar

Deve ser o primeiro utilizador do seu espaço. Depois de criar um novo espaço, comece a fazer perguntas. Examine cuidadosamente o SQL gerado em resposta às suas perguntas. Se o Genie interpretar incorretamente os dados, perguntas ou jargão comercial, você pode intervir editando o SQL gerado ou fornecendo outras instruções específicas. Continue testando e editando até obter respostas confiáveis.

Depois de teres revisto uma questão, poderás adicioná-la como uma questão de referência que pode ser usada para testar e avaliar a precisão geral do teu espaço de forma sistemática. Você pode usar variações e diferentes fraseados de perguntas para testar as respostas do Genie. Veja Utilizar benchmarks num espaço Genie.

Para ideias sobre como corrigir respostas erradas, veja Troubleshoot Genie spaces.

Efetuar testes de utilizador

Depois de verificar a qualidade da resposta através de testes, recrute um utilizador empresarial para experimentar o espaço Genie. Use as diretrizes a seguir para fornecer uma jornada do usuário suave e coletar feedback para melhoria contínua:

• Estabeleça expectativas de que seu trabalho é ajudar a refinar o espaço.
• Peça-lhes que concentrem os seus testes no tópico específico e nas perguntas a que o espaço foi concebido para responder.
• Se receberem uma resposta incorreta, incentive os usuários a adicionar instruções e esclarecimentos adicionais no bate-papo para refinar a resposta. Quando uma resposta correta é fornecida, deve-se votar positivamente na última consulta para minimizar erros semelhantes em interações futuras.
• Diga aos utilizadores para votar a favor ou contra respostas usando o mecanismo de feedback integrado.
• Convide os usuários a compartilhar comentários adicionais e perguntas não resolvidas diretamente com os autores do espaço. Autores e editores podem usar comentários para refinar instruções, exemplos e ativos confiáveis.

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

À medida que os utilizadores empresariais testam o espaço, os utilizadores com pelo menos permissões CAN MANAGE podem ver as perguntas que fizeram no separador Monitorização . 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 como monitorar espaços Genie. Você também pode usar logs de auditoria para monitorar feedback do espaço Genie e avaliar solicitações. Veja Monitorizar o uso de IA/BI com logs e alertas de auditoria.

Para resolver problemas comuns com Espaços Genie, consulte Solucionar Espaços Genie.