Skip to content

支持配置 WebSearch 搜索后端:允许自带 Exa Key 或替换搜索服务 #2684

Description

@xzldragones

现象

自 PR #124 起,WebSearch 切换为内置的官方托管 Exa 实现,所有用户的搜索请求都经过同一个共享端点:

  • 有自己 Exa API Key 的用户无法绑定自有配额,只能消耗共享配额;
  • 共享端点的限流由全体用户共同承担,多会话并行 / 大批量联网检索(多会话并行研究、MiniApp agent 调研等)时容易触发限流报错,且报错信息难以区分是配额耗尽还是网络问题;
  • 部分网络环境下访问 Exa 端点不稳定或不可达,用户无法切换到替代搜索服务(Tavily、SerpAPI、自建服务等)。

建议

在设置中提供可选的搜索后端配置(默认仍走内置端点,保持零配置体验):

  1. 最小改动:支持填入自己的 Exa API Key,搜索请求直连 Exa API,配额绑定用户自有账号;
  2. 更通用:抽象搜索 provider 接口,支持 Exa / Tavily / 自定义 HTTP 搜索服务,按 provider 配置 key 与端点;
  3. 改进限流 / 鉴权失败的错误提示,让用户能区分「共享端点配额耗尽」「网络不可达」「key 无效」。

相关背景

影响范围

  • 设置 UI(新增可选搜索后端配置项 + i18n)
  • WebSearch 工具实现(provider 抽象 / key 透传)
  • 限流与鉴权错误的报错文案

复现

多会话并行联网研究场景下高频触发 WebSearch,共享端点配额耗尽时出现限流报错,当前没有任何设置项可以切换为自己的 Exa Key 或其他搜索后端。

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions