Ein Tippfehler, ein scheinbar erfolgreiches leeres Ergebnis: Hermes lehnt den falschen Argumentnamen jetzt ab

Du bittest den Agenten, die Browser-Konsole auf Fehler zu prüfen. Er ruft das Browser-Tool von Playwright mit einem falschen Buchstaben auf — levle statt level. Das Tool beschwert sich nicht. Es liefert ein normales Ergebnis: Total messages: 0 (Errors: 0, Warnings: 0). Der Agent meldet eine saubere Seite.
Die Seite hatte zwölf Fehler. Das Argument wurde stillschweigend verworfen, das Tool lief mit Defaults, und alles sah in Ordnung aus. Ein stiller Erfolg ist deutlich gefährlicher als ein Fehlschlag — Fehlschläge liest du, Erfolge liest du nicht.
PR #115682, gemergt am 12. November, lehnt solche Calls ab, bevor sie laufen.
Warum es stillschweigend erfolgreich war
Die Antwort ist ein Feld im Schema: additionalProperties: false.
MCP-Server beschreiben ihre Parameter meist mit zod oder pydantic, und diese Bibliotheken erzeugen Schemas, die explizit sagen „dieses Objekt hat genau diese Keys“. Das klingt streng, aber der Parse verwirft unbekannte Keys meist, statt zu werfen. Also wird levle="error" als Extra-Key verworfen, level fällt auf seinen Default zurück, das Tool läuft durch, und es kommt ein Erfolg zurück.
Das Modell sieht nichts Falsches und behält die falsche Schreibweise für den Rest der Session bei.
Was jetzt passiert: Ablehnung vor dem Dispatch, mit den gültigen Namen
Die Regel ist kurz. Wenn ein Third-Party-Tool (MCP oder Plugin) sein eigenes Schema schließt, wird ein nicht deklarierter Top-Level-Key abgelehnt, bevor der Call läuft.
Echtes @playwright/mcp über stdio, durch den echten MCP-Client und den echten Tool-Dispatch:
| Call | Vorher | Nachher |
|---|---|---|
browser_console_messages(levle="error") |
Total messages: 0 ... — der Tippfehler wurde still verworfen |
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"}) |
der zod-Fehler des Servers, über action, der den Wrapper nie erwähnt |
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") |
normales Ergebnis | identisch |
| Third-Party-Tool mit offenem Schema und Extra-Key | Handler erhält den Key | identisch (unverändert) |
| Built-in-Tool mit unbekanntem Key | läuft, Ergebnis bekommt _warning |
identisch (Warn-and-Run bleibt) |
Schau auf die zweite Zeile. Der Fehler mit den gewrappten Arguments ist einer der einfachsten, die ein Modell machen kann: Es hat die arguments-Form von tool_call gesehen und nimmt an, jeder Call will diesen Wrapper. Vorher bekamst du einen zod-Fehler vom Server, der nur action erwähnte, und musstest selbst darauf kommen, dass die äußere Ebene das Problem ist. Jetzt sagt die Ablehnung es.
Warum Built-in-Tools unangetastet blieben
Weil das Schema eines Built-in-Tools keine gleichartige Zusage ist. Hermes schreibt diese Schemas selbst und hält den Vertrag lockerer: Ein Extra-Key lässt den Call nicht scheitern, das Ergebnis bekommt nur ein _warning mit dem Hinweis, dass der Name kein Parameter war. Das einzige Built-in, das sein Schema schließt (manage_catalog), lehnt unbekannte Keys schon in seinem eigenen Handler ab.
Anders gesagt: Je weiter außerhalb des Codes, desto strenger die Tür. Die properties-Liste eines Third-Party-Tools ist eine Zusage an seine Aufrufer, also wird sie jetzt als solche durchgesetzt.
Wo die Prüfung sitzt und wie weit sie reicht
Sie sitzt in _closed_schema_refusal in tools/arg_validation.py, als erstes, was check_tool_args tut — was heißt, dass sie jeden Entry-Point abdeckt, der schon Argument-Checks fährt: ToolRegistry.dispatch (MCP-, Plugin- und Registry-Tools auf jeder Oberfläche) und den Inline-Executor-Wrapper.
Ein verwandter Fix im selben Commit: Ein Schema, das das Objekt schließt, aber properties weglässt, lehnt Extras ebenfalls ab — „keine Argumente deklariert“ ist immer noch „nur diese Argumente“. 25 Playwright-MCP-Tools schließen ihr Schema, und sechs davon haben überhaupt kein Pflichtargument; genau bei diesen sechs wurde ein Tippfehler früher zu einem stillen Default-Erfolg.
Sind deine MCP-Server betroffen
Der Test ist direkt: Such im Schema des Tools nach additionalProperties: false.
- Moderne MCP-Server, die Schemas aus zod oder pydantic generieren, sind geschlossen und werden falsch geschriebene Argumente ab jetzt ablehnen.
- Handgeschriebenes JSON Schema und offene Formen (
anyOf,oneOf,$ref,patternProperties) verhalten sich wie bisher — Extras erreichen den Handler weiterhin. - Wenn eines deiner eigenen Plugins darauf gebaut hat, einen Extra-Key zu schicken und den Handler damit umgehen zu lassen, deklariere diesen Key in
properties. Das war schon immer die klarere Schnittstelle.
Wenn dein MCP-Setup aus Umgebungsvariablen und Dateien zusammengesetzt ist, lohnt sich ein erneuter Blick darauf, wie Argumente in MCP config context variables injiziert werden und wie die Grenze in dem MCP-Catalog und seinem Sicherheitsmodell gezogen wird. Ein früherer Post zu lokalen $ref-Schemas behandelte einen anderen Fehler im selben Bereich: Argumente, die gar nicht sichtbar waren, statt Argumente, die falsch gesehen und still akzeptiert wurden.
Release-Status
PR #115682 ist am 12. November 2026 in main gemergt, mit tests/tools/test_unknown_tool_arguments.py, das zwei Invarianten festnagelt: Ein geschlossenes Schema lehnt vor dem Handler ab, und ein offenes Schema lässt Extras weiter zu. v0.23.1 erschien am 10. November und enthält ihn nicht.
Update (17.11.2026): Diese Änderungen sind mit v0.23.2 (16. November) erschienen – ein
hermes updatebringt sie. Die Formulierung „nicht in v0.23.1“ oben ist eine Momentaufnahme vom Veröffentlichungstag.
Eine Fußnote: Wenn deine Tool-Liste riesig ist und das Modell ständig Parameter-Namen verwechselt, kann die Ursache die Schema-Größe sein — das Tool-Schema abspecken ist die andere Hälfte desselben Problems.