docs: simplify web search documentation to match upstream style

piexian · piexian · commit 8e0a7232707f · 2026-04-19T15:02:22.000+08:00
diff --git a/docs/en/use/websearch.md b/docs/en/use/websearch.md
@@ -1,3 +1,4 @@
+
 # Web Search
 
 The web search feature gives large language models internet retrieval capability for recent information, which can improve response accuracy and reduce hallucinations to some extent.
@@ -19,120 +20,26 @@ AstrBot currently supports 5 web search providers: `Tavily`, `BoCha`, `Baidu AI
 
 Go to `Configuration`, scroll down to find Web Search, where you can select `Tavily`, `BoCha`, `Baidu AI Search`, `Brave`, or `Exa`.
 
-If you use Tavily as your web search source, you will get a better experience optimization on AstrBot ChatUI, including citation source display and more:
-
-![](https://files.astrbot.app/docs/source/images/websearch/image1.png)
-
-## Tavily
-
-Go to [Tavily](https://app.tavily.com/home) to get an API key, then fill it in the corresponding configuration item.
-
-To use a proxy or self-hosted instance, modify the `Tavily API Base URL` configuration item.
-
-Tavily exposes two tools:
-
-### Search (`web_search_tavily`)
-
-| Parameter | Type | Required | Default | Description |
-|---|---|---|---|---|
-| `query` | string | Yes | - | Search query |
-| `max_results` | number | No | 7 | Maximum number of results to return. Range: 5-20 |
-| `search_depth` | string | No | `basic` | Search depth. Must be `basic` or `advanced` |
-| `topic` | string | No | `general` | Search topic. Must be `general` or `news` |
-| `days` | number | No | 3 | Number of days back from today to include. Only available when `topic` is `news` |
-| `time_range` | string | No | - | Time range for results. Must be `day`, `week`, `month`, or `year` |
-| `start_date` | string | No | - | Start date in `YYYY-MM-DD` format |
-| `end_date` | string | No | - | End date in `YYYY-MM-DD` format |
-| `timeout` | number | No | 30 | Request timeout in seconds. Minimum is 30 |
-
-### Extract Web Page (`tavily_extract_web_page`)
-
-| Parameter | Type | Required | Default | Description |
-|---|---|---|---|---|
-| `url` | string | Yes | - | The URL to extract content from |
-| `extract_depth` | string | No | `basic` | Extraction depth. Must be `basic` or `advanced` |
-| `timeout` | number | No | 30 | Request timeout in seconds. Minimum is 30 |
-
-## Baidu AI Search
-
-Go to the [BCE Console](https://console.bce.baidu.com/iam/#/iam/apikey/list) to get an API key, then fill it in the `websearch_baidu_app_builder_key` configuration item.
+### Tavily
 
-Baidu AI Search exposes one tool:
+Go to [Tavily](https://app.tavily.com/home) to get an API Key, then fill it in the corresponding configuration item.
 
-### Search (`web_search_baidu`)
+### BoCha
 
-| Parameter | Type | Required | Default | Description |
-|---|---|---|---|---|
-| `query` | string | Yes | - | Search query |
-| `top_k` | number | No | 10 | Number of web results to return. Maximum 50 |
-| `search_recency_filter` | string | No | - | Time filter. Must be `week`, `month`, `semiyear`, or `year` |
-| `site` | string | No | - | Restrict search to specific sites, separated by `,` or `\|` |
-| `timeout` | number | No | 30 | Request timeout in seconds. Minimum is 30 |
+Get an API Key from the BoCha platform, then fill it in the corresponding configuration item.
 
-## BoCha
+### Baidu AI Search
 
-Go to [BoCha](https://www.bocha.ai) to get an API key, then fill it in the corresponding configuration item.
+Get an API Key from Baidu Qianfan APP Builder, then fill it in the corresponding configuration item.
 
-BoCha exposes one tool:
+### Brave
 
-### Search (`web_search_bocha`)
+Get an API Key from Brave Search, then fill it in the corresponding configuration item.
 
-| Parameter | Type | Required | Default | Description |
-|---|---|---|---|---|
-| `query` | string | Yes | - | Search query |
-| `freshness` | string | No | `noLimit` | Time range filter. Supported values: `noLimit`, `oneDay`, `oneWeek`, `oneMonth`, `oneYear`, `YYYY-MM-DD..YYYY-MM-DD`, or `YYYY-MM-DD` |
-| `summary` | boolean | No | `false` | Whether to include a summary for each result |
-| `include` | string | No | - | Domains to include. Multiple domains separated by `\|` or `,` |
-| `exclude` | string | No | - | Domains to exclude. Multiple domains separated by `\|` or `,` |
-| `count` | number | No | 10 | Number of results to return. Range: 1-50 |
-| `timeout` | number | No | 30 | Request timeout in seconds. Minimum is 30 |
+### Exa
 
-## Brave
+Go to [Exa](https://dashboard.exa.ai) to get an API Key, then fill it in the corresponding configuration item.
 
-Go to Brave Search to get an API key, then fill it in the corresponding configuration item.
-
-Brave exposes one tool:
-
-### Search (`web_search_brave`)
-
-| Parameter | Type | Required | Default | Description |
-|---|---|---|---|---|
-| `query` | string | Yes | - | Search query |
-| `count` | number | No | 10 | Number of results to return. Range: 1-20 |
-| `country` | string | No | `US` | Country code for region-specific results |
-| `search_lang` | string | No | `zh-hans` | Brave language code |
-| `freshness` | string | No | - | Time range. Must be `day`, `week`, `month`, or `year` |
-| `timeout` | number | No | 30 | Request timeout in seconds. Minimum is 30 |
-
-## Exa
-
-Go to [Exa](https://dashboard.exa.ai) to get an API key, then fill it in the corresponding configuration item.
-
-To use a proxy or self-hosted instance, modify the `Exa API Base URL` configuration item.
-
-Exa exposes three tools:
-
-### Search (`web_search_exa`)
-
-| Parameter | Type | Required | Default | Description |
-|---|---|---|---|---|
-| `query` | string | Yes | - | Search query |
-| `max_results` | number | No | 10 | Maximum number of results to return. Range: 1-100 |
-| `search_type` | string | No | `auto` | Search type. Must be `auto`, `neural`, `fast`, `instant`, or `deep` |
-| `category` | string | No | - | Vertical category. Supported values: `company`, `people`, `research paper`, `news`, `personal site`, `financial report` |
-| `timeout` | number | No | 30 | Request timeout in seconds. Minimum is 30 |
-
-### Content Extraction (`exa_extract_web_page`)
-
-| Parameter | Type | Required | Default | Description |
-|---|---|---|---|---|
-| `url` | string | Yes | - | The URL to extract content from |
-| `timeout` | number | No | 30 | Request timeout in seconds. Minimum is 30 |
-
-### Find Similar (`exa_find_similar`)
+If you use Tavily as your web search source, you will get a better experience optimization on AstrBot ChatUI, including citation source display and more:
 
-| Parameter | Type | Required | Default | Description |
-|---|---|---|---|---|
-| `url` | string | Yes | - | The URL to find similar content for |
-| `max_results` | number | No | 10 | Maximum number of results to return. Range: 1-100 |
-| `timeout` | number | No | 30 | Request timeout in seconds. Minimum is 30 |
+![](https://files.astrbot.app/docs/source/images/websearch/image1.png)
diff --git a/docs/zh/use/websearch.md b/docs/zh/use/websearch.md
@@ -19,120 +19,26 @@ AstrBot 当前支持 5 种网页搜索源接入方式：`Tavily`、`BoCha`、`
 
 进入 `配置`，下拉找到网页搜索，你可选择 `Tavily`、`BoCha`、`百度 AI 搜索`、`Brave` 或 `Exa`。
 
