搜尋引擎¶

這頁能幫你做什麼¶

Search Engine 任務讓工作流程 (Workflow) 透過搜尋引擎查網路，取得本地知識庫以外的即時資訊，再帶進後續步驟。常見情境：

取得知識庫沒有的最新資訊，補足 RAG 流程。
從多個網路來源蒐集對同一主題的不同觀點。
找最近的新聞、文章或文件，做研究或市場情報。

開始前

這個任務需要一個 搜尋引擎資源 (Search Engine)，裡面設定好供應商（Google、DuckDuckGo、Perplexity、OpenAI）與金鑰等。請先到 Search Engine 資源頁建立好再回來選用。表單會依你選的供應商，自動顯示對應的專屬欄位。

操作步驟¶

新增一個 Search Engine 任務節點，點選它開啟右側設定表單。
在「名稱」填步驟名稱。
在搜尋引擎下拉選單選擇前面建好的搜尋引擎資源。選好後，會依供應商出現對應的查詢欄位；點欄位旁的調整（）圖示，可覆寫這次呼叫的搜尋參數。
設定「查詢來源」並填入查詢內容（見下方說明）。
視供應商出現的專屬選項（如精簡搜尋結果、引用、JSON Schema）依需要調整。
視需要展開「進階任務設定」設定「文件數量上限」。
設定「下一個狀態」，視需要填「附註」，再用測試按鈕（）試跑。

完整欄位說明¶

下表只列 Search Engine 任務特有的欄位。名稱、附註、下一個狀態、輸入與輸出、錯誤處理等共用分區，請見 Action 通用設定。

設定分頁（基本欄位）¶

欄位	必填	預設	說明
搜尋引擎	是	無	選擇要使用的搜尋引擎資源。選好後右側會出現編輯（鉛筆）與調整（）圖示，調整圖示可微調該資源在此步驟的搜尋參數（不影響資源本身設定）。也可切換成從工作流程輸入動態帶入。建立方式見 Search Engine 資源頁。
查詢來源	是	自訂查詢	決定搜尋查詢怎麼來，三選一（見下方說明）。選擇後下方會出現對應的輸入欄位。

查詢來源的三種模式¶

選擇不同的「查詢來源」會帶出不同欄位。下圖以「自訂查詢樣板」為例，會帶出「樣板」與「樣板變數」欄位：

查詢來源	帶出的欄位	說明
自訂查詢	查詢字串 (Query String)	直接填一段固定的查詢字串。可用 JSONPath 從輸入帶入，例如 `$.user_query`（路徑寫法見 JSONPath 語法）。
自訂查詢樣板	樣板 (Template)、樣板變數 (Template Variables)	用 Jinja2 樣板組查詢，執行時把樣板內的 `{{ variable }}` 換成實際值；變數值在「樣板變數」設定。
既有查詢樣板	樣板變數 (Template Variables)	沿用平台上已建好的查詢樣板，只需提供「樣板變數」的值。

搜尋參數覆寫對話框¶

按「搜尋引擎」欄位旁的調整（）圖示，會跳出搜尋參數覆寫對話框。這裡填的值只覆寫「這個步驟」這次呼叫的搜尋條件，不會改動搜尋引擎資源本身的設定。各欄位可留空，留空就沿用資源原本的設定。

欄位	必填	預設	說明
精準關鍵字詞	否	無	必須整段一字不差出現在結果中的字詞，用來鎖定特定詞組（相當於把字詞加上引號）。
排除關鍵字詞	否	無	含有這些字詞的結果會被排除，用來濾掉不想看到的內容。
地理位置	否	無	限定搜尋結果的所在地區（例如限定台灣的資訊），讓結果更貼近指定地點。
語言限制	否	無	只回傳指定語言的結果（例如只要繁體中文或英文內容）。
或條件關鍵字詞	否	無	只要符合其中任一個字詞就算命中（任一即可，非全部都要），用來擴大涵蓋範圍。
指定網站	否	無	把搜尋範圍限定（或排除）在特定網站或網域，例如只搜某個官方網站。
指定網站篩選方式	否	無	搭配「指定網站」使用，決定是「只搜這些網站」還是「排除這些網站」。
排序搜尋結果	否	無	設定結果的排序方式（例如依相關性或依日期），決定哪些結果排在前面。

Note

可填欄位與實際效果會因搜尋引擎供應商而異，留空的欄位一律沿用搜尋引擎資源既有的設定。

供應商專屬欄位¶

選定搜尋引擎資源後，會依供應商類型額外顯示下列欄位。下圖以 Google 為例，設定分頁會多出「精簡搜尋結果」開關：

欄位	供應商	必填	預設	說明
精簡搜尋結果	Google	否	開啟	開關。開啟時回傳精簡版搜尋結果；關閉則回傳較完整的結果內容。
輸出文字包含引用	Perplexity	否	開啟	開關。開啟時生成的文字會附上引用來源。
使用 JSON Schema	Perplexity	否	關閉	開關。開啟後可定義輸出的 JSON 結構，回應會依該結構驗證。
JSON Schema	Perplexity	是（開啟上一項時）	預設結構	只在「使用 JSON Schema」開啟時出現，用來定義輸出格式。

Note

供應商專屬欄位只在選定對應供應商（Google／Perplexity）時才會出現。DuckDuckGo 與 OpenAI 沒有上述專屬欄位。實際顯示內容以你選的搜尋引擎資源為準。

進階任務設定（摺疊區塊）¶

當搜尋引擎為 Google、DuckDuckGo 或 Perplexity 時，設定分頁底部會出現「進階任務設定」摺疊區塊：

欄位	必填	預設	說明
文件數量上限	否	10	回傳的搜尋結果筆數上限，可用滑桿調整，範圍 1 至 100。筆數越多涵蓋越廣，但處理時間也越長，建議 3 至 10 之間取得平衡。

實際範例與預期結果¶

設定內容：

搜尋引擎：選一個搜尋引擎資源
查詢來源：自訂查詢
查詢字串：$.user_query
文件數量上限：5

工作流程輸入：

{
  "user_query": "最新機器學習框架"
}

測試輸出（搜尋結果放在 search_results）：

{
  "errors": null,
  "action_type": "search_engine_action",
  "search_results": [
    {
      "title": "2025 頂尖 ML 框架",
      "url": "https://example.com/ml-frameworks-2025",
      "snippet": "最受歡迎的機器學習框架完整指南。"
    }
  ],
  "output": null
}

Note

輸出以後端實際回傳為準：搜尋結果放在 search_results（陣列），其他附帶輸出放在 output，action_type 固定為 search_engine_action。各結果項目的實際欄位會因供應商而異。

下一步¶

用 Read URL 任務抓取前幾筆結果的完整內容。
用 Ranker 任務依相關性重新排序結果。
把結果交給 LLM 任務綜合多個來源的資訊。
回到 Action 通用設定了解共用分區。