web_search - 联网搜索

搜索互联网获取实时信息、新闻、研究等内容。支持博查、百度千帆、智谱、LinkAI 四个后端，配置任意一家即可使用。

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

厂商

厂商	凭证	申请入口
博查 Bocha	`tools.web_search.bocha_api_key`	博查开放平台
百度千帆	复用 `qianfan_api_key`	千帆控制台
智谱 Zhipu	复用 `zhipu_ai_api_key`	智谱开放平台
LinkAI	复用 `linkai_api_key`	LinkAI 控制台

除博查需要单独的 bocha_api_key 外，其他三家直接复用对应模型的 API Key，配好模型即同时获得搜索能力。

{
  "tools": {
    "web_search": {
      "strategy": "auto",
      "provider": ""
    }
  }
}

auto（默认）：由 Agent 在已配置的厂商中智能选择，并可在一次任务中多次调用、切换不同厂商以获取更全面的结果；未指定时按 bocha → qianfan → zhipu → linkai 顺序兜底。
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` 策略下配置了多个厂商时可见，用于单次切换厂商

四家凭证均未配置时，该工具不会注册到 Agent。