-如果你使用 Tavily 作为网页搜索源，在 AstrBot ChatUI 上会获得更好的引用来源展示体验：
+### Tavily
 
-![](https://files.astrbot.app/docs/source/images/websearch/image1.png)
-
-## Tavily
-
-前往 [Tavily](https://app.tavily.com/home) 获取 API Key，然后填写在相应配置项中。
-
-如需使用代理或自建实例，可修改 `Tavily API Base URL` 配置项。
-
-Tavily 提供两个工具：
-
-### 搜索（`web_search_tavily`）
-
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|---|---|---|---|---|
-| `query` | string | 是 | - | 搜索关键词 |
-| `max_results` | number | 否 | 7 | 返回最大结果数，范围 5-20 |
-| `search_depth` | string | 否 | `basic` | 搜索深度，可选 `basic` 或 `advanced` |
-| `topic` | string | 否 | `general` | 搜索主题，可选 `general` 或 `news` |
-| `days` | number | 否 | 3 | 向前追溯的天数，仅 `topic=news` 时生效 |
-| `time_range` | string | 否 | - | 时间范围，可选 `day`、`week`、`month`、`year` |
-| `start_date` | string | 否 | - | 起始日期，格式 `YYYY-MM-DD` |
-| `end_date` | string | 否 | - | 结束日期，格式 `YYYY-MM-DD` |
-| `timeout` | number | 否 | 30 | 请求超时时间（秒），最小 30 |
-
-### 网页内容提取（`tavily_extract_web_page`）
-
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|---|---|---|---|---|
-| `url` | string | 是 | - | 要提取内容的网页 URL |
-| `extract_depth` | string | 否 | `basic` | 提取深度，可选 `basic` 或 `advanced` |
-| `timeout` | number | 否 | 30 | 请求超时时间（秒），最小 30 |
-
-## 百度 AI 搜索
-
-前往 [百度智能云控制台](https://console.bce.baidu.com/iam/#/iam/apikey/list) 获取 API Key，然后填写在 `websearch_baidu_app_builder_key` 配置项中。
-
-百度 AI 搜索提供一个工具：
-
-### 搜索（`web_search_baidu`）
+前往 [Tavily](https://app.tavily.com/home) 获取 API Key，然后填写在相应的配置项。
 
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|---|---|---|---|---|
-| `query` | string | 是 | - | 搜索关键词 |
-| `top_k` | number | 否 | 10 | 返回的网页结果数量，最大 50 |
-| `search_recency_filter` | string | 否 | - | 时间范围，可选 `week`、`month`、`semiyear`、`year` |
-| `site` | string | 否 | - | 限定搜索站点，多个站点可用 `,` 或 `\|` 分隔 |
-| `timeout` | number | 否 | 30 | 请求超时时间（秒），最小 30 |
+### BoCha
 
-## BoCha
+前往 BoCha 平台获取 API Key，然后填写在相应的配置项。
 
-前往 [BoCha](https://www.bocha.ai) 获取 API Key，然后填写在相应配置项中。
+### 百度 AI 搜索
 
-BoCha 提供一个工具：
+前往百度千帆 APP Builder 获取 API Key，然后填写在相应的配置项。
 
-### 搜索（`web_search_bocha`）
+### Brave
 
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|---|---|---|---|---|
-| `query` | string | 是 | - | 搜索关键词 |
-| `freshness` | string | 否 | `noLimit` | 时间范围筛选，可选 `noLimit`、`oneDay`、`oneWeek`、`oneMonth`、`oneYear`、`YYYY-MM-DD..YYYY-MM-DD` 或 `YYYY-MM-DD` |
-| `summary` | boolean | 否 | `false` | 是否返回每条结果的摘要 |
-| `include` | string | 否 | - | 仅搜索指定域名，多个域名用 `\|` 或 `,` 分隔 |
-| `exclude` | string | 否 | - | 排除指定域名，多个域名用 `\|` 或 `,` 分隔 |
-| `count` | number | 否 | 10 | 返回结果数量，范围 1-50 |
-| `timeout` | number | 否 | 30 | 请求超时时间（秒），最小 30 |
+前往 Brave Search 获取 API Key，然后填写在相应的配置项。
 
-## Brave
+### Exa
 
-前往 Brave Search 获取 API Key，然后填写在相应配置项中。
+前往 [Exa](https://dashboard.exa.ai) 获取 API Key，然后填写在相应的配置项。
 
-Brave 提供一个工具：
+如果你使用 Tavily 作为网页搜索源，在 AstrBot ChatUI 上会获得更好的体验优化，包括引用来源展示等：
 
-### 搜索（`web_search_brave`）
-
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|---|---|---|---|---|
-| `query` | string | 是 | - | 搜索关键词 |
-| `count` | number | 否 | 10 | 返回结果数量，范围 1-20 |
-| `country` | string | 否 | `US` | 国家/地区代码 |
-| `search_lang` | string | 否 | `zh-hans` | 搜索语言代码 |
-| `freshness` | string | 否 | - | 时间范围，可选 `day`、`week`、`month`、`year` |
-| `timeout` | number | 否 | 30 | 请求超时时间（秒），最小 30 |
-
-## Exa
-
-前往 [Exa](https://dashboard.exa.ai) 获取 API Key，然后填写在相应配置项中。
-
-如需使用代理或自建实例，可修改 `Exa API Base URL` 配置项。
-
-Exa 提供三个工具：
-
-### 搜索（`web_search_exa`）
-
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|---|---|---|---|---|
-| `query` | string | 是 | - | 搜索关键词 |
-| `max_results` | number | 否 | 10 | 返回最大结果数，范围 1-100 |
-| `search_type` | string | 否 | `auto` | 搜索类型，可选 `auto`、`neural`、`fast`、`instant`、`deep` |
-| `category` | string | 否 | - | 垂直类别，可选 `company`、`people`、`research paper`、`news`、`personal site`、`financial report` |
-| `timeout` | number | 否 | 30 | 请求超时时间（秒），最小 30 |
-
-### 内容提取（`exa_extract_web_page`）
-
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|---|---|---|---|---|
-| `url` | string | 是 | - | 要提取内容的网页 URL |
-| `timeout` | number | 否 | 30 | 请求超时时间（秒），最小 30 |
-
-### 相似链接（`exa_find_similar`）
-
-| 参数 | 类型 | 必填 | 默认值 | 说明 |
-|---|---|---|---|---|
-| `url` | string | 是 | - | 用于查找相似内容的网页 URL |
-| `max_results` | number | 否 | 10 | 返回最大结果数，范围 1-100 |
-| `timeout` | number | 否 | 30 | 请求超时时间（秒），最小 30 |
+![](https://files.astrbot.app/docs/source/images/websearch/image1.png)
