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)后限制解除,且无需开启匿名模式。
路由策略
{
"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。