执行摘要

• 一句话：修复 null parallel_tool_calls 错误截断为单个工具调用
• 推荐动作：值得合并，修复显而易见的行为偏差。建议后续增加测试覆盖 None 情况。也可关注正在进行的 Rust 前端迁移（PR #44760），确保两端一致性。

功能与动机

关联 issue #44948 指出，parallel_tool_calls: null 在 API 中未定义，但默认值为 true，显式 null 应等同于省略该字段。原实现中真值检查导致 None 被误判为 false，截断响应。修复后与 Rust 前端中 unwrap_or(true) 行为对齐。

实现拆解

1. 在 vllm/entrypoints/serve/utils/tool_calls_utils.py 的 maybe_filter_parallel_tool_calls 函数中，将条件判断从 if request.parallel_tool_calls: 改为 if request.parallel_tool_calls is not False:。
2. 同时更新函数文档字符串，从 "Filter to first tool call only when parallel_tool_calls is False." 改为 "Filter to first tool call only when parallel_tool_calls is explicitly False."，明确仅显式 false 时触发过滤。
3. 修改对应变量，属于核心逻辑的语义修复，不影响其他模块。

关键文件：

• vllm/entrypoints/serve/utils/tool_calls_utils.py（模块 前端；类别 source；类型 core-logic）: 修复核心函数 maybe_filter_parallel_tool_calls，该函数根据 parallel_tool_calls 决定是否截断工具调用。

关键符号：maybe_filter_parallel_tool_calls

评论区精华

审查人 bbrowning 在批准时评论：“我同意显式 None/null 应与未提供时的行为一致，即默认允许并行。这是我原实现中的疏忽，感谢修复！”

• 暂无高价值评论线程

风险与影响

• 风险：风险极低。仅修改单行判断逻辑，从真值检查变为显式 is not False，覆盖所有预期输入。无测试配套（但原始行为有误，新增测试应作为后续补充）。不影响其他模块或配置。
• 影响：影响范围局限于 Python 前端中 parallel_tool_calls 字段的过滤行为。对用户而言，显式传入 null 不再错误截断，行为与文档一致。对系统无性能或兼容性影响。
• 风险标记：缺少测试覆盖

关联脉络

• PR #44760 [Rust Frontend] Support parallel_tool_calls = false: 该 PR 在 Rust 前端中实现了相同的 parallel_tool_calls 功能，并使用了 unwrap_or(true) 正确处理 null，本 PR 对齐了 Python 端行为。