Resolver problemas de Genie Agents

Resolver problemas comuns ao criar e manter um Agente Genie: jargão empresarial mal compreendido, uso incorreto de tabelas ou colunas, erros de filtragem em valores específicos e truncamento do limite de tokens em conversas longas. Cada secção abaixo cobre o sintoma, a causa e a solução.

Para muitos destes problemas, o caminho mais rápido para uma solução é o Código Genie. Descreve o problema ao Genie Code, e ele sugere alterações ao contexto para reveres e aceitares. Para diagnosticar uma única resposta incorreta, veja Respostas de depuração com Código Genie. Para rever falhas de benchmark em conjunto, veja Analisar uma execução de benchmark com Genie Code.

Jargão empresarial incompreendido

A maioria das empresas ou domínios tem uma abreviatura específica que usam para comunicar sobre eventos específicos do negócio. Por exemplo, quando se refere a um ano, pode sempre significar o ano fiscal, e este ano fiscal pode começar em fevereiro ou março em vez de janeiro. Para permitir que o Genie responda a essas perguntas de forma natural e precisa, inclua instruções que mapeiam explicitamente o jargão do seu negócio para palavras e conceitos que o Genie pode entender. Consulte Fornecer instruções.

Uso incorreto de tabelas ou colunas

Se o Genie estiver tentando extrair dados de uma tabela incorreta ou executar análises em colunas incorretas, você poderá ajustar os dados de uma das seguintes maneiras:

• Forneça descrições claras e precisas: verifique suas tabelas e metadados associados para verificar se a terminologia usada corresponde à terminologia dos usuários nas perguntas enviadas. Caso contrário, refine a descrição ou adicione uma instrução que mapeie a terminologia usada na tabela para a terminologia usada na pergunta.
• Adicionar consultas de exemplo: forneça consultas SQL de exemplo que o Genie pode usar para aprender a responder a determinadas perguntas. Consulte Fornecer instruções.
• Remover tabelas ou colunas do agente: Algumas tabelas podem incluir colunas ou conceitos sobrepostos que dificultam que o Genie saiba quais dados usar numa resposta. Se possível, remova tabelas ou colunas desnecessárias ou sobrepostas. Para ocultar colunas da interface do Genie Agent sem alterar os objetos de dados subjacentes, veja Ocultar ou mostrar colunas relevantes.

Erros de filtragem

As consultas geradas geralmente incluem uma WHERE cláusula para filtrar os resultados de acordo com um valor específico. Quando o Genie não tem visibilidade dos valores de dados, ele pode definir a WHERE cláusula para filtrar o valor errado. Por exemplo, pode tentar associar o nome "California" quando a tabela usa abreviaturas como "CA."

Para situações como esta, verifique se as colunas relevantes têm valores de exemplo e dicionários de valor habilitados . Se novos dados tiverem sido adicionados a tabelas relevantes, atualize os valores. Ver visão geral da correspondência de prompts.

Junções incorretas

Se as referências de chave estrangeira não estiverem definidas no Unity Catalog, o seu agente pode não saber como juntar diferentes tabelas.

Tente implementar uma ou mais das seguintes soluções:

• Defina referências de chaves estrangeiras em seu catálogo Unity quando possível. Consulte a cláusula CONSTRAINT.
• Se as relações de chaves estrangeiras das suas tabelas não estiverem especificadas no Unity Catalog, defina relações de junção no repositório de conhecimento do seu agente Genie. Essa estratégia é útil para cenários de junção mais complexos, como auto-uniões, ou se não tem permissões suficientes para modificar as tabelas base. Consulte Definir relações de junção.
• Forneça consultas de exemplo em que você une tabelas de maneiras padrão.

Se nenhuma destas soluções resolver o problema, faz previamente a junção da tabela numa vista e utiliza-a como entrada para o agente.

Comentários de coluna não sincronizados de tabelas estrangeiras

