我明白你遇到的这个问题有多头疼——明明按照文档要求把parallel_tool_calls设成了False，结果模型还是一次触发了两个工具调用。结合你的代码、提问和日志，我梳理了几个可能的原因和对应的解决思路：

1. 模型兼容层不支持该参数 #

你当前使用的是Gemini 2.0 Flash，通过OpenAI SDK的兼容接口调用。但parallel_tool_calls是OpenAI原生模型的专属控制参数，Gemini的OpenAI兼容层很可能没有实现对这个参数的解析和约束逻辑。Gemini自身的工具调用并行/串行控制，可能有一套独立的配置方式，而非通过这个OpenAI风格的参数生效。

2. 验证参数是否真正传递到底层API #

你可以尝试排查OpenAI Agents SDK是否真的将parallel_tool_calls=False传递给了底层的API请求：

• 开启更详细的日志，查看实际发送给Gemini服务的请求payload，确认这个参数是否被正确包含其中；
• 暂时绕开Agents SDK的封装，直接用AsyncOpenAI调用chat.completions.create，手动传入parallel_tool_calls=False和相同的工具、提问内容，测试Gemini是否会遵守串行调用的要求。

如果直接调用也不生效，基本可以确定是兼容层不支持该参数，这时候需要：

• 改用OpenAI原生模型（比如gpt-3.5-turbo、gpt-4o等）来测试parallel_tool_calls参数的有效性；
• 查阅Gemini官方文档，找到它自身控制工具调用串行/并行的配置方法。

3. 尝试分步引导的Prompt Workaround #

如果暂时无法解决参数兼容问题，你可以通过调整提问内容，明确引导模型分步处理：

input="先调用fetch_user_uid获取用户UID，拿到结果后再调用fetch_weather查询卡拉奇的天气"

这种方式虽然是临时的变通方案，但能先满足你串行调用工具的需求。

4. 检查并升级OpenAI Agents SDK版本 #

有可能是你使用的SDK版本存在bug，导致parallel_tool_calls设置未被正确处理。尝试升级到最新版本的OpenAI Agents SDK：

pip install --upgrade openai openai-agents

然后重新测试问题是否修复。

内容来源于stack exchange