Hermes Agent 开了 Tool Search 后找不到某个工具，先分清它是“被隐藏等待搜索”还是“根本没加载”。Tool Search 的目的不是把所有工具塞进当前上下文，而是把部分工具放到可发现目录里，需要时再拉出来。
隐藏和未加载的表现不同
如果工具在目录里能搜到，但模型没主动用，多半是任务描述不够明确，或者它判断当前问题不需要这个工具。如果工具完全搜不到，就要查 MCP server、插件、provider 或环境变量，说明它没有进入工具注册流程。
排查时不要同时接很多 MCP。先保留一个你要测试的工具，让 Hermes 完成一个必须调用它的任务。最小测试能通过，再逐步加回其他工具。这样能区分是工具本身坏了，还是工具太多导致发现和选择都变差。
怎么让它更容易用对
提示里写清楚要查什么、用哪个数据源、期望输出什么。例如“请搜索 GitHub 工具里的这个仓库 issue”，比“帮我看看为什么报错”更容易触发正确工具。Tool Search 不是读心术，它需要明确的任务线索。
如果是团队配置，建议把高风险工具放进更窄的工具集，低风险检索工具才适合常驻搜索目录。工具可发现不等于工具应当随便调用，尤其是能写入数据库、发布内容或改云资源的工具。
还有一个容易忽略的点：工具描述太模糊，也会让搜索命中变差。给工具写清用途、输入、限制和不适合场景，比单纯增加工具数量更有用。搜索目录不是仓库清单，而是给模型做选择的索引。
