打错一个字母,工具却"成功"返回空结果:Hermes 现在拒绝错误参数名

你让 agent 去查浏览器控制台里的报错。它调用了 Playwright 的浏览器工具,参数名打错了一个字母,把 level 写成了 levle。工具没有报错,接口返回了正常结果:Total messages: 0 (Errors: 0, Warnings: 0)。agent 于是告诉你页面是干净的。
页面其实有 12 条报错。参数被静默丢掉,工具用默认值跑了一遍,然后一切看起来都很好。这类“沉默的成功”比直接报错危险得多——报错你会去看,成功你不会。
PR #115682(2026 年 11 月 12 日合并)把这类调用改成执行前拒绝。
为什么会静默成功
关键在于 schema 里的一个字段:additionalProperties: false。
MCP 服务的参数表通常用 zod 或 pydantic 写,这类库生成的 schema 会明确声明“这个对象只有列出来的这些键”,也就是 additionalProperties: false。听起来很严格,但执行时的解析行为通常是丢掉未知键,而不是抛错。于是 levle="error" 被当作一个多余的键扔掉,level 用默认值,工具照常跑完,回一个成功结果。
模型看不到任何异常,于是它会把这个错误写法带一整个会话。
现在的行为:执行前拒绝,并列出合法参数
规则很短:第三方工具(MCP、插件)的 schema 如果自己封闭了对象,那么未声明的最外层参数键在执行前就会被拒绝。
真实的 @playwright/mcp(stdio,走真正的 MCP 客户端和工具分发)对比:
| 调用 | 旧行为 | 新行为 |
|---|---|---|
browser_console_messages(levle="error") |
返回 Total messages: 0 ...,拼错的参数被静默丢弃 |
levle: not a parameter of mcp__pw__browser_console_messages. The tool was NOT invoked. Valid parameters: level, all, filename. |
browser_tabs(arguments={"action": "list"}) |
服务端自己的 zod 报错,提到 action,但完全没提外面那层 arguments |
arguments: not a parameter of mcp__pw__browser_tabs. ... Do not wrap the arguments in an "arguments" field (that shape is only for tool_call); pass each one at the top level. |
browser_tabs(action="list") |
正常返回 | 同样正常返回 |
| 开放 schema 的第三方工具 + 多余键 | 处理器收到这个键 | 同样收到(不变) |
| 内置工具 + 未知键 | 照常执行,结果里带 _warning |
不变(保留提示但继续执行) |
注意第二行那个“参数被包了一层”的坑。这是模型最容易犯的错之一:它见过 tool_call 的 arguments 形状,就以为所有工具调用都要这么包。以前你会看到一条来自服务端的 zod 报错,字面上只提 action,你必须自己推断出“是外面那层包错了”。现在错误信息直接把这件事说明白。
内置工具为什么不一起改
因为内置工具的参数表和第三方工具不是一回事。内置工具的 schema 是 Hermes 自己写的,允许“提示但继续执行”这种更宽松的契约:多传一个键不会让调用失败,结果里加一个 _warning 告诉你。唯一一个把 schema 封闭起来的内置工具(manage_catalog)本来就在自己的处理器里拒绝未知键。
换句话说:越是外部的东西,越要在门口拦住。第三方工具的 properties 列表是它对调用方的承诺,那就当承诺执行。
实现位置与覆盖面
检查落在 tools/arg_validation.py 的 _closed_schema_refusal,它是 check_tool_args 的第一个判断,所以天然覆盖了所有已经接好参数检查的入口:ToolRegistry.dispatch(MCP、插件、注册表工具在所有界面上都走这里)以及内联执行器的包装层。
一个相关的小修:schema 封闭了对象但省略了 properties 的情况,同样会拒绝多余键——“没列任何参数”也是一种“只有这些参数”。有 25 个 Playwright MCP 工具属于封闭 schema,其中 6 个完全没有必填参数,这 6 个正是拼错字母最容易变成“静默默认成功”的地方。
你的 MCP 服务会不会受影响
判断方法很直接:看它的工具 schema 里有没有 additionalProperties: false。
- 用 zod / pydantic 生成 schema 的现代 MCP 服务,基本都是封闭的,会开始拒绝拼错的参数。
- 手写 JSON Schema、或者参数表是
anyOf/oneOf/$ref/patternProperties这类开放形状的,行为不变,多余键照旧交给处理器。 - 如果你有自定义插件依赖“多传一个键、处理器自己处理”的写法,把它改成把键写进 schema 的
properties里——这本来就是更清楚的接口。
如果你的 MCP 配置本身就是靠环境变量和文件拼出来的,可以先对照MCP 配置里的上下文变量检查一遍参数是怎么注入的,再顺手看一眼MCP 目录与安全边界。之前那篇 MCP schema 的本地 $ref 处理的是另一类 schema 解析问题——本地引用没有被正确展开,那次是参数“看不到”,这次是参数“看错了还装作没看见”。
上线状态
PR #115682 于 2026 年 11 月 12 日合并进 main,配套测试 tests/tools/test_unknown_tool_arguments.py 里有两条不变量:封闭 schema 在处理器之前拒绝,开放 schema 仍然接受多余键。v0.23.1 发布于 11 月 10 日,不含这次改动。
更新(2026-11-17):这里说的改动已随 v0.23.2 发布(2026-11-16),
hermes update就能拿到。上文「不在 v0.23.1 里」是发布当时的快照。
顺带一提,如果你的工具列表本身就长得离谱、模型老是记混参数名,那问题可能在 schema 体积上——工具 schema 瘦身那篇讲的是同一件事的另一半。