O Azure Databricks não gerencia os metadados, dados ou semântica para gravações em tabelas estrangeiras. Dependendo da tabela de origem, os comentários podem não estar acessíveis a partir do Azure Databricks. Para disponibilizar comentários, o Azure Databricks recomenda seguir um destes procedimentos:

• Editar metadados das colunas na interface do Genie Agent. Metadados editados aplicam-se apenas ao Agente Genie onde estão escritos. Consulte Editar metadados da coluna.
• Crie vistas materializadas sobre tabelas federadas. Você pode adicionar e editar comentários em uma exibição materializada como faria em uma tabela gerenciada. Pode reutilizar esta vista entre vários Agentes Génio. Para obter detalhes sobre como carregar dados de tabelas estrangeiras para uma exibição materializada, consulte Carregar dados de tabelas estrangeiras com exibições materializadas. Para saber mais sobre como trabalhar com modos de exibição materializados, consulte Modos de exibição materializados.

Problemas de cálculo métrico

A forma como as métricas são calculadas e agrupadas pode ser arbitrariamente complicada e abranger muitos detalhes de negócio que o seu agente não compreende. Isso pode levar a relatórios incorretos.

Tente implementar uma ou mais das seguintes soluções:

• Defina as suas métricas como expressões SQL na loja de conhecimento. As expressões SQL fornecem definições precisas e reutilizáveis para medidas, filtros e dimensões que o Genie pode aplicar de forma consistente. Veja Definir expressões SQL.
• Se as suas métricas forem agregadas a partir de tabelas base, forneça exemplos de consultas SQL computando cada valor de agregação.
• Se suas métricas foram pré-calculadas e estão em tabelas agregadas, explique isso nos comentários da tabela. Especifique agregações válidas para cada métrica se as métricas nessa tabela puderem ser agregadas.
• Se o SQL que estás a tentar gerar for muito complicado, tenta criar vistas que já tenham agregado as tuas métricas para o teu agente.

Cálculos baseados no tempo incorretos

O Genie nem sempre pode inferir o fuso horário representado nos dados ou o fuso horário no qual sua análise precisa ser executada, a menos que você forneça explicitamente orientação adicional.

Inclua instruções mais explícitas detalhando o fuso horário de origem original, a função de conversão e o fuso horário de destino. Os exemplos a seguir mostram como alterar as instruções gerais para conversões de fuso horário mais confiáveis:

• Sempre converta horários em um fuso horário específico: Neste exemplo, suponha que o carimbo de data/hora de origem é UTC e você deseja resultados no fuso horário America/Los_Angeles. Adicione o seguinte às instruções, substituindo <timezone-column> pelo nome da coluna apropriado:
  • Os fusos horários nas tabelas estão em UTC.
  • Converta todos os fusos horários usando a seguinte função: convert_timezone('UTC', 'America/Los_Angeles', <timezone-column>).
• Converta formatos de data e hora não UTC para UTC: Se o fuso horário predefinido do espaço de trabalho for UTC, mas os utilizadores em Los Angeles tiverem de considerar hoje para um conjunto específico de registos, adicione o seguinte às instruções gerais do agente:
  • Para fazer referência hoje, use date(convert_timezone('UTC', 'America/Los_Angeles', current_timestamp())).

Consulte convert_timezone função para obter mais detalhes e sintaxe.

Ignorando instruções

Mesmo que tenha explicado as suas tabelas e colunas nos comentários e dado instruções gerais, o seu agente pode ainda não estar a usá-las corretamente.

Tente uma ou mais das seguintes estratégias:

• Forneça exemplos de consultas que usam suas tabelas corretamente. Consultas de exemplo são especialmente eficazes para ensinar o seu agente a usar os seus dados.
• Oculte colunas irrelevantes no Genie Agent. Consulte Ocultar ou mostrar colunas relevantes.
• Crie vistas a partir das suas tabelas que fornecem uma vista mais simples dos seus dados.
• Revê as tuas instruções e tenta focar o agente removendo tabelas ou instruções irrelevantes.
• Tente iniciar um novo bate-papo. Interações anteriores podem influenciar as respostas do Genie em qualquer chat, mas iniciar um novo bate-papo oferece um ponto de partida em branco para testar novas instruções.

