> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# web_search - 联网搜索

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

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

<Tip>
  推荐通过 [Web 控制台](/zh/channels/web) 的「模型管理 → 搜索」面板可视化配置厂商与策略，无需手动编辑配置文件。
</Tip>

## 厂商

| 厂商       | 凭证                               | 申请入口                                                         |
| -------- | -------------------------------- | ------------------------------------------------------------ |
| 博查 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 theme={null}
{
  "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` 策略下配置了多个厂商时可见，用于单次切换厂商                                                              |

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