执行摘要
此 PR 是 #28448 的纯文档修复,修正了 GLM-5.2 cookbook 中思考开关的错误参数名(thinking → enable_thinking),并补充了推理力度参数 reasoning_effort 的行为文档。只改了 1 个文件,安全无风险。
功能与动机
PR #28454 由作者 JustinTong0323 在合并 #28448 后立即提出,原因是 #28448 中 cookbook 文档使用了错误的 chat template 参数名 thinking,而实际应为 enable_thinking。经渲染 chat_template.jinja 验证,{"thinking": False} 不会关闭思考模式,只有 {"enable_thinking": False} 才生效。同时 PR 补充了 reasoning_effort 的文档,因为其行为(仅两个有效级别、默认最高)容易让人困惑。
实现拆解
- 修正参数名:在
GLM-5.2.mdx 的文字说明和 Python 示例中,将 chat_template_kwargs: {"thinking": False} 改为 {"enable_thinking": False},并注明变量名是 enable_thinking 而非 thinking。
- 新增 reasoning_effort 表格:清晰列出不传参数、
"high"、其他值三种情况对应的系统提示行和实际效果,强调 Max 是默认最高推理力度,"high" 是唯一降低力度的值。
- 更新 Python 示例:在示例中将
extra_body 改为同时使用 enable_thinking: True 和 reasoning_effort: "high",展示正确用法。
评论区精华
无 review 评论。审核者 zijiexia 直接批准。
风险与影响
风险:极低,仅文档文字改动,无代码变更。
影响:修复了可能误导用户的错误参数名,帮助用户正确配置模型推理。
关联脉络
此 PR 是 #28448 的微调修复,进一步提升了 GLM-5.2 cookbook 的准确性和可用性。
参与讨论