Anthony/agent-estate-wiki

Fork 0

Files

T

Tony0410 92e8028bb8 snapshot: preserve central wiki state 2026-08-15 (7 modified + 1 new file)

2026-08-15 22:11:30 +08:00

2.8 KiB

Raw Blame History

title, type, status, created, updated, review_after, verified_on, version_applies_to, confidence, tags, sources

title

type

status

created

updated

review_after

verified_on

version_applies_to

confidence

Hermes Tool Search

Why it is enabled

Hermes previously sent every external tool schema to the model on every turn. That used a large part of the context window before the conversation began and made compaction happen much sooner.

Native Hermes Tool Search is now always on. Core tools remain immediately available. External tools are discovered only when they are relevant, then described and called through the Tool Search bridge.

Active configuration

File: /home/hermes/.hermes/config.yaml

tools:
  tool_search:
    enabled: "on"
    threshold_pct: 10
    search_default_limit: 5
    max_search_limit: 20

enabled: "on" is the important setting: it makes Tool Search active on every request instead of waiting for the tool schemas to cross an automatic token threshold.

Verified result

80 external tools were deferred in the production gateway.
Approximately 24,151 schema tokens were removed from the always-present prompt.
36 core or directly visible tools remained available.
Estimated fixed baseline fell from about 52,955 to 29,182 tokens, a reduction of roughly 45%.
In an isolated Computer Use test, 53 tools were discovered and the health_report search, description, and call all succeeded.
Native Tool Search tests passed: 39 tests.

Tool Search can add a small discovery call when an external tool is first needed. It should not reduce answer quality: the model retains direct access to core tools and can search for specialized tools by name or purpose.

New tools and new skills

New external tools are automatically included in Tool Search after their tool provider is loaded. They do not need to be manually assigned to a category.

Skills use a separate discovery system:

~/.hermes/skills/devops/my-skill/SKILL.md is categorized as devops.
A skill directly under ~/.hermes/skills/ has no category.
The skill name and description come from YAML frontmatter in SKILL.md.
Directory additions are noticed automatically. An in-place edit may take up to 30 seconds to appear because of the skill cache.

Tool Search therefore does not decide skill categories. The first directory below ~/.hermes/skills/ does.

Rollback

The pre-change configuration is preserved at:

/home/hermes/.hermes/backups/config.yaml.20260725-before-tool-search

Restore that file only if Tool Search causes a confirmed regression, validate the YAML, and restart hermes-gateway.service.

2.8 KiB Raw Blame History