故障排除 Qlik Answers 响应以及推理跟踪

上次更新日期：2026/9/16

推理跟踪显示了 Qlik Answers 为处理问题并生成响应所采取的步骤。审查跟踪有助于您验证使用了正确的数据，并在答案不符合您的预期时确定在何处进行改进。

对于Qlik Answers用户，它可以帮助您验证问题或引导您提出关注问题。对于内容所有者，例如助手和应用程序，它可以帮助您验证应用程序数据或知识库是否按预期提供答案，或者是否需要进行改进

访问推理轨迹

在 Qlik Answers 返回响应后，点击答案下方的 查看来源，然后点击 显示推理。跟踪展开以显示管道执行的每个步骤。

理解跟踪结构

推理跟踪是运行的代理以及它们所做的决策的日志。所涉及的代理以及每个代理运行的次数，取决于所提出的问题以及应用程序中配置的数据源。轨迹不关注固定的序列。一个简单的问题可能涉及较少的代理，而一个复杂的多部分问题可能会在生成最终响应之前多次调用同一个代理。

以下代理可能会出现在跟踪中：

• 应答代理

• 数据分析师代理

• 知识库代理

• 摘要智能体

应答代理

Answers 代理在每个跟踪的始末出现。一开始，它会读取问题，确定需要哪些数据源，并将工作分配给相应的专业代理。最后，它将子结果组装成显示给用户的最终响应。

开头的 Answers Agent 块描述了代理对问题的理解。

验证主体和任何实体是否已正确识别。如果代理在此阶段误读了问题，下游的专业代理将根据错误的上下文进行查询。

数据分析师代理

数据分析师代理处理涉及结构化数据的问题。它在数据模型中搜索相关字段和度量，构建计算表达式，并创建响应中出现的图表对象。

对于复杂问题，数据分析师代理可能会在跟踪中多次出现。例如，它可能会运行第一遍来发现字段，运行第二遍来验证数据中是否存在特定值，以及运行第三遍来构建可视化。

知识库代理

知识库代理处理涉及非结构化内容的问题，例如内部文档、会议记录、备忘录或PDF文件，这些文件作为知识库数据源连接到您的应用程序。

当一个问题既需要结构化数据又需要非结构化数据时，答案代理会将工作路由给知识库代理和数据分析师代理。每个代理独立返回其结果，答案代理在最终响应中将它们组合。

如果用户提出的问题明确引用了某个文档或会议，并且知识库代理未出现在跟踪中，请验证知识库数据源是否已连接到您的应用程序，并且内容已编入索引。

解读相似度分数

任何追踪中最重要的部分是数据分析代理内部的字段发现输出。本部分列出了代理考虑的每个字段和主条目，以及每个的相似度分数。

相似度分数表示语义搜索将某个字段或主条目与用户问题匹配的程度。代理使用得分最高的字段和主项来构建响应。如果列表中缺少您预期会使用的字段或主条目，或者该字段或主条目存在但得分低于竞争字段或主条目，则答案很可能是使用与您预期不同的数据构建的。

解释分数

需要注意什么

在审阅字段和主条目列表时，请检查以下内容：

• 您预期的字段或主条目是否存在？

  如果它完全缺失，该字段或主条目的标签和描述可能与问题中使用的语言不匹配。

• 您预期的字段或主条目是否比竞争字段或主条目得分更高？

  如果不同的字段或主条目得分更高并被使用，答案可能看起来正确，但却是从错误的数据中提取的。

• 列表中是否有不应该存在的字段或主项？

  一个得分异常高的字段或主条目，可能会将焦点从正确的字段或主条目上转移。

对回答用户问题最重要的字段和主项，应该始终比代理可能会混淆的任何其他字段和主项得分更高。

提升相似度分数

相似度分数根据字段和主条目名称、描述和元数据计算得出。改进这些会直接提高相关问题的分数。

更新字段和主条目元数据

执行以下操作：

