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

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

2025-06-10 23:22:05作者:钟日瑜

在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团队对开发者反馈的快速响应能力,也展示了其持续优化开发者体验的承诺。

登录后查看全文
热门项目推荐
相关项目推荐