docs(hermes): Werkzeuge nach Bedarf - tool_search lief schon, Totes abgeschaltet

Gemessen mit prompt-size: cli 99,4 -> 56,5 KB (-43%), cron 63,1 -> 16,4 KB (-74%).
Groesster Fund: der Zugangsweg 'cron' hatte keinen platform_toolsets-Eintrag und
bekam die volle Werkzeugkiste, obwohl nur ein Job ueberhaupt Werkzeuge braucht.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Hitonabi
2026-08-21 16:20:22 +02:00
co-authored by Claude Opus 5
parent f446da8ae6
commit 9cf04c427e
+93
View File
@@ -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.1005.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.<platform>`
★★ **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.