故障排除 Qlik Answers 附带推理跟踪的响应

Last updated: 2026/8/25

推理跟踪显示了 Qlik Answers 为处理问题并生成响应所采取的步骤。查看跟踪有助于您验证是否使用了正确的数据，并在结果不符合预期时确定需要改进的地方。

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

访问推理跟踪

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

理解跟踪结构

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

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

• 应答代理

• 数据分析师代理

• 知识库代理

• 总结代理

应答代理

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

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

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

数据分析师代理

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

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

知识库代理

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

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

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

阅读相似性分数

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

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

解释分数

需要注意什么

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

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

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

• 您的目标字段或主条目是否比竞争字段或主条目具有更高的分数？

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

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

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

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

提升相似度分数

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

更新字段和主条目元数据

执行以下操作：

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

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

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

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

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

   对于主条目，请参阅：

   • 编辑主维度

   • 编辑主度量

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

   • 编辑主维度

   • 编辑主度量

5. 重新加载应用程序。

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

一个名为NETWR的字段，如果没有描述，其得分将显著低于一个名为Net Sales Amount的字段，其描述为"已完成销售交易的总收入，扣除折扣后。"您的元数据越能准确反映自然的业务语言，当用户提出相关问题时，该字段的得分就越高。

解决字段和主条目冲突

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

执行以下操作：

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定位引用的对象，并将其表达式与可见图表进行比较。

参考：代理人及其角色