搜尋引擎¶
這頁的用途¶
搜尋引擎 (Search Engine) 設定一個可重複使用的網路搜尋來源,讓 Agent 或工作流程 (Workflow) 能即時上網查資料、取得最新資訊。設定一次後,搜尋相關的任務與工具就能直接選用,不必每次重填金鑰與參數。
平台支援六種搜尋引擎:Google、DuckDuckGo、Perplexity、Perplexity Agent、Perplexity Search、OpenAI。建立時先填名稱、選類型,畫面會依類型顯示對應的金鑰與參數欄位。
開始前¶
前置需求
- Google:需備妥 Google API 金鑰與一組自訂搜尋引擎 ID(技術上稱為
cx)。 - Perplexity、Perplexity Agent、Perplexity Search、OpenAI:需備妥對應服務的 API 金鑰。Perplexity Agent 的「模型」清單是用你填的金鑰去查的,所以要先填金鑰才選得到模型。
- DuckDuckGo:免金鑰,可直接建立。
- 搜尋引擎只存「搜尋來源的設定」本身。實際要查什麼、回傳幾筆,是在使用端(搜尋任務或 Agent 搜尋工具)才指定。
操作步驟¶
-
從左側資源選單進入「搜尋引擎」清單頁,點建立入口(空清單時是有文字的建立按鈕;清單已有項目時是右上角無文字的「+」圖示)開啟建立表單。

-
在「名稱」欄輸入容易辨識的名稱(例如
web-search-google)。 - 在「類型」下拉選單選擇搜尋來源。不同類型會出現不同欄位,選好後的畫面差異見下方完整欄位說明。建立後類型不可更改。
- 依所選類型填入金鑰與參數;非必填的進階參數收在「進階設定」摺疊區塊內。
- 若該類型支援(Google、Perplexity、Perplexity Agent、Perplexity Search、OpenAI),可點表單右上角的「驗證 API 金鑰」按鈕,確認金鑰有效(DuckDuckGo 免金鑰,無此按鈕,見使用效果)。
- 按右上角的「儲存」按鈕完成建立(見步驟 1 圖右上角)。
完整欄位說明¶
主表單先填所有類型共通的「名稱」與「類型」,選好類型後再填該類型專屬的金鑰與參數欄位。
共同欄位(不分類型)¶
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱 | 是 | 無 | 搜尋引擎的識別名稱。最多 64 個字,不可用 default 開頭。 |
| 標籤 | 否 | 無 | 分類用的小標,貼上後可在清單頁用「標籤」把同一群資源一次篩出來。填法與數量/長度限制見「標籤」欄位。 |
| 類型 | 是 | 無(需選擇) | 搜尋來源,六選一:Google、DuckDuckGo、Perplexity、Perplexity Agent、Perplexity Search、OpenAI。各型的適用情境與專屬欄位見下方各節。建立後無法修改。 |
類型在建立後鎖定
編輯既有搜尋引擎時「類型」為唯讀。需要不同類型請另建一個搜尋引擎。
不確定選哪型?
一句話判斷:
- 要最廣泛的全網結果,且能自訂可程式化搜尋引擎範圍 → 選 Google。
- 不想申請金鑰、只要快速試用 → 選 DuckDuckGo(免金鑰)。
- 希望搜尋結果經大型語言模型整理成有語意、附引用的回答 → 選 Perplexity Agent 或 OpenAI。
- 只要一批網頁清單(標題、網址、摘要、日期)自己後續處理,不要 AI 幫你寫答案 → 選 Perplexity Search,它最單純也最省。
三種 Perplexity 的差別:Perplexity Agent 是目前 Perplexity 的主線做法(走 Agent API,可用預設組合控制研究深度);Perplexity Search 只回排序後的網頁結果、不含 AI 答案;Perplexity 是較早的做法,新建議一律選 Perplexity Agent。已有哪家的金鑰就先用哪家。
Google¶
提供全球最廣泛的搜尋結果,涵蓋多元網頁與即時資訊;可搭配 Google「可程式化搜尋引擎 (Programmable Search Engine)」自訂搜尋範圍。
適合:
- 要最完整的全網搜尋覆蓋率。
- 想用自訂搜尋引擎 (cx) 限定或調整搜尋範圍。
選「Google」後,表單會出現「API 金鑰」與「Google 搜尋引擎 ID」,另有「進階設定」可細調結果:

