ASP.NET Extensions 项目中 AI 评估模块的指标名称转换问题解析

问题背景

在 ASP.NET Extensions 项目的 AI 评估模块中，开发团队最近发现了一个关于评估指标名称处理的回归性问题。这个问题出现在 Azure AI Foundry 评估服务与安全库(Safety library)之间的指标名称转换过程中。

问题本质

核心问题在于评估服务返回的指标名称与安全库中使用的名称不一致。评估服务返回的原始指标名称较为技术化，而安全库需要更友好、更易显示的指标名称。虽然系统已经对返回的指标进行了名称转换，但在内部存储时仍保留了原始名称，这导致了后续获取特定指标时出现异常。

具体表现为：当尝试使用 ViolenceEvaluator.ViolenceMetricName 这个名称获取暴力评估指标时，系统会抛出异常，因为这个名称在内部字典中并不存在，实际存储的是服务返回的原始名称。

技术细节

评估系统的工作流程大致如下：

1. Azure AI Foundry 评估服务执行评估并返回结果
2. 系统接收到包含评估指标的响应
3. 对指标名称进行转换（从技术名称转为友好名称）
4. 将转换后的指标返回给调用方

问题出在第三步和第四步之间：虽然指标对象的名称属性被正确更新，但存储这些指标的字典仍使用原始名称作为键。这导致了名称转换在表面层完成，但底层存储未同步更新。

解决方案

修复方案相对直接：在名称转换过程中，不仅要更新指标对象的名称属性，还需要同步更新字典中的键名。具体需要：

1. 遍历所有评估指标
2. 对每个指标执行名称转换
3. 使用转换后的名称作为字典键存储指标
4. 确保指标对象的名称属性与字典键一致

这种修改保持了系统的前后一致性，确保无论通过哪种方式访问指标（直接通过字典或通过辅助方法），都能获得预期的结果。

影响范围

这个问题主要影响以下场景：

• 使用安全库中预定义的指标名称常量（如 ViolenceEvaluator.ViolenceMetricName）获取评估结果
• 依赖于指标名称一致性的自动化测试或验证流程
• 需要精确匹配特定指标名称的监控或报警系统

最佳实践建议

为避免类似问题，建议在类似名称转换场景中：

1. 实现集中式的名称转换机制，避免分散处理
2. 对输入和输出名称进行严格的单元测试
3. 考虑使用不可变数据结构来防止意外修改
4. 在关键位置添加断言，验证名称一致性
5. 建立名称映射的文档，明确每个技术名称对应的友好名称

总结

这个问题的发现和解决过程展示了在复杂系统中维护数据一致性的重要性。特别是在涉及多层名称转换的场景中，需要确保所有层面的数据表示都同步更新。ASP.NET Extensions 团队通过及时识别和修复这个问题，提高了 AI 评估模块的可靠性和用户体验。