执行摘要

本次PR向FastDeploy的OpenAI兼容协议中添加了strict字段，支持函数调用的严格模式。变更仅涉及protocol.py中FunctionDefinition类的一个字段添加，经过讨论优化为Optional[bool] = None以确保向后兼容性。这是一个低风险、影响有限的API扩展，主要价值在于对齐OpenAI官方规范。

功能与动机

根据review讨论，本次变更的目的是"向OpenAI Function Calling API规范对齐，支持strict模式，用于强制模型遵循工具参数的schema定义"。fastdeploy-bot在review中明确提到"支持OpenAI API中Function Calling的严格模式（strict mode），确保模型生成的JSON输出严格遵循参数定义的JSON Schema"，并参考了OpenAI官方文档。这增强了FastDeploy在函数调用场景下的控制能力。

实现拆解

实现非常简单，仅在fastdeploy/entrypoints/openai/protocol.py文件的FunctionDefinition类中添加了一个字段：

class FunctionDefinition(BaseModel):
    name: str
    description: Optional[str] = None
    parameters: Optional[dict[str, Any]] = None
    strict: Optional[bool] = None # 新增字段

关键设计决策：

1. 字段类型：从最初的bool = False改为Optional[bool] = None
2. 兼容性考虑：使用Optional确保未显式指定时不会序列化该字段，保持与现有请求负载的一致性
3. 对齐参考：与同文件中的JsonSchemaResponseFormat.strict字段保持相同设计模式

评论区精华

review讨论主要集中在两个技术点上：

Copilot："这里把strict设为bool = False会导致在model_dump()时，总是把strict: false序列化并透传到engine/request，从而改变未显式指定strict的请求负载。为保持与现有行为/文档示例一致，建议将其改为Optional[bool] = None"

fastdeploy-bot："建议添加单元测试验证strict字段的序列化/反序列化行为，确保与JsonSchemaResponseFormat.strict行为一致"

最终采纳了Copilot的建议，将字段改为Optional[bool] = None，但测试建议未被立即实施。

风险与影响

风险分析：

1. 兼容性风险：低。字段为Optional且默认None，未指定时不序列化，完全向后兼容。
2. 序列化风险：已解决。最初设计可能意外添加strict: false到所有请求，优化后避免了此问题。
3. 测试风险：中等。缺少针对新字段的单元测试，可能影响未来重构信心。

影响评估：

• 用户影响：为需要严格模式函数调用的用户提供了官方支持
• 系统影响：仅扩展API协议定义，不改变核心推理逻辑
• 团队影响：变更简单，易于维护和理解

关联脉络

从近期历史PR看，FastDeploy持续增强其OpenAI兼容API能力：

• PR #7352 在api_server.py中添加了IP白名单检查，增强安全性
• 本次PR #7307 在protocol.py中扩展协议支持

这两次变更都集中在fastdeploy/entrypoints/openai/目录下，体现了团队对API层完整性和规范对齐的持续投入。与OpenAI官方规范保持同步有助于提升FastDeploy作为推理服务的兼容性和易用性。