Google 類型的主要欄位:
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| API 金鑰 | 是 | 無 | Google API 金鑰,以遮罩方式輸入。 |
| Google 搜尋引擎 ID | 是 | 無 | 在 Google 可程式化搜尋引擎建立搜尋引擎後拿到的識別碼,技術上稱為 cx。 |
進階設定(摺疊區塊「進階設定」內,皆為選填):
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 精準關鍵字詞 | 否 | 無 | 結果必須完全包含的字詞,可多筆。 |
| 排除關鍵字詞 | 否 | 無 | 結果要排除的字詞,可多筆。 |
| 地理位置 | 否 | Taiwan | 以使用者地理位置調整結果偏好。 |
| 語言限制 | 否 | English、Chinese (Traditional) | 限定結果語言,可多筆;預設已帶入英文與正體中文,可移除或改選。 |
| 或條件關鍵字詞 | 否 | 無 | 結果包含其中任一字詞即可,可多筆。 |
| 指定網站 | 否 | 無 | 限定搜尋特定網站,需為 http/https 開頭的有效網址。 |
| 指定網站篩選方式 | 否 | 無 | 搭配「指定網站」使用,選「包含」或「排除」該網站;未填「指定網站」時無法選。 |
| 排序搜尋結果 | 否 | 無 | 單行文字欄位,填 Google 自訂搜尋的排序表達式;留空就照 Google 預設的相關性排序。 |
cx 哪裡拿
到 Google 可程式化搜尋引擎控制台(programmablesearchengine.google.com)建立一個搜尋引擎後即可取得並複製此 ID。畫面上不會出現 cx 這個字:建立/編輯表單的欄位標籤是「Google 搜尋引擎 ID」,詳細頁則簡寫成「搜尋引擎 ID」,指的都是同一個值。
DuckDuckGo¶
隱私導向的搜尋結果,避免個人化追蹤與廣告推薦;免金鑰,最容易上手。
適合:
- 不想申請任何 API 金鑰,只要能快速取得搜尋結果。
- 在意隱私、不希望結果被個人化追蹤影響。
選「DuckDuckGo」後沒有金鑰欄位,全部參數收在「進階設定」摺疊區塊內:

DuckDuckGo 類型的欄位(皆為選填,全在進階設定內):
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 地區 | 否 | No Region | 搜尋結果的地區偏好。畫面上一律顯示地區名稱(不設限就是 No Region),不會出現對應的地區代碼。 |
| 安全搜尋 | 否 | 中度 | 成人內容過濾程度,可選「中度」「開啟」「關閉」。 |
| 時間限制 | 否 | 無 | 只取近期結果,可選「一天內」「一週內」「一個月內」「一年內」,可清除。 |
Perplexity Agent¶
透過 Perplexity 的 Agent API,用「預設組合」或指定模型,提供具引用來源的網路搜尋答案。這是三種 Perplexity 裡建議優先選的一種。
適合:
- 希望搜尋結果直接被整理成有語意、附引用來源的回答。
- 想用一個選項就控制「查多深、花多久」(預設組合),不必逐一調參數。
選「Perplexity Agent」後,表單會出現「API 金鑰」「預設組合」「模型」,其餘參數收在「進階設定」摺疊區塊內:

