Use dicionários de valores para melhorar a precisão do Genie
Visualização
Esse recurso está em Public Preview.
Esta página explica como aumentar a precisão em um espaço do Genie adicionando dicionários de valor. Os dicionários de valores permitem que o Genie faça a correspondência entre os valores no prompt de um usuário e os valores reais nos dados, de modo que ele possa gerar consultas SQL que correspondam à intenção do usuário.
Visão geral
Quando um usuário faz uma pergunta no Genie, a frase geralmente é coloquial e pode incluir erros, como erros de ortografia. Nesses casos, os valores no prompt podem não corresponder à estrutura ou aos valores nos dados. Isso pode fazer com que o Genie interprete mal a pergunta e gere um SQL incorreto.
Por exemplo, um usuário pode perguntar:
"Mostre-me ventas de carros na Flórida para o Q1."
Se o uso de dados indicar abreviações (como FL
) e não houver um dicionário de valores para essa coluna, Genie poderá gerar SQL que inclui ILIKE '%Florida%'
, que não retorna nenhum resultado.
A adição de um dicionário de valores à coluna state
permite que o Genie acesse valores representativos. Com esse contexto, o Genie pode reconhecer que FL
corresponde a "Florida" e gerar um SQL mais preciso.
Sem dicionário de valores | Com dicionário de valores |
---|---|
|
|
Os dicionários de valores ajudam o Genie a retornar resultados corretos, melhorando sua capacidade de gerar SQL preciso.
Requisitos
- Genie spaces deve ser ativado. Consulte Configurar e gerenciar um espaço AI/BI Genie.
- O workspace administrador do site deve ativar a visualização na página Previews, ativando a configuração Genie Data Sampling (Amostragem de dados ). Isso permite que os autores do espaço Genie usem dicionários de valores.
Escolha colunas
Em default, a configuração Use sample values from these tables to improve accuracy é ativada quando o senhor cria um espaço. Quando essa configuração está ativada, o Genie cria automaticamente dicionários de valores para colunas elegíveis à medida que o senhor adiciona tabelas ao espaço. Se o número de dicionários de valores atingir o limite do espaço, você poderá ajustar manualmente quais colunas serão selecionadas após adicionar novas tabelas.
Os usuários com privilégios de pelo menos CAN EDIT podem definir quais colunas incluem dicionários de valores. Para obter instruções, consulte Selecionar colunas manualmente.
Durante a visualização pública, um espaço Genie suporta dicionários de valores em até 30 colunas. Cada dicionário pode incluir até 255 valores distintos, com cada valor truncado em 127 caracteres. Se uma coluna ou linha exceder esses limites, somente um subconjunto de valores será armazenado. Ao adicionar dicionários de valores a um grupo de tabelas selecionadas, se houver mais de 30 colunas de strings elegíveis, o Genie seleciona um subconjunto automaticamente. O senhor pode gerenciar manualmente quais colunas são adicionadas como dicionários de valores. Consulte Selecionar colunas manualmente.
Selecionar colunas manualmente
Escolha colunas de strings que forneçam contexto prático ao Genie ao interpretar os prompts, especialmente colunas com valores categóricos ou formatados de forma consistente. Evite texto livre ou conteúdo não estruturado, como IDs de usuário, nomes ou avaliações.
Os dicionários de valores são armazenados no bucket de armazenamento do site workspace.
Para definir quais colunas de cadeias de caracteres incluem um dicionário de valores:
- Clique em Configure > Data em seu espaço Genie.
- Clique no nome de uma tabela para acessar view suas colunas.
- Clique em Adicionar dicionário de valores ao lado da coluna que você deseja incluir.
- Use o menu
kebab para refresh ou remover um dicionário. Consulte atualizar ou remover dicionários de valores.
Para cancelar uma operação em andamento, clique no menu kebab ao lado da mensagem Adding value dictionary (Adicionando dicionário de valores ).
Se as operações falharem, clique em Adding value dictionary failed to retry.
Atualizar ou remover dicionários de valores
A atualização de um dicionário atualiza seus valores armazenados. Atualizar o dicionário de valores se:
- Novos valores foram adicionados à coluna.
- O formato dos valores existentes foi alterado.
Para refresh ou remover um dicionário de valores, clique no menu kebab e escolha uma das seguintes opções:
- atualizar o dicionário de valores para atualizar os valores armazenados.
- Remova o dicionário de valores para excluir os valores armazenados dessa coluna.
Como o Genie usa os dicionários de valores
O Genie usa seu prompt, metadados e valores de tabela relevantes, erros, bem como código de entrada ou consultas ao gerar uma resposta. Se o Genie usar uma coluna com um dicionário de valores, os valores armazenados o ajudarão a interpretar os prompts com mais precisão e a gerar um SQL melhor. Os dicionários de valores aumentam a precisão do Genie, mas funcionam melhor com instruções claras e consultas de exemplo. Para obter mais orientações, consulte Organizar um espaço Genie eficaz.