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

# Hermes Agent Plugin 集成

在 Hermes Agent 中安裝 TalorData 插件，即可讓您的代理實時使用 TalorData SERP API 進行谷歌搜索。該插件支持通過 Hermes 內置的 `web_search` 工作流進行日常網頁研究，同時也可執行需要特定地點、語言、結果類型、時間範圍或分頁的高級谷歌搜索。

## 先決條件

開始之前，請確保您已具備以下條件：

* 一個擁有有效 SERP API 接口令牌的 TalorData 賬戶。
* 已安裝並正常運行的 Hermes Agent。
* 可訪問 Hermes Agent 的 Python 環境。
* 你的終端中已安裝 `uv`。

如果您是 Hermes Agent 的新手，請先完成其安裝和快速入門，然後再安裝插件。

{% stepper %}
{% step %}

## 獲取您的 TalorData API 令牌

登錄 [TalorData 儀表板](https://dashboard.talordata.com/zh-tw/dashboard)，創建或復制一個 API 令牌。

{% hint style="warning" %}
請將此令牌保密。Hermes 使用它來驗證每次 TalorData 搜尋請求，而這些請求會消耗您 TalorData SERP API 資格的配額。
{% endhint %}
{% endstep %}

{% step %}

## 安裝 TalorData 模組

複製或下載 [talor-hermes-plugin](https://github.com/TalorData/talor-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 提示您設定網路搜尋提供者時，請在「網路搜尋與提取」下選擇 **TalorData**，並輸入來自 TalorData 桌面的 **API 令牌**。此插件會將 `TALOR_API_TOKEN` 設定用於所有 TalorData 搜尋請求。

如果赫爾墨斯詢問此外掛程式是否可以取代內建工具，請選擇「否」。該外掛程式新增 TalorData 網頁搜尋提供者及 talor\_google\_search；並不會取代赫爾墨斯現有的工具處理器。

請重新啟動任何已運行的赫爾墨斯代理會話，以便載入已啟用的外掛程式與設定。
{% endstep %}

{% step %}

## 驗證安裝

啟動新的 Hermes Agent 會話，並發送請求，例如：

```
找出關於AI代理的五篇最新新聞文章。  
為每篇文章返回標題、出版商、發佈時間、來源網址以及一句摘要。
```

當安裝運作正常時，Hermes 应該使用其 web\_search 工作流程，並以 TalorData 為後端，返回包含來源網址的即時結果。\
要檢驗進階 Google 搜索工具，可嘗試帶有明確搜尋條件的請求：

```
在 Google 新聞中搜尋過去一週的 OpenAI 相關報導。  
使用美國結果並設定英文語言選項。按主題分組結果，並包含原始文章的網址。
```

當請求需要位置、語言、搜尋類型、時間範圍、裝置或分頁控制時，應使用 `talor_google_search`。工具選擇取決於任務需求，因此應確認所選工具及回應格式，而非預期長期以來結果完全相同。
{% endstep %}
{% endstepper %}

## 範例提示

### 市場研究

```
比較美國五大主流AI會議助手。  
包含各公司的定位、價格訊號及來源連結。
```

### 具備位置感知的產品研究

```
比較目前在德國可購得的優質預算型 Android 手機。  
使用德國地點與語言設定進行搜尋，至少查閱三家零售商，並列出包含最新價格與關鍵規格的簡短清單。
```

### 圖片搜尋

```
在 Google 藝術中查找小米 15 Ultra 的官方圖片。
請提供每項結果的圖片來源、頁面標題和來源網址。
```

### 行動裝置搜尋結果

```
顯示「新加坡最佳點心」的 Google 移動搜尋結果。  
包含每項自然搜索結果的標題、網址及簡短摘要。
```

## TalorData 模組能協助 Hermes Agent 做什麼

此插件為 Hermes 提供兩條由 TalorData 支援的 Google 搜尋路徑：

| 请求类型         | Hermes 工具             | 用于           |
| ------------ | --------------------- | ------------ |
| 一般網路研究       | `web_search`          | 日常研究、發現與資料收集 |
| 進階 Google 搜索 | `talor_google_search` | 需要明確搜尋控制的請求  |

針對進階搜尋，`talor_google_search` 支援以下 Google 參數：

* 裝置、位置、Google 域名、國家（`gl`）及語言（`hl`）
* 透過 `tbm` 的搜尋類型，包括圖片、購物、新聞、影片、本地結果與專利
* 透過 `tbs` 的時間範圍，從過去一小時至過去一年
* 安全搜尋設定、結果分頁（`起始位置與數量`）、JavaScript 渲染、AI 概覽以及快取控制

該插件會返回專為 Hermes 設定的聚焦搜尋欄位，而非將完整的原始 SERP 响應傳入代理上下文。請 Hermes 保留原始網址，並在影響結果時標示搜尋國家、語言、時間範圍及其他條件。

## 故障排除

<details>

<summary>TalorData 模組未顯示</summary>

確認套件已安裝至執行 Hermes 的 Python 環境，然後運行 `hermes plugins` 以驗證 `talor` 是否已啟用。啟用插件後，請重新啟動 Hermes。

</details>

<details>

<summary>TalorData 不提供網頁搜尋服務</summary>

確認「**網路搜尋與提取**」下已選取 TalorData，且 `TALOR_API_TOKEN` 已提供給 Hermes 操作流程。更改任一設定後，請啟動新的會話。

</details>

<details>

<summary>驗證或配額錯誤</summary>

請確認 TalorData 個人管理面板中的 API 令牌是否有效且已啟用。如有需要，請創建新的令牌並更新 Hermes 設定。在重試請求前，請先檢查您的訂閱方案及剩餘的 SERP API 使用配額。

</details>

<details>

<summary>搜尋結果為空或出乎意料</summary>

空結果不一定是安裝錯誤。請嘗試更廣泛的查詢、其他國家或語言，或不同的 Google 搜尋方式。搜尋結果會受到時間和地點的影響。

</details>

<details>

<summary>Hermes 不使用進階搜尋工具</summary>

在您的請求中加入所需的搜尋條件，例如目標國家、語言、時間範圍、搜尋類型、裝置或分頁。Hermes 會從任務中選擇工具，而非固定關鍵字。

</details>

## 安全與使用說明

* 請勿將您的 TalorData API 令牌貼入提示語、共享的截圖、公共儲存庫或客戶端程式碼中。
* 僅限於使用 TalorData 取得公開的搜尋結果資料，並遵守適用的法律、平台條款以及您內部的資料使用政策。
* 在需要可追溯性的報告中，請保留原始網址與查詢條件。

## 下一步

* 使用 Hermes Agent 建立可重複的新聞簡報、市場研究、產品比較以及基於位置的搜尋工作流程。