跳轉到

搜尋引擎

這頁能幫你做什麼

搜尋引擎 (Search Engine) 幫你設定一個可重複使用的網路搜尋來源，讓 Agent 或工作流程 (Workflow) 能即時上網查資料、取得最新資訊。設定一次後，搜尋相關的任務與工具就能直接選用，不必每次重填金鑰與參數。

平台支援四種搜尋引擎：Google、DuckDuckGo、Perplexity、OpenAI。建立時先填名稱、選類型，畫面會依類型顯示對應的金鑰與參數欄位。

開始前

前置需求

  • Google：需備妥 Google API 金鑰與一組自訂搜尋引擎 ID（技術上稱為 cx）。
  • Perplexity、OpenAI：需備妥對應服務的 API 金鑰。
  • DuckDuckGo：免金鑰，可直接建立。
  • 搜尋引擎只存「搜尋來源的設定」本身。實際要查什麼、回傳幾筆，是在使用端（搜尋任務或 Agent 搜尋工具）才指定。

操作步驟

  1. 從左側資源選單進入「搜尋引擎」清單頁，點建立入口（空清單時是有文字的建立按鈕；清單已有項目時是右上角無文字的「+」圖示）開啟建立表單。

    建立搜尋引擎表單，選「Google」類型後的樣子

  2. 在「名稱」欄輸入容易辨識的名稱（例如 web-search-google）。

  3. 在「類型」下拉選單選擇搜尋來源。不同類型會出現不同欄位，選好後的畫面差異見下方完整欄位說明。建立後類型不可更改。
  4. 依所選類型填入金鑰與參數；非必填的進階參數收在「進階設定」摺疊區塊內。
  5. 若該類型支援（Google、Perplexity、OpenAI），可點表單右上角的「驗證 API 金鑰」按鈕，確認金鑰有效（DuckDuckGo 免金鑰，無此按鈕，見使用效果）。
  6. 按右上角的「儲存」按鈕完成建立（見步驟 1 圖右上角）。

完整欄位說明

主表單先填所有類型共通的「名稱」與「類型」，選好類型後再填該類型專屬的金鑰與參數欄位。

共同欄位（不分類型）

欄位 必填 預設 說明
名稱 是 無 搜尋引擎的識別名稱。最多 64 個字，不可用 default 開頭。
類型 是 無（需選擇） 搜尋來源，四選一：Google、DuckDuckGo、Perplexity、OpenAI。四者的適用情境與專屬欄位見下方四節。建立後無法修改。

類型在建立後鎖定

編輯既有搜尋引擎時「類型」為唯讀。需要不同類型請另建一個搜尋引擎。

不確定選哪型？

一句話判斷：

  • 要最廣泛的全網結果，且能自訂可程式化搜尋引擎範圍 → 選 Google。
  • 不想申請金鑰、只要快速試用 → 選 DuckDuckGo（免金鑰）。
  • 希望搜尋結果經大型語言模型整理成有語意、附引用的回答 → 選 Perplexity 或 OpenAI。

Perplexity 與 OpenAI 都結合語言模型與即時網頁搜尋，差別在於使用的服務與可調參數；已有哪家的金鑰就先用哪家。

Google

提供全球最廣泛的搜尋結果，涵蓋多元網頁與即時資訊；可搭配 Google「可程式化搜尋引擎 (Programmable Search Engine)」自訂搜尋範圍。

適合：

  • 要最完整的全網搜尋覆蓋率。
  • 想用自訂搜尋引擎 (cx) 限定或調整搜尋範圍。

選「Google」後，表單會出現「API 金鑰」與「Google 搜尋引擎 ID」，另有「進階設定」可細調結果：

Google 類型表單，含「API 金鑰」「Google 搜尋引擎 ID」與展開的進階設定

Google 類型的主要欄位：

欄位 必填 預設 說明
API 金鑰 是 無 Google API 金鑰，以遮罩方式輸入。
Google 搜尋引擎 ID 是 無 你在 Google 可程式化搜尋引擎建立搜尋引擎後拿到的識別碼，技術上稱為 cx。

進階設定（摺疊區塊「進階設定」內，皆為選填）：

