# 策展 · X (Twitter) 🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Nous Research (@NousResearch) · 平台：X (Twitter) · 日期：2026-05-31

> 原始來源：https://x.com/NousResearch/status/2060490936124105179

## 中文摘要

Hermes Agent 新增 Tool Search 實現工具漸進式揭露。

**核心功能與運作機制**
Hermes Agent 引入了「Tool Search」功能，專門解決當使用者掛載大量 MCP 伺服器或非核心 plugin 工具時，JSON 結構描述（schema）會佔用大量視窗空間的問題。透過此功能，系統將非核心工具從模型可見的工具陣列中移除，改由三個橋接工具（bridge tools）取代，實現按需載入。

- 運作流程：
    1. `tool_search(query, limit?)`：搜尋延遲載入的工具目錄。
    2. `tool_describe(name)`：載入特定工具的完整結構描述。
    3. `tool_call(name, arguments)`：呼叫延遲載入的工具。
- 核心工具保障：Hermes 的核心工具集（如 `terminal`、`read_file`、`write_file`、`memory`、`web_search` 等）始終直接載入，不會被延遲，確保基礎能力不受影響。
- 執行透明度：當模型呼叫 `tool_call` 時，Hermes 會自動解開橋接並執行底層工具，確保所有的前置與後置 Hook、審核提示（approval prompts）以及 CLI 活動紀錄均顯示真實工具名稱，而非橋接工具。

**自動化配置與設定**
該功能預設採用「自動模式」，僅在延遲載入的工具結構描述佔用超過 10% 的視窗空間時才會啟用，確保在工具數量較少時不會產生額外開銷。使用者可透過設定檔進行調整：

```yaml
tools:
  tool_search:
    enabled: auto       # 可選 auto, on, off
    threshold_pct: 10   # 自動模式啟動的視窗佔用百分比
    search_default_limit: 5
    max_search_limit: 20
```

**技術權衡與限制**
雖然 Tool Search 能節省 token，但開發團隊明確指出其帶來的技術權衡：

- 額外延遲：首次呼叫冷門工具時，需額外進行一至兩次模型呼叫來搜尋與載入結構描述，這會增加運行時的開銷。
- 快取失效：由於工具集變更會改變橋接工具的描述，因此在對話中途新增或移除 MCP 伺服器會導致提示快取（prompt cache）失效。
- 模型能力依賴：該功能依賴模型撰寫精確搜尋查詢的能力。若模型搜尋能力不足，可能導致檢索失敗。
- 實作細節：檢索採用 BM25 演算法（針對工具名稱、描述與參數名稱），若無匹配結果則退回至子字串比對。此外，為了安全性與簡潔性，Hermes 選擇結構化工具模式，並未引入 JavaScript 沙盒。

**使用建議**
當使用者擁有大量工具但單次對話僅使用其中少數時，此功能為顯著優勢；若工具總數較少，則啟用此功能反而會因橋接工具的結構描述（約 300 token）產生不必要的成本。使用者可透過執行 `hermes update` 取得最新版本，詳細技術文件可參考 [Tool Search 使用指南](https://hermes-agent.nousresearch.com/docs/user-guide/features/tool-search)。

## 標籤

MCP, 功能更新, Agent, Hermes Agent
