处理反馈
本文说明 Analytics Agent 中业务用户反馈如何提交、如何在管理侧集中查看，以及维护者如何根据反馈改进问答准确性。
反馈不是简单的"点赞/点踩"。在企业场景中，反馈是连接业务用户、BI 分析师、语义层维护者和管理员的重要闭环，可以帮助团队发现字段歧义、指标口径错误、知识缺失、图表不准确、权限配置不合理等问题。
适用对象
业务用户在发现答案不准或图表不对时提交反馈；BI 分析师根据反馈改进问题设计、看板和图表；语义层维护者根据反馈修正字段语义、指标、知识和答案构建器；管理员在管理侧查看反馈，推动问题分派和治理。
反馈入口
答案旁边的即时反馈。 问答答案右侧有反馈图标。点击正向反馈后，页面提示"做的不错，鼓励一下"；点击另一个反馈入口后，页面提示"提交校准反馈"。业务用户可以通过这个入口表达答案有帮助、答案不准确、图表显示错误、指标口径不对或系统理解错了问题。
管理菜单下的反馈。 左侧导航中展开"管理"可以看到"反馈"菜单（路径：
管理 > 反馈/dataai/feedback业务用户如何提交有效反馈
反馈越具体，维护者越容易定位问题。业务用户不需要判断 SQL、字段或配置哪里错，只需要说明业务上哪里不对。推荐包含原始问题、错误类型、你认为哪里错、正确口径或期望结果、是否影响图表或数值，以及正确示例（如果知道的话）。
不推荐：
答案错了推荐：
这个问题的图表不对。Top 10 应该按成就数倒序，但当前图表看起来没有按成就数排序。常见反馈类型
分析不准确。 数值和业务系统不一致、趋势方向不符合实际、排名结果明显不对、返回了无关对象。可能原因包括字段语义不清、指标口径未配置、知识没有命中、SQL 过滤条件错误、分析域内表太多导致系统误选表。处理方向（由 BI 分析师、语义层维护者或管理员执行）：查看 SQL 语句和记录，检查字段语义、指标和答案构建器，必要时补充知识。
图表显示错误。 图表类型不适合问题、排序不符合预期、图表和表格不一致、图表维度或指标选错。可能原因包括问题没有指定输出方式、系统自动选择图表不符合业务预期、指标字段或维度字段配置不清晰。处理方向（由 BI 分析师或语义层维护者执行）：在问题中指定图表类型，优化答案构建器输出字段名称，在推荐问题中沉淀标准问法，必要时保存正确图表到看板。
口径错误。 活跃用户、收入、转化率等指标定义不符合业务口径，分母或分子选错，是否去重不符合预期。可能原因包括指标未配置、知识中没有口径说明、同名字段太多、不同部门使用不同口径。处理方向（由语义层维护者执行）：补充指标配置和知识，在字段语义中写清业务含义，将冲突口径拆到不同分析域。
字段误选。 系统用了相似但错误的字段，多张表里存在同名字段系统选错，业务词映射到错误字段。可能原因包括字段名称相似、字段语义缺失、字段用途配置不清、不该暴露的字段未隐藏。处理方向（由语义层维护者执行）：补充字段语义、别名和描述，对容易误用的字段设置隐藏，将字段用途配置为更准确的类型。
权限或数据范围问题。 用户看不到预期数据、用户看到的数据范围和同事不一致、明细类问题返回结果少于预期。可能原因包括分析域权限不同、行级权限生效、列隐藏生效、用户角色授权不同。处理方向（由管理员或权限维护者执行）：检查分析域访问权限、角色授权、行级权限和列隐藏配置。
反馈处理流程
建议建立以下闭环：业务用户在答案旁边提交反馈 → 管理员在管理 > 反馈中查看，按提问词、创建人、时间和描述判断问题类型 → 分派给 BI 分析师、语义层维护者或管理员 → 查看原问题的 SQL 语句和记录 → 修改字段语义、指标、知识、答案构建器、推荐问题或权限配置 → 用原始问题重新验证 → 如果问题具有普遍性，沉淀为推荐问题、看板或排查案例。
不同角色如何处理反馈
业务用户负责说明答案哪里不符合业务认知、提供正确口径或参考结果、重新验证修复后的答案。
BI 分析师负责判断问题是否是问法不清、优化推荐问题、调整看板图表、把高频问题沉淀为看板或标准分析问题。
语义层维护者负责修正字段语义、配置指标、配置答案构建器、补充知识、排查 SQL 和记录。
管理员负责查看反馈列表、分派问题、检查权限和审计、推动治理闭环。
反馈和配置项的对应关系
| 反馈现象 | 优先检查 |
|---|---|
| 字段选错 | 字段语义、字段别名、字段用途、列隐藏 |
| 指标算错 | 指标配置、答案构建器、知识口径 |
| 图表不对 | 输出字段名称、图表类型、排序、答案构建器 |
| 表选错 | 分析域表范围、表描述、表关系 |
| 数据范围不对 | 分析域权限、角色授权、行级权限 |
| 解释不符合业务 | 知识配置、推荐问题、答案构建器描述 |
| 问题经常被误解 | 推荐问题、字段语义、知识、分析域边界 |
反馈处理优先级
P0：涉及权限越权或敏感数据暴露、核心经营指标明显错误、共享看板中关键图表错误。
P1：高频问题回答不稳定、重要部门反馈口径错误、图表显示错误影响理解、字段误选导致结论偏差。
P2：个别临时问题表达不清、图表类型不够理想但数据正确、解释文字不够业务化、推荐问题需要优化。
如何验证反馈已修复
修复后不要只看配置页面是否保存成功，建议重新运行原始问题并完成以下验证：重新提出原问题 → 查看最终答案 → 业务用户确认是否符合业务认知 → BI 分析师或维护者查看 SQL 语句和记录 → 对比修复前后的结果 → 让提交反馈的业务用户确认 → 如果影响看板，进入看板查看图表是否刷新正确。
与审计日志的关系
反馈告诉你"用户认为哪里不对"，审计日志告诉你"谁在什么时候做了什么操作"。当反馈涉及权限、配置变更或看板变化时，应结合审计日志排查是否有人修改了分析域、调整了角色或授权、修改了数据源、调整了看板。反馈和审计日志结合，才能形成完整治理闭环。