docs/tools/web-search.mdx
搜索互联网获取实时信息、新闻、研究等内容。支持博查、百度千帆、智谱、LinkAI 四个后端,配置任意一家即可使用。
<Tip> 推荐通过 [Web 控制台](/channels/web) 的「模型管理 → 搜索」面板可视化配置厂商与策略,无需手动编辑配置文件。 </Tip>| 厂商 | 凭证 | 申请入口 |
|---|---|---|
| 博查 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 策略下配置了多个厂商时可见,用于单次切换厂商 |