Hermes Agent Plugin 集成

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

先決條件

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

• 一個擁有有效 SERP API 接口令牌的 TalorData 賬戶。

• 已安裝並正常運行的 Hermes Agent。

• 可訪問 Hermes Agent 的 Python 環境。

• 你的終端中已安裝 uv。

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

1

獲取您的 TalorData API 令牌

登錄 TalorData 儀表板，創建或復制一個 API 令牌。

請將此令牌保密。Hermes 使用它來驗證每次 TalorData 搜尋請求，而這些請求會消耗您 TalorData SERP API 資格的配額。

2

安裝 TalorData 模組

複製或下載 talor-hermes-plugin 倉庫。然後將套件安裝到 Hermes Agent 使用的 Python 環境中，並以該倉庫的本地路徑取代 path-to-repo。

macOS, Linux, or WSL2

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

Native Windows (PowerShell)

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 提示您設定網路搜尋提供者時，請在「網路搜尋與提取」下選擇 TalorData，並輸入來自 TalorData 桌面的 API 令牌。此插件會將 TALOR_API_TOKEN 設定用於所有 TalorData 搜尋請求。

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

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

4

驗證安裝

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

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

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

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

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

範例提示

市場研究

比較美國五大主流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 保留原始網址，並在影響結果時標示搜尋國家、語言、時間範圍及其他條件。

故障排除

TalorData 模組未顯示

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

TalorData 不提供網頁搜尋服務

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

驗證或配額錯誤

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

搜尋結果為空或出乎意料

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

Hermes 不使用進階搜尋工具

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

安全與使用說明

• 請勿將您的 TalorData API 令牌貼入提示語、共享的截圖、公共儲存庫或客戶端程式碼中。

• 僅限於使用 TalorData 取得公開的搜尋結果資料，並遵守適用的法律、平台條款以及您內部的資料使用政策。

• 在需要可追溯性的報告中，請保留原始網址與查詢條件。

下一步

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