Prhub

#28454 docs(cookbook): fix GLM-5.2 thinking toggle kwarg + document reasoning effort

原始 PR 作者 JustinTong0323 合并时间 2026-06-17 02:17 文件变更 1 提交数 1 评论 1 代码增减 +10 / -2

执行摘要

修复 GLM-5.2 cookbook 思考开关参数名并补充推理力度文档

PR #28454 是 #28448 的后续修复。原始 cookbook 错误地将 thinking 用作开关变量,但 chat template 实际使用的是 enable_thinking,导致用户无法正确关闭思考模式。PR body 中明确说明,经渲染 chat_template.jinja 验证,{"thinking": False} 无效,只有 {"enable_thinking": False} 才能禁用思考。同时补充了 reasoning_effort 的文档,因为该参数的行为(只有两个有效级别,且默认最高)容易被误解。

此 PR 是典型的文档修正,逻辑简单,无需深入审查。但如果你的团队正在使用 GLM-5.2 模型,建议及时同步此文档更新,避免被错误示例误导。

讨论亮点

无 review 评论。审核者 zijiexia 直接批准了 PR。

实现拆解

  1. 修正思考开关参数名:在 GLM-5.2.mdx 中,将 chat_template_kwargs: {"thinking": False} 改为 chat_template_kwargs: {"enable_thinking": False},并在文字说明中明确变量名为 enable_thinking
  2. 新增 reasoning_effort 文档:在文档中添加表格详细说明 reasoning_effort 的三个可选值(不传、"high"、其他)及其对应的系统提示行和效果,强调仅有两个有效级别。
  3. 更新 Python 示例:将示例代码中的 extra_body{"chat_template_kwargs": {"thinking": True}} 更新为 {"chat_template_kwargs": {"enable_thinking": True, "reasoning_effort": "high"}},展示正确的使用方式。
  4. 所有更改均仅限于 docs_new/cookbook/autoregressive/GLM/GLM-5.2.mdx 文件。
文件 模块 状态 重要度
docs_new/cookbook/autoregressive/GLM/GLM-5.2.mdx 文档 modified 2.99

分析完成后,这里会展示 LLM 生成的相对完整源码片段和详细注释。

评论区精华

没有提炼出高价值讨论线程

当前评论区没有形成足够清晰的争议点或结论,后续有更多讨论时会体现在这里。

风险与影响

风险极低,仅限于文档内容的修正和补充,不涉及任何代码逻辑变更。不存在回归、性能、安全或兼容性风险。

影响范围很小,仅限于阅读 GLM-5.2 cookbook 的用户。修复了参数名错误,避免用户因错误示例而遇到困难;新增的 reasoning_effort 文档有助于用户正确使用该参数。

低影响

关联 Issue

未识别关联 Issue

当前没有检测到明确关联的 Issue 链接,后续同步到相关引用后会出现在这里。

完整报告

参与讨论