欄位 必填 預設 說明
精準關鍵字詞 否 無 結果必須完全包含的字詞，可多筆。
排除關鍵字詞 否 無 結果要排除的字詞，可多筆。
地理位置 否 無 以使用者地理位置調整結果偏好。
語言限制 否 無 限定結果語言，可多筆。
或條件關鍵字詞 否 無 結果包含其中任一字詞即可，可多筆。
指定網站 否 無 限定搜尋特定網站，需為 http／https 開頭的有效網址。
指定網站篩選方式 否 無 搭配「指定網站」使用，選「包含」或「排除」該網站；未填「指定網站」時無法選。
排序搜尋結果 否 無 自訂結果排序表達式。

cx 哪裡拿

到 Google 可程式化搜尋引擎控制台（programmablesearchengine.google.com）建立一個搜尋引擎後即可取得並複製此 ID。畫面上的欄位標籤只寫「Google 搜尋引擎 ID」，指的就是同一個值。

DuckDuckGo

隱私導向的搜尋結果，避免個人化追蹤與廣告推薦；免金鑰，最容易上手。

適合：

  • 不想申請任何 API 金鑰，只要能快速取得搜尋結果。
  • 在意隱私、不希望結果被個人化追蹤影響。

選「DuckDuckGo」後沒有金鑰欄位，全部參數收在「進階設定」摺疊區塊內：

DuckDuckGo 類型表單，無金鑰欄位，進階設定含「地區」「安全搜尋」「時間限制」

DuckDuckGo 類型的欄位（皆為選填，全在進階設定內）：

欄位 必填 預設 說明
地區 否 No Region（wt-wt） 搜尋結果的地區偏好。
安全搜尋 否 中度 成人內容過濾程度，可選「中度」「開啟」「關閉」。
時間限制 否 無 只取近期結果，可選「一天內」「一週內」「一個月內」「一年內」，可清除。

Perplexity

結合大型語言模型與搜尋引擎，提供即時且具語意理解的回答。

適合：

  • 希望搜尋結果直接被整理成有語意、可閱讀的回答，而非單純的連結清單。
  • 已有 Perplexity API 金鑰。

選「Perplexity」後，表單會出現「API 金鑰」與「模型」，「進階設定」內有多個可細調回應行為的參數：

Perplexity 類型表單，含「API 金鑰」「模型」與展開的進階設定參數

Perplexity 類型的主要欄位：

欄位 必填 預設 說明
API 金鑰 是 無 Perplexity API 金鑰，以遮罩方式輸入。
模型 是 無（需選擇） 使用的模型，可選 Sonar、Sonar Pro。

進階設定（摺疊區塊「進階設定」內，皆為選填）。下列數值參數需先選好模型才能調整，且各自有一個勾選開關，未勾選即不送出：

欄位 必填 預設 範圍 說明
系統提示詞 否 無 — 給模型的系統層級指示。
最大 Token 數 否 1024 128–131072 回應的最大 token 數。
溫度 否 0.2 0–2 數值越高回應越發散、越低越保守。
Top P 否 0.9 0–1 核採樣機率閾值。
Top K 否 0 0–500 限制每步取樣的候選數，0 表示不限制。
存在懲罰 否 1 0–2 抑制重複已出現過的主題。
頻率懲罰 否 0 0–2 抑制高頻字詞重複。
搜尋網域篩選器 否 無 最多 3 筆 逐筆限定或排除特定網域。
回傳圖片 否 關閉 開關 是否在結果中附帶圖片。
回傳相關問題 否 關閉 開關 是否一併回傳延伸的相關問題。
搜尋時間篩選器 否 無 — 只取近期結果，可選「一天內」「一週內」「一個月內」「一年內」。
搜尋上下文資訊量 否 無 — 搜尋帶入的上下文量，可選「少」「中」「多」。

數值參數怎麼調

Sonar 與 Sonar Pro 的數值參數預設與範圍相同。多數情況維持預設即可；溫度調低（接近 0）會讓回答更穩定保守、調高更發散；想限縮資料來源時用搜尋網域篩選器指定可信網站；只要最新資訊時用搜尋時間篩選器。每個數值欄位左側都有勾選框，勾起來才會帶入該參數。

OpenAI

結合語言模型與即時網頁搜尋，提供具引用依據、具語意理解的精準回應。

適合：

  • 希望搜尋結果被整理成有引用依據的語意回答。
  • 已有 OpenAI API 金鑰。

選「OpenAI」後，表單會出現「API 金鑰」與「模型」，「進階設定」內可細調回應與在地化：

OpenAI 類型表單，含「API 金鑰」「模型」與展開的進階設定參數