Problemas de desempenho

Quando o Genie precisa gerar consultas excepcionalmente longas ou respostas de texto, pode levar muito tempo para responder ou até mesmo pode ocorrer um timeout durante a fase de processamento.

Tente uma ou mais das seguintes ações para melhorar o desempenho:

• Verifique o histórico de consultas para identificar consultas que demoram a executar. Muitos problemas de desempenho podem ser resolvidos otimizando as consultas SQL geradas em vez de modificar a configuração do Genie Agent. Revise os tempos de execução das consultas e os planos de consulta no histórico de consultas do seu SQL warehouse para identificar gargalos e oportunidades de otimização.
• Utilize ativos ou visões confiáveis para encapsular consultas complexas. Veja Ativos Confiáveis.
• Reduza o comprimento de suas consultas SQL de exemplo sempre que possível.
• Inicie um novo bate-papo se o Genie começar a gerar respostas lentas ou com falha.

Respostas não confiáveis a perguntas de missão crítica

Use ativos confiáveis para fornecer respostas verificadas a perguntas específicas que você espera que os usuários façam. Veja Ativos Confiáveis.

Aviso de limite de token

Os tokens são as unidades básicas de texto que o Genie usa para processar e entender a linguagem. Instruções de texto e metadados num Agente Genie são convertidos em tokens. Se o seu agente se aproximar do limite dos tokens, aparece um aviso. O Genie usa filtragem de contexto para priorizar os tokens que considera mais relevantes para uma pergunta. Embora as respostas ainda devam ser geradas quando aparece um aviso, a qualidade pode ser reduzida se o contexto importante for filtrado. Quando o limite de tokens é ultrapassado, já não pode enviar ou receber mensagens no Agente Genie.

Considere as seguintes práticas para reduzir a contagem de tokens:

• Remover colunas desnecessárias: colunas desnecessárias em suas tabelas podem contribuir significativamente para o uso de tokens. Quando possível, crie exibições para excluir campos redundantes ou não essenciais de suas tabelas brutas. Também podes esconder colunas desnecessárias num Agente Génio. Consulte Ocultar ou mostrar colunas relevantes.
• Simplifique as descrições das colunas: embora as descrições das colunas sejam importantes, evite duplicar as informações já transmitidas pelos nomes das colunas. Por exemplo, se uma coluna tiver um nome account_name, uma descrição como "o nome da sua conta" pode ser redundante e pode ser omitida.
• Editar metadados de coluna no Agente Genie: Consulte Editar metadados de coluna para aprender como editar descrições e fornecer sinónimos nos metadados das colunas.
• Prune consultas SQL de exemplo: inclua uma gama diversificada de consultas SQL de exemplo para cobrir vários tipos de perguntas, mas remova exemplos sobrepostos ou redundantes.
• Simplifique as instruções: verifique se as instruções são claras e concisas. Evite palavras desnecessárias.

A sua conta não está ativada para processamento geográfico cruzado

O Genie é um Serviço Designado gerenciado pelo Azure Databricks. Os Serviços Designados usam o Databricks Geos para gerenciar a residência de dados. Os dados não podem ser processados na mesma área geográfica que o espaço de trabalho em certas regiões. Se o espaço de trabalho estiver em uma dessas regiões, o processamento geográfico cruzado deverá ser habilitado pelo administrador da conta.

O último autor do agente é removido do espaço de trabalho

Um Agente Genie acede ao seu SQL warehouse usando as credenciais de computação incorporadas pelo autor que o configurou mais recentemente. Se esse autor for removido do espaço de trabalho, as suas credenciais incorporadas deixam de ser válidas e as consultas falham para todos os utilizadores do agente.

Para restaurar o agente, pede a outro utilizador com pelo menos permissão CAN EDIT no Agente Genie para reconfigurar o SQL warehouse do agente. Guardar uma seleção de warehouse incorpora as credenciais de computação do utilizador que está a editar em vez das do autor removido. Veja Configurar definições.