主要欄位:
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| API 金鑰 | 是 | 無 | Perplexity API 金鑰,以遮罩方式輸入。 |
| 預設組合 | 二者至少填一 | 無 | Perplexity 管理好的「模型 + 搜尋」組合,五選一:「快速」「低」「中」「高」「極限」。等級越高,研究步驟越多、耗時越長、成本越高(見下表)。舊型的「Perplexity」把同樣這五項放在它的「模型」欄裡,同名同順序,看到時別誤以為是同一個欄位。 |
| 模型 | 二者至少填一 | 無 | 要用的特定模型。選項是用你填的 API 金鑰去查出來的清單,所以依帳戶而異。金鑰還沒填時這一欄是停用的(點了也不會展開),欄位提示會寫「請先填寫 API 金鑰,模型清單會以該金鑰查詢,且依帳戶而異。」;金鑰一填進去就會解鎖。清單裡的名稱都是「<供應商>/<模型>」的格式,依供應商前綴排在一起(anthropic/、google/、openai/、perplexity/、xai/),所以 Perplexity 自家的模型是 perplexity/sonar 這種寫法。填好金鑰後若清單還是空的,可點欄位右側的 重新查一次——但金鑰打錯時按它會把你彈回登入頁、整張填好的表單一起消失,所以按之前先確認金鑰貼對了(或先把資源存下來,再回編輯表單挑模型)。與「預設組合」併用時,模型會覆寫預設組合裡的模型。 |
「預設組合」的五個等級:
| 選項 | 說明 |
|---|---|
| 快速 | 執行最短的研究流程,回應最快、成本最低。 |
| 低 | 執行輕量的研究流程,是 Sonar Pro 的建議替代選項(Sonar、Sonar Pro 是 Perplexity 自家搜尋模型的名字,Sonar Pro 是比較高階的那一支;這句是 Perplexity 建議原本用 Sonar Pro 的人改用這個等級)。 |
| 中 | 在研究深度與成本之間取得平衡,適合一般用途。 |
| 高 | 執行深入的多步驟研究,單次搜尋可能耗費數分鐘。 |
| 極限 | 執行最深入的多步驟研究,成本最高、回應時間最長。 |
「預設組合」與「模型」至少要填一個
兩欄都留空存不起來——平台不知道要用什麼跑。要注意這兩欄畫面上都沒有必填星號,但兩欄都空著按「驗證 API 金鑰」或「儲存」時,各自會冒出「此欄位為必填」——那句看起來像「兩欄都非填不可」,其實不是:填好其中一欄就夠了。另一欄的紅字不會馬上消失(要再按一次「驗證 API 金鑰」或「儲存」才會清掉),看到它還在不用理它。最省事的做法是只選一個「預設組合」(例如「中」),模型留空。
「快速」不能搭配 anthropic/* 模型
anthropic/* 指的是「模型」清單裡以 anthropic/ 開頭的那幾個模型——Perplexity 除了自家的 Sonar 系列,也代理 Anthropic、Google、OpenAI、xAI 的模型,清單裡就是照這個前綴分群的。清單是用你的金鑰查出來的,所以帳戶裡沒有這類模型的話,這一則與下一則提醒都不會遇到。
這個組合每次搜尋都會失敗。同時選了「快速」與 anthropic/* 開頭的模型時,畫面會出現「快速預設組合無法搭配 anthropic/* 模型,每次搜尋都會失敗。請改選其他預設組合,或清空預設組合、只保留模型。」——照著做即可:改選其他等級,或把「預設組合」清空、只留模型。
進階設定(摺疊區塊「進階設定」內,皆為選填)。數值參數左側各有一個勾選框,沒勾就不會送出,所以剛展開時這些數值框是空的;下表「預設」欄寫的數字是勾起來之後平台才帶進去的值。勾起來後可以拖滑桿或直接在右邊的框裡打數字:
| 欄位 | 必填 | 預設 | 範圍 | 說明 |
|---|---|---|---|---|
| 指令 | 否 | 無 | — | 給模型的系統指令。搭配預設組合使用時,會取代預設組合內建的系統提示詞。 這一格是帶行號的多行編輯器,右下角還有一顆「改寫」鈕(空白時停用,填了內容才亮)——行號只是為了看長文方便,這裡填的是一般的中文指示,不是程式碼。 |
| 最大輸出 Token 數 | 否 | 未勾選(勾選後 1024) | 1–131072 | 回應的最大 token 數。 |
| 最大步驟數 | 否 | 未勾選(勾選後 10) | 1–100 | 研究流程最多做幾步。步數越多查得越深,也越慢越貴。 |
| 推理強度 | 否 | 無 | — | 模型每次搜尋投入多少推理,六選一:「最低」「低」「中」「高」「極限」「最大」。越高答案越完整,Token 用量也越高。 |
| 溫度 | 否 | 未勾選(勾選後 0.2) | 0–2 | 數值越高回應越發散、越低越保守。 |
| Top P | 否 | 未勾選(勾選後 0.9) | 0–1 | 核採樣機率閾值。 |
| 偏好語言 | 否 | 無 | — | 回應要用的語言。可搜尋的下拉,選項是英文語言名稱(例如正體中文要選 Chinese),打中文找不到。 |
| 搜尋網域篩選器 | 否 | 無 | 最多 20 筆 | 只從指定網域取結果。要排除某個網域就在前面加 -;只填純網域名稱(例如 wikipedia.org)。欄位長相是一張表格,一開始是空的:按表格右下角的 開「新增網域」對話框(欄位「網域」必填),填完按「儲存」回到表格成為一列,一列一個網域;表格每頁顯示 10 筆,超過會分頁。加的時候不會攔你(可以一路加到 20 筆以上),要按「驗證 API 金鑰」或送出時才會在這一欄冒出「此欄位必須小於或等於 20 個項目」。 |
| 搜尋時間篩選器 | 否 | 無 | — | 只取近期結果,五選一:「一小時內」「一天內」「一週內」「一個月內」「一年內」。 |
| 發布日期起始篩選器 | 否 | 無 | — | 結果的最早發布日期。欄位顯示 MM/DD/YYYY 佔位符,點它開日期選擇器挑日期;挑過之後可用欄位右側的清除鈕移除。 |
| 發布日期結束篩選器 | 否 | 無 | — | 結果的最晚發布日期。 |
| 最後更新日期起始篩選器 | 否 | 無 | — | 結果的最早最後更新日期。同一篇文章改過內容時,這一組看的是改動時間,不是首次發布時間。 |
| 最後更新日期結束篩選器 | 否 | 無 | — | 結果的最晚最後更新日期。 |
| 搜尋上下文資訊量 | 否 | 無 | — | 搜尋帶入的上下文量,可選「少」「中」「多」。越多回答可能越完整,也越耗資源。 |
用 anthropic/* 模型時「最大輸出 Token 數」變成必填
anthropic/* 模型沒有指定輸出上限會被 Perplexity 拒絕,所以選了這類模型之後這個欄位的勾選框取消不了。推理 Token 也計入同一個上限,建議設 1024 以上。
只想調一項的話,先調「預設組合」
「預設組合」一個選項就同時決定了模型與研究深度,多數情況這樣就夠。真正需要細調時,最常動的是「搜尋網域篩選器」(限縮到可信來源)與「搜尋時間篩選器」(只要最新資訊);「最大步驟數」與「推理強度」會明顯影響回應時間與成本,調高前先確認需要。
Perplexity Search¶
透過 Perplexity 的 Search API,只回傳排序後的網頁結果(標題、網址、摘要、日期),不含 AI 寫的答案。
適合:
選「Perplexity Search」後,表單會出現「API 金鑰」與「搜尋模式」,其餘篩選條件收在「進階設定」摺疊區塊內:

主要欄位:
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| API 金鑰 | 是 | 無 | Perplexity API 金鑰,以遮罩方式輸入。 |
| 搜尋模式 | 否 | 無 | 要搜哪一個索引,三選一:「網頁」(一般網頁索引)、「學術」(學術論文與研究來源)、「SEC」(美國證券交易委員會的公開公司申報文件)。 |
進階設定(摺疊區塊「進階設定」內,皆為選填)。最後兩個數值參數左側各有一個勾選框,沒勾就不會送出:
| 欄位 | 必填 | 預設 | 範圍 | 說明 |
|---|---|---|---|---|
| 搜尋網域篩選器 | 否 | 無 | 最多 20 筆 | 只從指定網域取結果。要排除某個網域就在前面加 -;只填純網域名稱(例如 wikipedia.org)。填法(表格加列、超過 20 筆何時才報錯)與 Perplexity Agent 的同名欄位相同。 |
| 搜尋語言篩選器 | 否 | 無 | 最多 20 筆 | 限定結果的語言,可多選。選項是英文語言名稱(例如正體中文要選 Chinese),選好的會以 chip 呈現。 |
| 搜尋時間篩選器 | 否 | 無 | — | 只取近期結果,五選一:「一小時內」「一天內」「一週內」「一個月內」「一年內」。 |
| 國家 | 否 | 無 | — | 用來在地化搜尋結果的國家。可搜尋的下拉,選項是國家全名——打 TW 一個選項都不會出現,要打 Taiwan 才選得到(實際送出的是 ISO 3166-1 alpha-2 兩碼代碼)。 |
| 發布日期起始篩選器 | 否 | 無 | — | 結果的最早發布日期,格式 MM/DD/YYYY。 |
| 發布日期結束篩選器 | 否 | 無 | — | 結果的最晚發布日期。 |
| 最後更新日期起始篩選器 | 否 | 無 | — | 結果的最早最後更新日期。 |
| 最後更新日期結束篩選器 | 否 | 無 | — | 結果的最晚最後更新日期。 |
| 最大 Token 數 | 否 | 未勾選(勾選後 1024) | 1–131072 | 所有搜尋結果內容加起來的 token 總數上限。 |
| 每頁最大 Token 數 | 否 | 未勾選(勾選後 1024) | 1–131072 | 每一頁搜尋結果內容的 token 上限。 |
兩個 Token 上限的分工
「最大 Token 數」管總量、「每頁最大 Token 數」管單一頁面。想「多拿幾個來源、但每個只要摘要」就把每頁上限調小、總量維持;想「少數幾個來源但看多一點內容」就反過來。
Perplexity¶
較早的 Perplexity 做法,同樣結合大型語言模型與搜尋引擎提供具語意理解的回答。
新建議改用 Perplexity Agent
這一型仍可正常使用、既有設定也不必動,但 Perplexity 已經把主線移到 Agent API。新建立時請選 Perplexity Agent,可調的參數較完整。
適合:
- 已經在用這一型、不想改動既有設定。
選「Perplexity」後,表單會出現「API 金鑰」與「模型」,「進階設定」內有多個可細調回應行為的參數:

Perplexity 類型的主要欄位:
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| API 金鑰 | 是 | 無 | Perplexity API 金鑰,以遮罩方式輸入。 |
| 模型 | 是 | 無(需選擇) | 六選一:「快速」「低」「中」「高」「極限」五個 Agent API 的預設組合(說明同 Perplexity Agent 的預設組合),或 Sonar 這個模型。差別是預設組合一定會執行研究流程,而 Sonar 會自行決定要不要搜尋——所以選 Sonar 有可能拿到沒有來源的答案。 |
進階設定(摺疊區塊「進階設定」內,皆為選填)。下列數值參數各自有一個勾選框,沒勾即不送出——所以剛展開時這些數值框都是空白的,下表「預設」欄寫的數字是勾起來之後平台才帶進去的值(例如「溫度」勾起來會出現 0.2):
| 欄位 | 必填 | 預設 | 範圍 | 說明 |
|---|---|---|---|---|
| 系統提示詞 | 否 | 無 | — | 隨每次查詢送出的系統提示詞。搭配預設組合使用時,會取代預設組合內建的系統提示詞。 |
| 最大 Token 數 | 否 | 未勾選(勾選後 1024) | 1–131072 | 回應的最大 token 數。 |
| 溫度 | 否 | 未勾選(勾選後 0.2) | 0–1.9 | 數值越高回應越發散、越低越保守。上界是 1.9,Perplexity 已經不接受 2。 |
| Top P | 否 | 未勾選(勾選後 0.9) | 0–1 | 核採樣機率閾值。 |
| 搜尋網域篩選器 | 否 | 無 | 最多 20 筆 | 只從指定網域取結果,要排除就在網域前加 -;只填純網域名稱。填法(表格加列、超過 20 筆何時才報錯)與 Perplexity Agent 的同名欄位相同。 |
| 搜尋時間篩選器 | 否 | 無 | — | 只取近期結果,五選一:「一小時內」「一天內」「一週內」「一個月內」「一年內」。 |
| 搜尋上下文資訊量 | 否 | 少 | — | 搜尋帶入的上下文量,可選「少」「中」「多」。 |
打開舊的設定時可能跳出兩則提示
這一型的可用值變過,所以編輯以前建立的搜尋引擎時,平台會先幫你把值換成現在能用的,並在畫面上說明:
- 「Sonar 模型已由 Perplexity 下線,已自動切換為 ○○,請確認設定後儲存。」——原本選的
sonar/sonar-pro等模型已經下線,平台改指到現行的選項。 - 「Perplexity 已不接受溫度為 2,已自動調整為 1.9,請確認設定後儲存。」——原本填 2 的溫度被夾到上界。
兩則都只是先幫你改好畫面上的值,要按「儲存」才會真的存下去。看到提示就檢查一下那一欄,確認沒問題再存。
OpenAI¶
結合語言模型與即時網頁搜尋,提供具引用依據、具語意理解的精準回應。
適合:
- 希望搜尋結果被整理成有引用依據的語意回答。
- 已有 OpenAI API 金鑰。
選「OpenAI」後,表單會出現「API 金鑰」與「模型」,「進階設定」內可細調回應與在地化:

OpenAI 類型的主要欄位:
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| API 金鑰 | 是 | 無 | OpenAI API 金鑰,以遮罩方式輸入。 |
| 模型 | 是 | 無(需選擇) | 使用的模型,可選 GPT 4.1、GPT-4.1 mini、GPT-4o、GPT-4o mini、o4 mini。 |
進階設定(摺疊區塊「進階設定」內,皆為選填)。數值參數需先選好模型才能調整,且各有勾選開關,未勾選即不送出;其預設與範圍會依所選模型而異:
| 欄位 | 必填 | 範圍 | 說明 |
|---|---|---|---|
| 系統提示詞 | 否 | — | 給模型的系統層級指示。 |
| 最大 Token 數 | 否 | 最小 128,上限依模型而定(見下方 note) | 回應的最大 token 數。勾選後帶入 1024。 |
| 溫度 | 否 | 0–2 | 數值越高回應越發散、越低越保守。 |
| Top P | 否 | 0–1 | 核採樣機率閾值。 |
| Top K | 否 | 0–500 | 限制每步取樣的候選數,0 表示不限制。 |
| 搜尋上下文資訊量 | 否 | — | 搜尋帶入的上下文量,可選「少」「中」「多」,預設「少」。 |
| 使用者位置國家 | 否 | — | 使用者所在國,影響在地化結果。這是一個可搜尋的下拉,選項是國家全名——打 TW 一個選項都不會出現,要打 Taiwan 才選得到。(同一組的「使用者位置區域」「使用者位置城市」則是自由輸入的文字框。) |
| 使用者位置區域 | 否 | — | 使用者所在的區域/州。 |
| 使用者位置城市 | 否 | — | 使用者所在的城市。 |
「最大 Token 數」的上限依模型而定
最小值一律 128,上限則跟著「模型」變動——先選好模型,這一欄的範圍才會對應到正確的上限(也才點得動:沒選模型時這幾個數值欄位的勾選框都是灰的):
| 模型 | 「最大 Token 數」上限 |
|---|---|
GPT-4o、GPT-4o mini | 16384 |
GPT 4.1、GPT-4.1 mini | 32768 |
o4 mini | 100000 |
「溫度」「Top P」「Top K」三欄的範圍不隨模型改變。另外用「使用者位置」三欄可讓搜尋結果更貼近指定地區。
搜尋引擎詳細頁¶
建立完成後點進某個搜尋引擎,詳細頁上方有三個頁籤;下圖為 Google 搜尋引擎「一般」頁籤的「詳細資料」卡片,可看到 ID、名稱、標籤、類型與該類型的設定欄位、狀態、建立者、更新者與最後更新:

| 頁籤 | 內容 |
|---|---|
| 一般 | 搜尋引擎的基本資料:ID、名稱、標籤、類型,以及該類型的設定欄位(搜尋引擎 ID、關鍵字詞、進階參數等)、系統資訊、狀態、建立者、更新者與最後更新。可多選的欄位(例如「語言限制」)在這頁一律顯示 -,即使實際設過值也一樣——要確認設了什麼請進編輯表單看那些標籤。「API 金鑰」不會出現在這裡——不是遮成圓點,而是整列都沒有,所以在這頁找不到金鑰是正常的,不代表沒存進去。要確認金鑰有效請按卡片右上角的 驗證鈕。已經存進去的金鑰任何地方都看不到了(編輯表單裡那一格是唯讀的遮罩框,裡面那串字不是你的金鑰);要換一把金鑰,得先按遮罩框旁邊的「重設」鈕才打得進去,做法見金鑰欄位在編輯時要先按「重設」。 |
| 依賴資源 | 這個搜尋引擎用到的其他資源。 |
| 被依賴資源 | 反過來,有哪些資源用到這個搜尋引擎(例如以它為來源的搜尋任務或 Agent 搜尋工具)。 |
「詳細資料」卡片右上角的圖示鈕:編輯()、複製()、驗證()、刪除(),以及收合卡片的箭頭。其中「驗證」鈕是搜尋引擎特有的金鑰驗證入口,見下方使用效果。這顆鈕在 DuckDuckGo 的詳細頁上也會出現(滑過只寫「驗證」,不是「驗證 API 金鑰」),雖然它免金鑰、沒有金鑰可驗。
使用效果¶
搜尋引擎不能單獨執行,它的價值在於「被搜尋任務或 Agent 搜尋工具選用、即時上網查資料」。要確認金鑰設定正確,最直接的方式就是驗證 API 金鑰。
兩個驗證入口¶
需要金鑰的類型(Google、Perplexity、Perplexity Agent、Perplexity Search、OpenAI)有兩個驗證入口,做的事一樣(用目前填入的金鑰測試一次),位置與長相不同:
- 建立/編輯表單右上角的文字按鈕:字樣為「驗證 API 金鑰」(見上方各型表單截圖右上角)。
- 詳細頁「詳細資料」卡片右上角的圖示鈕:圖示為 (鑰匙加無線弧),滑過會顯示「驗證 API 金鑰」(見詳細頁截圖)。
DuckDuckGo 免金鑰,建立/編輯表單上的那顆文字鈕不會出現;但詳細頁那顆圖示鈕還在,滑過只寫「驗證」。
驗證結果¶
點下按鈕後,平台會用目前填入的金鑰去測試:
- 成功:畫面右下角跳出綠色提示「API 金鑰驗證成功!」,代表這把金鑰可以正常使用。
- 失敗:跳出紅色提示「API 金鑰驗證失敗!請檢查設定並重試。」,請回頭檢查金鑰是否正確、有沒有貼錯或過期。
建議在儲存前先驗證一次,確認金鑰有效再讓下游功能引用。
請先填好金鑰再驗證
需先把「API 金鑰」(Google 另含「Google 搜尋引擎 ID」、Perplexity/OpenAI 另含「模型」、Perplexity Agent 另含「預設組合」或「模型」至少一項)填好,按鈕才會真正去測試。還沒填完就按不會有驗證結果,而是在缺的那幾欄下方冒出紅字「此欄位為必填」——補齊之後再按一次即可。
驗證通過後,這個搜尋引擎就能在下游被選用:
- 搜尋引擎 (Search Engine) 任務:在工作流程的任務設定裡選這個搜尋引擎,執行時即時上網搜尋並回傳結果。
- Agent 的搜尋引擎工具:掛到 Agent 上,讓 Agent 對話時能自行決定何時上網查資料。
下一步¶
- 搜尋引擎 (Search Engine) 任務:在工作流程中實際使用搜尋引擎。
- 搜尋引擎工具:把搜尋引擎掛到 Agent 上。
- 連結器 (Connector):另一種把外部連線設定集中保管的資源。