docs: update models and channels doc

This commit is contained in:
zhayujie
2026-05-22 10:10:07 +08:00
parent 90773ab69f
commit 36b913124b
23 changed files with 783 additions and 262 deletions

View File

@@ -1,32 +1,51 @@
---
title: web_search - 联网搜索
description: 搜索互联网获取实时信息
description: 搜索互联网获取实时信息,支持多个搜索厂商
---
搜索互联网获取实时信息、新闻、研究等内容。支持两个搜索后端,自动选择可用的后端
搜索互联网获取实时信息、新闻、研究等内容。支持博查、百度千帆、智谱、LinkAI 四个后端,配置任意一家即可使用
## 依赖
<Tip>
推荐通过 [Web 控制台](/channels/web) 的「模型管理 → 搜索」面板可视化配置厂商与策略,无需手动编辑配置文件。
</Tip>
需要配置至少一个搜索 API Key通过 `env_config` 工具或工作空间 `.env` 文件配置):
## 厂商
| 后端 | 环境变量 | 优先级 | 获取方式 |
| --- | --- | --- | --- |
| 博查搜索 | `BOCHA_API_KEY` | 优先使用 | [博查开放平台](https://open.bochaai.com/) |
| LinkAI 搜索 | `LINKAI_API_KEY` | 可选 | [LinkAI 控制台](https://link-ai.tech/console/interface) |
| 厂商 | 凭证 | 申请入口 |
| --- | --- | --- |
| 博查 Bocha | `tools.web_search.bocha_api_key` | [博查开放平台](https://open.bochaai.com/) |
| 百度千帆 | 复用 `qianfan_api_key` | [千帆控制台](https://cloud.baidu.com/doc/qianfan/s/2mh4su4uy) |
| 智谱 Zhipu | 复用 `zhipu_ai_api_key` | [智谱开放平台](https://docs.bigmodel.cn/cn/guide/tools/web-search) |
| LinkAI | 复用 `linkai_api_key` | [LinkAI 控制台](https://link-ai.tech/console/interface) |
## 参数
除博查需要单独的 `bocha_api_key` 外,其他三家直接复用对应模型的 API Key配好模型即同时获得搜索能力。
## 路由策略
```json
{
"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` |
| `count` | integer | 否 | 返回结果数量150默认 10 |
| `freshness` | string | 否 | 时间范围:`noLimit`(默认)、`oneDay`、`oneWeek`、`oneMonth`、`oneYear`,或日期范围如 `2025-01-01..2025-02-01` |
| `summary` | boolean | 否 | 是否返回页面摘要(默认 false |
## 使用场景
当用户询问最新信息、需要事实核查或获取实时数据时Agent 会自动调用此工具。
| `provider` | string | 否 | `auto` 策略下配置了多个厂商时可见,用于单次切换厂商 |
<Note>
如果未配置任何搜索 API Key该工具不会被加载
四家凭证均未配置时,该工具不会注册到 Agent
</Note>