Azure SDK for Python 中AI评估模块的认证方式变更解析

背景介绍

在Azure SDK for Python的azure-ai-evaluation模块1.5.0版本中，用户在使用AI质量评估功能时遇到了认证方式变更的问题。该问题主要影响那些使用Entra ID(原Azure AD)进行身份验证而非API密钥的用户场景。

问题现象

当用户升级到1.5.0版本后，使用Relevance Evaluator等AI质量评估器时，系统会报错提示缺少API密钥，即使配置中已经正确设置了Azure终端点、部署名称和API版本。错误信息明确指出："The following required fields are missing for connection azure_openai: api_key"。

技术分析

认证机制变更

在1.3.0版本中，azure-ai-evaluation模块支持多种认证方式，包括Entra ID身份验证。但从1.4.0或1.5.0版本开始，模块内部对认证机制进行了调整，强制要求提供API密钥，这导致仅配置Entra ID认证的用户无法正常使用评估功能。

影响范围

这一问题影响所有需要无密钥(credential-free)访问的场景，特别是那些企业安全策略禁止使用API密钥的环境。用户反馈表明，相似性评估器(SimilarityEvaluator)等组件都会受到影响。

解决方案

微软开发团队在1.6.0版本中修复了这一问题，重新支持Entra ID认证方式。用户可以通过以下方式解决：

1. 升级到azure-ai-evaluation 1.6.0或更高版本
2. 确保认证配置包含必要的Azure终端点和部署信息
3. 无需再强制提供API密钥参数

最佳实践建议

对于企业用户，特别是那些有严格安全要求的场景，建议：

1. 定期检查SDK更新日志，了解认证机制变更
2. 在测试环境中验证新版本功能后再进行生产部署
3. 考虑使用Azure托管身份等更安全的认证方式
4. 保持与官方支持渠道的沟通，及时报告兼容性问题

总结

这一变更反映了云服务安全认证机制的演进过程。微软通过快速响应社区反馈，在后续版本中恢复了多认证方式支持，体现了对用户多样化需求的重视。开发者应当关注此类变更，确保应用兼容性和安全性。