Azure SDK for Python中Bing搜索API请求格式异常问题解析

在Azure SDK for Python的AI推理模块使用过程中，开发者发现了一个关于Bing搜索API请求格式的特殊情况。本文将深入分析该问题的技术背景、产生原因以及解决方案。

问题现象

当开发者使用azure-ai-inference和azure-ai-projects模块时，系统生成的Bing搜索API请求URL出现了以下两个异常特征：

1. 查询字符串中存在格式错误，包含不匹配的引号和括号
2. 使用了非标准的参数recency_days

技术分析

经过Azure AI Agent服务团队的调查，确认了以下技术细节：

1. 日志显示与实际请求的差异
   虽然运行步骤(run_steps)响应中显示的请求URI格式存在问题，但实际发送给Bing API的查询是正确的。日志中的格式问题仅存在于展示层面，不影响实际功能。

2. recency_days参数的来源
   该参数是系统内部通过提示(prompt)自动添加的，原本设计用于控制搜索结果的时效性。在后台实现中，系统会将recency_days转换为Bing API支持的freshness参数。

解决方案与改进

服务团队已经采取了以下改进措施：

1. 参数标准化
   即将发布的更新将移除自动生成的recency_days参数，避免造成开发者困惑。

2. 未来功能增强
   计划在后续版本中，允许用户在工具配置级别自定义freshness参数，提供更灵活的搜索控制能力。

影响范围与时间线

该修复预计在报告后两周内完成生产环境部署，主要影响以下模块版本：

• azure-ai-inference 1.0.0b9
• azure-ai-projects 1.0.0b7

开发者建议

对于遇到类似问题的开发者，建议：

1. 关注官方更新通知
2. 不必过度担心当前日志中的格式显示问题
3. 如需精确控制搜索结果时效性，可等待后续支持freshness参数配置的版本发布

该问题的解决体现了Azure SDK团队对开发者反馈的快速响应能力，也展示了其持续优化开发者体验的承诺。