OpenAI 類型的主要欄位：

欄位 必填 預設 說明
API 金鑰 是 無 OpenAI API 金鑰，以遮罩方式輸入。
模型 是 無（需選擇） 使用的模型，可選 GPT 4.1、GPT-4.1 mini、GPT-4o、GPT-4o mini、o4 mini。

進階設定（摺疊區塊「進階設定」內，皆為選填）。數值參數需先選好模型才能調整，且各有勾選開關，未勾選即不送出；其預設與範圍會依所選模型而異：

欄位 必填 範圍 說明
系統提示詞 否 — 給模型的系統層級指示。
最大 Token 數 否 最小 128，上限依模型而定 回應的最大 token 數。
溫度 否 0–2 數值越高回應越發散、越低越保守。
Top P 否 0–1 核採樣機率閾值。
Top K 否 0–500 限制每步取樣的候選數，0 表示不限制。
搜尋上下文資訊量 否 — 搜尋帶入的上下文量，可選「少」「中」「多」。
使用者位置國家 否 — 以國家代碼設定使用者所在國，影響在地化結果。
使用者位置區域 否 — 使用者所在的區域／州。
使用者位置城市 否 — 使用者所在的城市。

數值範圍依模型而定

OpenAI 各模型的數值參數預設與上限不同（例如「最大 Token 數」上限會隨模型在 16384～100000 之間變動）。先選好模型，畫面上的滑桿範圍就會跟著對應；用「使用者位置」三欄可讓搜尋結果更貼近指定地區。

搜尋引擎詳細頁

建立完成後點進某個搜尋引擎，詳細頁上方有三個頁籤；下圖為 Google 搜尋引擎「一般」頁籤的「詳細資料」卡片，可看到 ID、名稱、類型與該類型的設定欄位、狀態與最後更新：

搜尋引擎詳細頁的「一般」頁籤，顯示 ID、名稱、類型與設定欄位，上方有「一般」「依賴資源」「被依賴資源」三個頁籤，卡片右上角有編輯、複製、驗證、刪除圖示鈕

頁籤 內容
一般 搜尋引擎的基本資料：ID、名稱、類型，以及該類型的設定欄位（金鑰會遮蔽、cx、進階參數等）、系統資訊、狀態與最後更新。
依賴資源 這個搜尋引擎用到的其他資源。
被依賴資源 反過來，有哪些資源用到這個搜尋引擎（例如以它為來源的搜尋任務或 Agent 搜尋工具）。

「詳細資料」卡片右上角的圖示鈕：編輯（）、複製（）、驗證（）、刪除（），以及收合卡片的箭頭。其中「驗證」鈕是搜尋引擎特有的金鑰驗證入口，見下方使用效果；DuckDuckGo 因免金鑰，沒有可驗證的對象。

使用效果

搜尋引擎不能單獨執行，它的價值在於「被搜尋任務或 Agent 搜尋工具選用、即時上網查資料」。要確認金鑰設定正確，最直接的方式就是驗證 API 金鑰。

兩個驗證入口

需要金鑰的類型（Google、Perplexity、OpenAI）有兩個驗證入口，做的事一樣（用目前填入的金鑰測試一次），位置與長相不同：

  • 建立／編輯表單右上角的文字按鈕：字樣為「驗證 API 金鑰」（見上方各型表單截圖右上角）。
  • 詳細頁「詳細資料」卡片右上角的圖示鈕：圖示為 （鑰匙加無線弧），滑過會顯示「驗證 API 金鑰」（見詳細頁截圖）。

DuckDuckGo 免金鑰，這兩個入口都不會出現。

驗證結果

點下按鈕後，平台會用目前填入的金鑰去測試：

  • 成功：畫面右下角跳出綠色提示「API 金鑰驗證成功！」，代表這把金鑰可以正常使用。
  • 失敗：跳出紅色提示「API 金鑰驗證失敗！請檢查設定並重試。」，請回頭檢查金鑰是否正確、有沒有貼錯或過期。

建議在儲存前先驗證一次，確認金鑰有效再讓下游功能引用。

請先填好金鑰再驗證

需先把「API 金鑰」（Google 另含「Google 搜尋引擎 ID」、Perplexity／OpenAI 另含「模型」）填好，按鈕才會真正去測試。若還沒填完就按，按鈕可能沒有反應，這是正常的，不是故障。

驗證通過後，這個搜尋引擎就能在下游被選用：

下一步