Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Hermes Agent Plugin 集成

在 Hermes Agent 中安装 ThorData 插件，即可让您的代理实时使用 ThorData SERP API 进行谷歌搜索。该插件支持通过 Hermes 内置的 web_search 工作流进行日常网页研究，同时也可执行需要特定地点、语言、结果类型、时间范围或分页的高级谷歌搜索。

先决条件

开始之前，请确保您已具备以下条件：

  • 一个拥有有效 SERP API 接口令牌的 ThorData 账户。

  • 已安装并正常运行的 Hermes Agent。

  • 可访问 Hermes Agent 的 Python 环境。

  • 你的终端中已安装 uv。

如果您是 Hermes Agent 的新手，请先完成其安装和快速入门，然后再安装插件。

1

获取您的 ThorData API 令牌

登录 ThorData 仪表板，创建或复制一个 API 令牌。

请将此令牌保密。 Hermes 使用它来验证每次 ThorData 搜寻请求，而这些请求会消耗您 ThorData SERP API 资格的配额。

2

安装 ThorData 模组

复制或下载 thor-hermes-plugin 仓库。然后将套件安装到 Hermes Agent 使用的 Python 环境中，并以该仓库的本地路径取代 path-to-repo。

cd ~/.hermes/hermes-agent
uv pip install --python venv/bin/python <path-to-repo>
cd $env:USERPROFILE\.hermes\hermes-agent
uv pip install --python .\venv\Scripts\python.exe <path-to-repo>

若从 Git Bash 执行 Hermes，请使用正斜线：cd ~/.hermes/hermes-agent 及 --python venv/Scripts/python.exe。若您已设定 HERMES_HOME，则请改用该位置下的 Hermes Agent 目录。

插件必须安装在启动 Hermes 的同一个 Python 环境中。若将其安装于其他 Python 环境，Hermes 将无法发现它。

3

启用并设定插件

启用插件，然后检查 Hermes 可以发现的工具：

hermes plugins enable talor
hermes tools

当 Hermes 提示您设定网路搜寻提供者时，请在「网路搜寻与提取」下选择 ThorData，并输入来自 ThorData 桌面的 API 令牌。此插件会将 THOR_API_TOKEN 设定用于所有 ThorData 搜寻请求。

如果赫尔墨斯询问此外挂程式是否可以取代内建工具，请选择「否」。该外挂程式新增 ThorData 网页搜寻提供者及 thor_google_search；并不会取代赫尔墨斯现有的工具处理器。

请重新启动任何已运行的赫尔墨斯代理会话，以便载入已启用的外挂程式与设定。

4

验证安装

启动新的 Hermes Agent 会话，并发送请求，例如：

找出关于AI代理的五篇最新新闻文章。
为每篇文章返回标题、出版商、发布时间、来源网址以及一句摘要。

当安装运作正常时，Hermes 应该使用其 web_search 工作流程，并以 ThorData 为后端，返回包含来源网址的即时结果。 要检验进阶 Google 搜索工具，可尝试带有明确搜寻条件的请求：

在 Google 新闻中搜寻过去一周的 OpenAI 相关报导。
使用美国结果并设定英文语言选项。按主题分组结果，并包含原始文章的网址。

当请求需要位置、语言、搜寻类型、时间范围、装置或分页控制时，应使用 thor_google_search。工具选择取决于任务需求，因此应确认所选工具及回应格式，而非预期长期以来结果完全相同。

范例提示

市场研究

比较美国五大主流AI会议助手。
包含各公司的定位、价格讯号及来源连结。

具备位置感知的产品研究

比较目前在德国可购得的优质预算型 Android 手机。
使用德国地点与语言设定进行搜寻，至少查阅三家零售商，并列出包含最新价格与关键规格的简短清单。

图片搜寻

行动装置搜寻结果

ThorData 模组能协助 Hermes Agent 做什么

此插件为 Hermes 提供两条由 ThorData 支援的 Google 搜寻路径：

请求类型
Hermes 工具
用于

一般网路研究

web_search

日常研究、发现与资料收集

进阶 Google 搜索

thor_google_search

需要明确搜寻控制的请求

针对进阶搜寻，thor_google_search 支援以下 Google 参数：

  • 装置、位置、Google 域名、国家（gl）及语言（hl）

  • 透过 tbm 的搜寻类型，包括图片、购物、新闻、影片、本地结果与专利

  • 透过 tbs 的时间范围，从过去一小时至过去一年

  • 安全搜寻设定、结果分页（起始位置与数量）、JavaScript 渲染、AI 概览以及快取控制

该插件会返回专为 Hermes 设定的聚焦搜寻栏位，而非将完整的原始 SERP 响应传入代理上下文。请 Hermes 保留原始网址，并在影响结果时标示搜寻国家、语言、时间范围及其他条件。

故障排除

ThorData 模组未显示

确认套件已安装至执行 Hermes 的 Python 环境，然后运行 ​​hermes plugins 以验证 thor 是否已启用。启用插件后，请重新启动 Hermes。

ThorData 不提供网页搜寻服务

确认「网路搜寻与提取」下已选取 ThorData，且 THOR_API_TOKEN 已提供给 Hermes 操作流程。更改任一设定后，请启动新的会话。

验证或配额错误

请确认 ThorData 个人管理面板中的 API 令牌是否有效且已启用。如有需要，请创建新的令牌并更新 Hermes 设定。在重试请求前，请先检查您的订阅方案及剩余的 SERP API 使用配额。

搜寻结果为空或出乎意料

空结果不一定是安装错误。请尝试更广泛的查询、其他国家或语言，或不同的 Google 搜寻方式。搜寻结果会受到时间和地点的影响。

Hermes 不使用进阶搜寻工具

在您的请求中加入所需的搜寻条件，例如目标国家、语言、时间范围、搜寻类型、装置或分页。 Hermes 会从任务中选择工具，而非固定关键字。

安全与使用说明

  • 请勿将您的 ThorData API 令牌贴入提示语、共享的截图、公共储存库或客户端程式码中。

  • 仅限于使用 ThorData 取得公开的搜寻结果资料，并遵守适用的法律、平台条款以及您内部的资料使用政策。

  • 在需要可追溯性的报告中，请保留原始网址与查询条件。

下一步

  • 使用 Hermes Agent 建立可重复的新闻简报、市场研究、产品比较以及基于位置的搜寻工作流程。

PreviousHermes Agent集成
NextHermes Agent MCP 集成

Last updated

Was this helpful?