1. 在您的应用程序中，打开数据管理器或数据加载编辑器。

2. 找到字段或主条目，其相似度得分低或缺失。

3. 更新字段或主条目名称，以使用通俗的业务语言，反映用户将如何询问它。

   有关 数据管理器，请参阅 编辑表格

   有关 数据加载编辑器，请参阅 重命名字段。

   对于主条目，请参阅：

   • 编辑主维度

   • 编辑主度量

4. 添加或扩展主条目描述，以明确说明主条目包含什么、它代表什么业务概念以及何时应使用它。请参阅：

   • 编辑主维度

   • 编辑主度量

5. 重新加载应用程序。

6. 再次提出相同的问题，并打开推理轨迹以验证分数是否有所提高。

一个名为NETWR且没有描述的字段，其得分将显著低于一个名为净销售额且描述为“已完成销售交易的总收入，已扣除折扣。”的字段。您的元数据越贴近自然的业务语言，当用户提出相关问题时，该字段的得分就越高。

解决字段和主条目冲突

当两个字段或主项涵盖相似概念并竞争同一查询时，代理会选择得分较高的一个。如果使用了错误的字段或主条目，您应该修改它。

执行以下操作：

1. 查看这两个字段或主项的元数据。

2. 使预期的字段或主条目的名称和描述更具体，并更直接地与用户正在搜索的业务术语保持一致。

   对于字段名称：

   有关 数据管理器，请参阅 编辑表格

   有关 数据加载编辑器，请参阅 重命名字段。

   对于主项目，编辑名称或描述。请参阅：

   • 编辑主维度

   • 编辑主度量

3. 如果竞争字段或主条目相关性较低，请更新其名称或描述，以更准确地反映其实际范围，从而在不相关的查询中得分较低。

诊断错误或不完整的答案

当 Qlik Answers 的响应与您预期不符时，请参考以下指南。

答案使用了错误的字段或主条目

执行以下操作：

1. 打开推理跟踪，并在数据分析师代理中找到字段发现输出。

2. 查找所使用的字段或主条目并记下其相似度分数。

3. 查找您预期使用的字段或主条目。如果它在列表中，请将其分数与所选字段或主条目进行比较。

4. 如果您的目标字段或主条目得分较低，请更新其名称或描述，以提高其与问题的相关性。

   对于主物料，编辑描述。请参阅：

   • 编辑主维度

   • 编辑主度量

5. 如果您的目标字段或主条目根本不在列表中，请检查其名称和描述。它很可能用技术术语来描述，而这些术语与用户提问的方式不匹配。

某个字段或主条目完全从列表中缺失

执行以下操作：

1. 打开跟踪中的字段发现输出。

2. 确认字段或主条目存在于数据模型中。

3. 如果您正在使用业务逻辑逻辑模型，请确认字段或主条目未被取消分组。

4. 查看字段或主条目的名称和描述。

   如果两者中任何一个缺失或使用内部命名约定（例如，字段的SAP字段代码），请添加一个通俗易懂的名称和描述。

   请参阅：

   • 编辑主维度

   • 编辑主度量

5. 重新加载应用程序并重新运行问题，以验证字段或主条目现在是否出现在跟踪中。

答案是正确的，但不完整

数据分析师代理的规划输出描述了构建了哪些图表以及选择了哪些维度。如果某个维度或度量缺失于计划的图表，其相似性得分可能高到足以出现在字段和主条目列表中，但低于图表选择的阈值。改进相关字段或主条目元数据将使其高于选择阈值。

叙述和图表显示不同的数字

Answers Agent 的最终综合包括括号中的证据 ID，这些 ID 将文本中的每个主张链接到其来源的图表对象。例如：

Brand 1 sold 24 vehicles generating total revenue of $1,584,041.82 [d1f09de1-4a5a...]

如果文本中的数字与图表不匹配，则合成引用了与显示内容不同的图表对象。使用ID定位引用的对象，并将其表达式与可见图表进行比较。

参考：代理及其角色