联网搜索
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 |