連網搜尋
Anyy 已有無需 Key 的預設 DuckDuckGo HTML 搜尋；如果希望使用某個付費服務或自行代管搜尋，再設定自訂 Backend。對話中的入口工具叫 web_search，是否呼叫由任務和可用工具共同決定。
接入一個自訂搜尋服務
進入 Dashboard → Tools → Web Search：
- 選擇 Provider；
- 需要時填寫 API Key；
- 核對或填寫 Endpoint；
- 點選 Test；
- 確認測試的就是目標 Backend 後再儲存。
測試會發出一次真實搜尋請求，可能消耗配額或產生費用。
也可以執行 CLI 精靈：
anyy tools websearch
按實際帳號或部署選擇後端
設定目錄提供以下 Backend：
| 選項 | web_search.provider |
|---|---|
| Firecrawl Cloud / Self-hosted Firecrawl | firecrawl（透過 Endpoint 區分） |
| Exa / Parallel / Tavily / SearXNG | exa / parallel / tavily / searxng |
| Brave Search Free Tier / Brave Search | brave-free / brave |
| Perplexity / Gemini Search / xAI Grok Search | perplexity / gemini / grok |
這是目前轉接器範圍，不代表所有外部帳號、方案或網路條件都已驗收。Gemini/Grok 搜尋後端獨立於對話模型協定；使用它們不會新增工作階段原生 API。
雲服務通常需要 Key。Self-hosted Firecrawl 與 SearXNG 需要能從 Gateway 存取的絕對 HTTP/HTTPS Endpoint。支援的 Key 會儲存為 Profile Secret 引用，不會把明文寫進 config.yaml。
Tavily 數量與內容選項
Tavily 額外提供：
| 選項 | 可用值 |
|---|---|
| Search Depth | basic 或 advanced |
| Maximum Results | 1 到 20，預設 10 |
| Include Images | 布林值，預設 false |
| Include Raw Content | 布林值，預設 false |
Advanced 可能消耗更多服務商資源。Profile 設定鍵依次為 search_depth、max_results、include_images、include_raw_content，位於 web_search.options 下；其他 Backend 不接受這些 Tavily 專屬選項。max_results 決定請求 Tavily 的數量，而模型工具的 limit 為 1–10，結果仍會按該限制裁剪。包含圖片的選項不保證聊天顯示圖片。
怎樣提出需要來源的問題
說明要查的最新事實，以及是否需要連結：
查一下这个项目最近的稳定版本和发布日期，优先看官方发布说明，给出能核对的来源链接。
Anyy 會根據問題決定是否使用搜尋工具，結果受目前 Backend 能力限制。搜尋只能找到候選資料，不能自動把不可信網頁變成權威來源。
技術、法律、醫療或財務問題應明確要求官方/一手來源，重要結論仍需自己核驗。
切換開關控制什麼
在 Dashboard → Tools → Web Search 使用切換開關啟用或停用自訂 Backend。web_search.enabled: false 或沒有設定 provider 時，web_search 使用預設 DuckDuckGo，不代表關閉所有連網。要讓某工作階段不能搜尋，應透過其工具選擇排除 web_search；web_fetch 和 web_extract 也是獨立工具。
切換 Provider 後應輸入對應認證資料並重新測試；舊 Endpoint 或舊選項的 Verification 不會被當作新 Backend 的驗證結果。已啟用自訂 Backend 回傳錯誤時，不會靜默切回預設搜尋。預設 DuckDuckGo 可能回傳防止自動化存取的驗證，此時 Anyy 報告搜尋不可用，而不把挑戰頁面當作結果。
常見問題
| 現象 | 檢查項 |
|---|---|
| 測試認證失敗 | 更換 Key，並確認帳號/方案具有該產品權限 |
| 自行代管服務無法連線 | 使用 Gateway 主機可以存取的絕對 URL |
| 測試成功但聊天不用搜尋 | 確認自訂 Backend 已啟用，且工作階段實際暴露 web_search 工具 |
| 關閉搜尋後仍存取 DuckDuckGo | 關閉的是自訂 Backend；應從工作階段工具選擇中排除 web_search |
| Tavily 參數被拒絕 | Depth 只能是 basic/advanced，數量為 1–20 |
| 結果品質或時效不足 | 縮小 Query 範圍、要求一手來源，或更換合適 Backend |