Logs de geração de consulta

Cada chamada a um Gerador de consultas e seus resultados são registrados na tabela Log de geração de consultas [sn_query_gen_log].

Usando os logs

Ir para Geração de consulta > Administração > Logs para inspecionar consultas com falha ou incorretas.

1. Encontre a entrada por usuário, data ou enunciado.
2. Verificar Contagem de entidades/dimensões/segmentos semânticos
3. Aberto Saída do constituinte de consulta para ver o que foi selecionado.
4. Compare com Resultado do filtro semântico para correspondências semânticas brutas.

Tabela 1. Explorador de dados de IA guia de solução de problemas

Sintoma	Causa provável	Corrigir
Resposta "Não é possível entender"	O sistema não pode encontrar uma tabela correspondente	Melhorar a descrição da entidade; reformular com o nome da tabela; verificar se a pesquisa com IA está em execução; verificar se todas as origens indexadas estão totalmente processadas.
Tabela incorreta selecionada	Nomes de tabelas semelhantes, sem desambiguação	Adicione instruções de uso semânticas para diferenciar.
Tabela incorreta selecionada (permissões)	O usuário não tem acesso de leitura à tabela ou campos pretendidos.	Verifique e conceda ACLs de leitura de tabela e campo para os dados pretendidos.
Resposta "Erro ao acessar dados da tabela" ou "Acesso ao escopo não concedido"	Alguns dados estão em escopos de aplicações protegidas que Explorador de dados de IA não é possível acessar.	Crie ACLs que concedem acesso ao escopo para Explorador de dados de IA. Aprove os registros de acesso restrito do chamador (RCA) gerados subsequentemente. Para obter mais informações, consulte Habilitando o acesso a aplicações de escopo protegidas para Explorador de dados de IA e. Geração de consultas.
Campo ausente nos resultados	Dimensão desativada, rótulo pouco claro ou campo fora da camada semântica	Verifique se a dimensão está ativa; atualize o rótulo.
Campos relacionados não extraídos	Tabela referenciada ausente na camada semântica ou dimensão de referência desativada	Adicione e habilite a entidade de tabela referenciada; habilite a dimensão de referência.
Filtro incorreto aplicado	Correspondência de segmento incorreta	Corrija o nome e a descrição do segmento; desabilite o segmento.
Nenhum filtro quando esperado	Nenhum segmento correspondente; fraseado muito vago	Crie um segmento manual; reformule a pergunta.
O segmento do relatório está incorreto	O segmento gerado automaticamente tem filtro obsoleto ou irrelevante	Desabilite a origem do segmento de relatório ou o segmento específico.

Tabela 2. Colunas de log de geração de consulta

Coluna	Descrição	Mostrado por padrão?
Criação em	Carimbo de data/hora da chamada para Geração de consultas	Sim
Usuário	O usuário da tabela Usuário [sys_user] que fez a chamada. Se estiver em branco, tente Criado por.	Sim
Enunciado	A pergunta em linguagem simples feita pelo usuário	Sim
Status	O sucesso ou não da chamada	Sim
Mensagem de erro	Se o status for "erro", esta será a mensagem de erro retornada ao usuário.	Sim
Tempo total	Tempo em milissegundos que a IA levou para processar a consulta e retornar a resposta	Sim
Tempo "X"	Tempo em milissegundos que cada componente X gastou processando a consulta	Sim
Resultados do filtro semântico	Campos nas tabelas de camadas semânticas referenciadas pela consulta, em JSON	Sim
Resultados do banco de enunciados	Perguntas semelhantes à pergunta do usuário (enunciado) encontradas no banco de enunciados e usadas para interpretar a pergunta do usuário em JSON	Sim
Resposta	A resposta JSON à consulta	Sim
Entidades	Os registros na tabela Entidades que são referenciados pela consulta. Cada registro corresponde a uma tabela de fatos.	Sim
Saída do constituinte de consulta	JSON da consulta gerada	Sim
Origem	A aplicação a partir da qual a pergunta foi feita. Se a pergunta foi feita a partir de Now Assist Quando ele estava aberto em uma página que não faz parte de uma aplicação, o UUID dessa página é mostrado.	Sim
Resposta	A resposta que o LLM retorna	Sim
Log de IA generativa	O LLM usado para a consulta	Sim
Conversa	ID de conversa de bate-papo exclusivo, como em um painel do Now Assist para conversa de geração de consulta	Sim
Hora da ACL	Tempo necessário para validar o acesso ou a segurança do usuário para a tabela subjacente	Não
Informação adicional	Hora de início, total de chamadas e outros metadados sobre Pesquisa com IA executar	Não
Criada por	Pessoa que criou a consulta. . ServiceNow® membros da equipe conectados como manut.	Não
Domínio	Domínio no qual a consulta foi criada	Não
Ponto caminhado	Se a consulta incluiu pontos andando entre tabelas (verdadeiro/falso)	Não
A entidade tem pontuação de uso	Se a entidade tem uma pontuação de uso (verdadeiro/falso)	Não
Origem da entidade	Se a origem estava em ENTIDADES, SENTIDO DO USUÁRIO ou SEGMENTOS	Não
Código de erro	O código de erro, se houver um erro	Não
Acompanhamento gerado	O número de perguntas de acompanhamento que o LLM gerou em resposta à consulta	Não
Acompanhamento retornado	Quantas das perguntas de acompanhamento geradas são realmente retornadas. As perguntas devem se referir a tabelas que o usuário solicitante pode acessar e que estão na camada semântica, por exemplo.	Não
Tempo do LLM	Tempo gasto pelo modelo de linguagem grande (LLM) na consulta	Não
Tempo do construtor de consulta	Tempo gasto pelo construtor de consulta na consulta	Não
Tempo de RAG	Tempo gasto pela geração de recuperação aumentada (RAG) na consulta	Não
Contagem de dimensões semânticas	Número de registros de tabela (dimensões) examinados para a consulta	Não
Contagem de entidades semânticas	Número de tabelas (entidades) examinadas para a consulta	Não
Resultados do filtro semântico	Resultados da execução do filtro semântico	Não
Tempo do filtro semântico	Tempo gasto pelo filtro semântico	Não
Contagem de segmentos semânticos	Número de segmentos examinados para a consulta	Não
Tabela de fonte	Nome da tabela correspondente ao ID de origem	Não
Marcadores	Quaisquer marcadores que você adicionar ao log	Não
Atualização em	Carimbo de data em que a entrada de log foi atualizada pela última vez	Não
Atualização de	Usuário responsável pela última atualização de entrada de log	Não
Atualizações	Contagem de atualizações na entrada de log	Não
Resultados do banco de enunciados	Exemplos semelhantes extraídos do banco de enunciados	Não
Tempo do banco de enunciados	Tempo gasto pesquisando o banco de enunciados	Não

Conceitos relacionados

• Comum Explorador de dados de IA problemas e correções