首页 / 文档 / 工具 / web_search - 联网搜索

web_search - 联网搜索

搜索互联网获取实时信息,支持多个搜索厂商

搜索互联网获取实时信息、新闻、研究等内容。支持博查、百度千帆、智谱、LinkAI、AnySearch、Serply、Tavily、SearXNG、Keenable 九个后端。Keenable 另提供需手动开启的匿名模式(无需密钥);各厂商配置凭证(或开启匿名模式)后即可使用。

提示

推荐通过 Web 控制台 的「模型管理 → 搜索」面板可视化配置厂商与策略,无需手动编辑配置文件。

厂商

厂商 凭证 申请入口
博查 Bocha tools.web_search.bocha_api_key 博查开放平台
百度千帆 复用 qianfan_api_key 千帆控制台
智谱 Zhipu 复用 zhipu_ai_api_key 智谱开放平台
LinkAI 复用 linkai_api_key LinkAI 控制台
AnySearch 可选配置项 tools.web_search.anysearch_api_key,或设置 anysearch_anonymous: true 免密钥使用 AnySearch 控制台
Serply tools.web_search.serply_api_key Serply(文档)
Tavily tools.web_search.tavily_api_key Tavily
SearXNG tools.web_search.searxng_url(自托管实例 URL,无需 API Key) SearXNG
Keenable 可选配置项 tools.web_search.keenable_api_key,或设置 keenable_anonymous: true 免密钥使用 Keenable

博查、Serply、Tavily 需要单独配置专用密钥;智谱、百度千帆、LinkAI 直接复用对应模型的 API Key,配好模型即同时获得搜索能力。SearXNG 为自托管方案,只需配置实例 URL。AnySearch 需手动开启匿名模式:将 tools.web_search.anysearch_anonymous 设为 true(或在控制台「搜索」面板留空密钥保存)后即可免密钥调用;配置 tools.web_search.anysearch_api_key(未配置时回退到环境变量 ANYSEARCH_API_KEY)后无需开启匿名模式,额度与权限以 AnySearch 服务端为准。Keenable 需手动开启:将 tools.web_search.keenable_anonymous 设为 true(或在控制台「搜索」面板留空密钥保存)后调用公共接口,按 IP 限流(10 次/秒、1000 次/小时);配置可选的 keenable_api_key(或 KEENABLE_API_KEY)后限制解除,且无需开启匿名模式。

路由策略

json
{
  "tools": {
    "web_search": {
      "strategy": "auto",
      "provider": ""
    }
  }
}
  • auto(默认):由 Agent 在已配置的厂商中智能选择,并可在一次任务中多次调用、切换不同厂商以获取更全面的结果;未指定时按 bocha → qianfan → zhipu → linkai → anysearch → serply → tavily → searxng → keenable 顺序兜底。

  • fixed:固定使用 provider 指定的厂商;该厂商凭证缺失时自动回落到 auto 顺序。

工具参数

参数 类型 必填 说明
query string 是 搜索关键词
count integer 否 返回结果数量(1–50,默认 10)
freshness string 否 时间范围:noLimit(默认)、oneDay、oneWeek、oneMonth、oneYear,或日期范围如 2025-01-01..2025-02-01
summary boolean 否 是否返回页面摘要(默认 false)
provider string 否 auto 策略下配置了多个厂商时可见,用于单次切换厂商

九家厂商均未配置(既无密钥、无实例 URL,也未开启匿名模式)时,该工具不会注册到 Agent。