docs/en/tools/web-search.mdx
Search the internet for real-time information, news, research, and more. Supports four backends — Bocha, Baidu Qianfan, Zhipu, and LinkAI — and works once any one of them is configured.
<Tip> It is recommended to configure providers and routing strategy visually from the "Model Management → Search" panel in the [Web Console](/channels/web), without manually editing the configuration file. </Tip>| Provider | Credential | Apply |
|---|---|---|
| Bocha | tools.web_search.bocha_api_key | Bocha Open Platform |
| Baidu Qianfan | Reuses qianfan_api_key | Qianfan Console |
| Zhipu | Reuses zhipu_ai_api_key | Zhipu Open Platform |
| LinkAI | Reuses linkai_api_key | LinkAI Console |
Except for Bocha which requires a dedicated bocha_api_key, the other three reuse the corresponding model's API key — configuring the model automatically grants search capability.
{
"tools": {
"web_search": {
"strategy": "auto",
"provider": ""
}
}
}
auto (default): the Agent intelligently picks among configured providers and may call multiple providers in a single task to gather more comprehensive results; when none is specified, falls back through bocha → qianfan → zhipu → linkai.fixed: always use the provider specified in provider; falls back to the auto order if that provider's credentials are missing.| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search keywords |
count | integer | No | Number of results (1–50, default 10) |
freshness | string | No | Time range: noLimit (default), oneDay, oneWeek, oneMonth, oneYear, or date range like 2025-01-01..2025-02-01 |
summary | boolean | No | Whether to return page summaries (default false) |
provider | string | No | Available when multiple providers are configured under the auto strategy; used to switch provider for a single call |