> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/zh/pa-qu/serp-api/ji-cheng/mcp-ji-cheng/hermes-agent-ji-cheng/hermes-agent-plugin-ji-cheng.md).

# Hermes Agent Plugin 集成

在 Hermes Agent 中安装和配置 Thordata 插件，用于常规网页研究和支持地域、语言、结果类型及时间筛选的高级 Google 搜索。

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

#### 先决条件

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

* 一个拥有有效 SERP API 接口令牌的 ThorData 账户。
* 已安装并正常运行的 Hermes Agent。
* 可访问 Hermes Agent 的 Python 环境。
* 你的终端中已安装 `uv`。

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

{% stepper %}
{% step %}

#### 获取您的 ThorData API 令牌

登录 [ThorData 仪表板](https://dashboard.thordata.com/serp-api/get-started)，创建或复制一个 API 令牌。

{% hint style="warning" %}
请将此令牌保密。 Hermes 使用它来验证每次 ThorData 搜寻请求，而这些请求会消耗您 ThorData SERP API 资格的配额。
{% endhint %}
{% endstep %}

{% step %}

#### 安装 ThorData 模组

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

{% tabs %}
{% tab title="macOS, Linux, or WSL2" %}

```bash
cd ~/.hermes/hermes-agent
uv pip install --python venv/bin/python <path-to-repo>
```

{% endtab %}

{% tab title="Native Windows (PowerShell)" %}

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

{% endtab %}
{% endtabs %}

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

{% hint style="warning" %}
插件必须安装在启动 Hermes 的同一个 Python 环境中。若将其安装于其他 Python 环境，Hermes 将无法发现它。
{% endhint %}
{% endstep %}

{% step %}

#### 启用并设定插件

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

```bash
hermes plugins enable talor
hermes tools
```

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

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

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

{% step %}

#### 验证安装

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

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

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

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

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

#### 范例提示

**市场研究**

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

**具备位置感知的产品研究**

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

**图片搜寻**

```
在 Google 艺术中查找小米 15 Ultra 的官方图片。
请提供每项结果的图片来源、页面标题和来源网址。
```

**行动装置搜寻结果**

```
显示「新加坡最佳点心」的 Google 移动搜寻结果。
包含每项自然搜索结果的标题、网址及简短摘要。
```

#### 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 保留原始网址，并在影响结果时标示搜寻国家、语言、时间范围及其他条件。

#### 故障排除

<details>

<summary>ThorData 模组未显示</summary>

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

</details>

<details>

<summary>ThorData 不提供网页搜寻服务</summary>

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

</details>

<details>

<summary>验证或配额错误</summary>

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

</details>

<details>

<summary>搜寻结果为空或出乎意料</summary>

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

</details>

<details>

<summary>Hermes 不使用进阶搜寻工具</summary>

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

</details>

#### 安全与使用说明

* 请勿将您的 ThorData API 令牌贴入提示语、共享的截图、公共储存库或客户端程式码中。
* 仅限于使用 ThorData 取得公开的搜寻结果资料，并遵守适用的法律、平台条款以及您内部的资料使用政策。
* 在需要可追溯性的报告中，请保留原始网址与查询条件。

#### 下一步

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