diff --git a/docs/wissen/HERMES-WERKZEUGE.md b/docs/wissen/HERMES-WERKZEUGE.md new file mode 100644 index 0000000..fc0ff20 --- /dev/null +++ b/docs/wissen/HERMES-WERKZEUGE.md @@ -0,0 +1,93 @@ +# Hermes: Werkzeuge nach Bedarf (21.08.2026) + +## Die Frage war: kann Hermes Werkzeuge je nach Aufgabe an- und abschalten? + +**Ja — auf drei Ebenen, und die wichtigste lief schon.** + +### 1. Automatisch zur Laufzeit — `tool_search` (war bereits an) + +``` +tools: + tool_search: + enabled: true + threshold_pct: 10 + listing: auto + listing_max_tokens: 4000 +``` + +Im Log nachweisbar: + +``` +tool_search activated (tier 1): 47 core/visible tools kept, +59 deferred (~5636 tokens), listing full (budget ~4000 tokens) +``` + +Hermes haelt einen Kern sichtbar und schiebt den Rest hinter eine Suche; der Agent +zieht nach, was er braucht. **Hier war nichts einzurichten.** + +Aber: das Aufschieben allein sparte nur 1.100–5.600 Tokens, waehrend `kanban` mit +22,7 KB im sichtbaren Kern blieb. Der Hebel lag woanders. + +### 2. Global abschalten — `agent.disabled_toolsets` + +```bash +hermes config set agent.disabled_toolsets "[computer_use, image_gen, video, video_gen, kanban, delegation]" +hermes tools disable session_search +``` + +Abgeschaltet **anhand von 9 Tagen echter Nutzung**, nicht nach Gefuehl: + +| Werkzeugsatz | Groesse | Nutzung 13.–21.08. | +|---|---|---| +| `kanban` (14 Werkzeuge) | 22,7 KB | 35× lesen, **1× schreiben** | +| `session_search` | 6,8 KB | **1×** | +| `delegation` | 5,6 KB | Fan-out, seit OpenChamber tot | + +‼️ `kanban` kennt `hermes tools disable` **nicht** — es haengt an `toolsets` / +`platform_toolsets` und muss ueber `agent.disabled_toolsets` weg. + +### 3. Pro Zugangsweg — `platform_toolsets.` + +★★ **Der groesste Fund.** Es gibt einen eigenen Zugangsweg `cron` (17 Sitzungen im +Log), fuer den **kein** Eintrag existierte — Cron-Jobs bekamen also die volle +Werkzeugkiste. Von den drei Jobs braucht nur der Nachrichtenbericht ueberhaupt +Werkzeuge, und der braucht zwei: + +```bash +hermes config set platform_toolsets.cron "[web, terminal]" +``` + +`web` fuer die Suche, `terminal` um `notify.sh` aufzurufen. Mehr nicht. + +Ausserdem moeglich, hier nicht gebraucht: `hermes -t TOOLSETS` setzt den +Werkzeugsatz fuer einen einzelnen Aufruf. + +## Gemessen mit `hermes prompt-size` + +Vorlast **je Anfrage**, Systemprompt plus Werkzeug-Schemata: + +| Zugangsweg | vorher | nachher | | +|---|---|---|---| +| `cli` | 99,4 KB | **56,5 KB** | −43 % | +| `cron` | 63,1 KB | **16,4 KB** | **−74 %** | + +Rund 11.000 Tokens weniger bei jedem interaktiven Zug, rund 12.000 bei jedem +Cron-Lauf. Das ist Kontext, der vorher fuer Werkzeugbeschreibungen draufging, +die nie aufgerufen wurden. + +## Nachgeprueft, nicht angenommen + +- Lucy interaktiv: Terminal, Dateien, Websuche, Gedaechtnis — alle vier da. +- Daily News Report mit nur `[web, terminal]` durchgelaufen und zugestellt. + Der Bericht war sogar besser als der Lauf davor. +- Sicherung der Konfiguration liegt unter `~/.hermes/config.yaml.bak-kiss-20260821`. + +## Noch drin, wenn es noch schlanker soll + +- `api_server` traegt 44,8 KB (19 Werkzeuge) — mehr als `cli`. Dort haengt noch + `hermes-pc-control`, das in 9 Tagen **null Mal** aufgerufen wurde und an dem + eine geplante Aufgabe auf dem PC plus ein eigenes Token haengen. +- MCP `hermes-web-fetch` (1 Aufruf) doppelt das eingebaute `web_extract`. +- MCP `mission-control-voice` (1 Aufruf) doppelt das eingebaute `text_to_speech`. +- Die alten Eintraege `kanban` / `delegation` stehen noch in `platform_toolsets`; + `agent.disabled_toolsets` sticht sie, aber aufgeraeumt ist es nicht.