Source Capture: Hermes reasoning_effort code and config excerpts

Captured: 2026-04-13

Source 1（来源 1）

• Type: Local config
• Path: /home/ubuntu/.hermes/config.yaml

Checked excerpt（已核对摘录）

• 当前主配置里存在：
  • agent.reasoning_effort: high
• 同一个配置文件里还存在：
  • delegation.reasoning_effort: ''
• 这说明当前主代理已经显式设了思考强度，而子代理没有单独覆盖。

Source 2（来源 2）

• Type: Hermes source code
• Path: /home/ubuntu/.hermes/hermes-agent/hermes_constants.py

Checked excerpt（已核对摘录）

• parse_reasoning_effort(effort) 接受的值是：
  • none
  • minimal
  • low
  • medium
  • high
  • xhigh
• 空值或无法识别的值会返回 None。
• none 会被解析成 {"enabled": False}。
• 其他合法值会被解析成 {"enabled": True, "effort": <level>}。

Source 3（来源 3）

• Type: Hermes source code
• Paths:
  • /home/ubuntu/.hermes/hermes-agent/cli.py
  • /home/ubuntu/.hermes/hermes-agent/gateway/run.py

Checked excerpt（已核对摘录）

• CLI 的 /reasoning 命令会把值保存到：
  • agent.reasoning_effort
• Gateway 读取 reasoning 配置时，也读的是：
  • agent.reasoning_effort
• 这说明 Hermes 把“思考强度”当成 agent 层配置，不是 model 层配置。

Source 4（来源 4）

• Type: Hermes source code
• Path: /home/ubuntu/.hermes/hermes-agent/run_agent.py

Checked excerpt（已核对摘录）

• 当 reasoning config 没有显式传入时，Responses 路径默认按 medium 处理。
• 如果 reasoning_config.enabled 为 False，则禁用 reasoning。
• 如果 reasoning_config.effort 有值，就按该值发送。
• 这说明 agent.reasoning_effort 控制的是运行时请求里的 reasoning 配置，而不是模型选择本身。

Source 5（来源 5）

• Type: Hermes default config
• Path: /home/ubuntu/.hermes/hermes-agent/hermes_cli/config.py

Checked excerpt（已核对摘录）

• delegation.reasoning_effort 的注释写明：
  • 空值表示继承父代理的 level
• 这和当前本机配置里的空字符串状态一致。

Durable takeaway（可长期复用结论）

• Hermes 的思考强度参数默认应该写在 agent.reasoning_effort，不是 model 段。
• delegation.reasoning_effort 是子代理单独覆盖入口；空着就继承主代理。
• 当前这台机器的主配置已经是 agent.reasoning_effort: high。
• 如果不显式设置，Hermes 的常见默认行为会落到 medium。