> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/pre-basic/websearch.md).

# 聯網模式

{% hint style="info" %}
聯網模式會令 AI 喺回答前先去搜尋最新內容，適合以下場景：

* **時效性資訊**：今日／本週／頭先發生嘅新聞、價格、匯率等
* **實時數據**：天氣、股價、商品存貨等動態數值
* **新興知識**：啱啱出現嘅工具、概念、技術
  {% endhint %}

## 點樣開啟聯網

喺對話輸入框嘅工具欄入面撳 🌐 **小地球** 圖示，就可以對當前對話開啟聯網。

<figure><img src="/files/6c3c6f917f726a36e32aebd03cf21df3c8b80a1f" alt=""><figcaption><p>撳地球圖示開啟聯網</p></figcaption></figure>

<figure><img src="/files/f505bff2fe9513510219d01640b4ffa4b9c6657e" alt=""><figcaption><p>開啟狀態</p></figcaption></figure>

## 聯網嘅兩條技術路徑

Cherry Studio 透過**兩種方式**實現聯網，會根據你揀嘅模型自動決定：

### 路徑 1：模型自帶聯網功能（推薦）

部分大模型服務商喺自己模型入面**原生整合咗搜尋能力**。呢類模型喺模型名旁邊會顯示**小地球圖示 🌐**。

開啟對話聯網後，AI 會直接調用模型自身嘅搜尋能力，**唔使任何額外設定**。

<figure><img src="/files/1ecc4767a302219367476843441bb477f28166af" alt=""><figcaption><p>模型名後面嘅小地球圖示</p></figcaption></figure>

喺 `設定 → 模型服務` 入面都可以據此分辨。

<figure><img src="/files/b85526358d9e9d66b5f545ded67917074d8ce010" alt=""><figcaption></figcaption></figure>

**已知支援原生聯網嘅模型／服務商**：

* Google Gemini（部分版本）
* OpenRouter（全部模型支援）
* 騰訊混元
* 智譜 AI
* 阿里雲百煉（部分模型）
* xAI Grok

{% hint style="info" %}
仲有少數模型就算冇顯示小地球圖示，都可以聯網（視乎服務商配置）。例如 [火山引擎接入聯網](/docs/zhong-wen-fan-ti/pre-basic/websearch/volcengine.md) 入面介紹嘅一類情況。
{% endhint %}

### 路徑 2：透過外部搜尋服務（用於唔帶聯網功能嘅模型）

如果你揀嘅模型本身唔帶聯網（多數開源／經典模型都係咁），Cherry Studio 會**調用已配置好嘅外部搜尋服務**，將搜尋結果作為上下文餵俾模型。

打開 `設定 → 網絡搜尋` 新增並啟用任何一家搜尋服務。Cherry Studio 內置支援：

| 搜尋服務                      | 類型    | 備註                                                                             |
| ------------------------- | ----- | ------------------------------------------------------------------------------ |
| **Tavily**                | 雲端    | 老牌、免費額度夠日常用 [→ 註冊教學](/docs/zhong-wen-fan-ti/pre-basic/websearch/tavily.md)     |
| **Bocha（博查）**             | 雲端    | 國內存取友好，中文場景效果好                                                                 |
| **Exa**                   | 雲端    | 偏學術／技術內容                                                                       |
| **Exa MCP**               | 雲端    | Exa 嘅 MCP 接口版                                                                  |
| **Zhipu（智譜）**             | 雲端    | 智譜自家嘅搜尋 API                                                                    |
| **Querit**                | 雲端    | 國內存取友好                                                                         |
| **SearXNG**               | 自部署   | 開源元搜尋引擎，可完全本地化 [→ 部署教學](/docs/zhong-wen-fan-ti/pre-basic/websearch/searxng.md) |
| **Google / Bing / Baidu** | 本地瀏覽器 | 直接打開瀏覽器搜尋頁，**唔讀取內容回傳俾 AI**，只作輔助搵資料                                             |

#### 首次啟用 Tavily（最常見嘅零配置選擇）

1. 喺對話框撳 🌐 之後，如果發現未配置任何外部搜尋服務，會彈窗提示
2. 撳 **去設定** → 進入網絡搜尋設定
3. 揀 Tavily，撳 **取得密鑰** 跳轉去 Tavily 官網註冊
4. 喺 Tavily 控制台建立 API Key
5. 複製 Key 再填返去 Cherry Studio

<figure><img src="/files/42e4debb897599f64c2e8b21249202a330a2eeaa" alt=""><figcaption><p>彈窗：去設定</p></figcaption></figure>

<figure><img src="/files/b08f95874939e3784fd8e6389b0a9ad16e28fd83" alt=""><figcaption><p>撳取得密鑰</p></figcaption></figure>

<figure><img src="/files/b08f95874939e3784fd8e6389b0a9ad16e28fd83" alt=""><figcaption><p>跳轉去取得密鑰</p></figcaption></figure>

<figure><img src="/files/97f0aaf0aa8602a5cb46b8d8ec1ca768d834cc4a" alt=""><figcaption><p>複製 API Key</p></figcaption></figure>

<figure><img src="/files/fc9ff688c9c1a746dfaa17059f31c9ffdc59fdab" alt=""><figcaption><p>填返入 API Key</p></figcaption></figure>

詳細註冊流程睇 [Tavily 聯網登入註冊教學](/docs/zhong-wen-fan-ti/pre-basic/websearch/tavily.md)。

{% hint style="warning" %}
Tavily 免費額度有每月調用次數限制，超出之後要收費。如長期重度使用，建議改用 [SearXNG 本地部署](/docs/zhong-wen-fan-ti/pre-basic/websearch/searxng.md) 或者 Bocha 等其他方案。
{% endhint %}

## 搜尋結果黑名單

唔想某啲唔可靠嘅網站出現喺搜尋結果入面？參考 [網絡搜尋黑名單設定](/docs/zhong-wen-fan-ti/pre-basic/websearch/blacklist.md) 將佢哋屏蔽掉。

## 免費聯網模式

如果你唔想花一分錢都想用到搜尋能力，睇 [免費聯網模式](/docs/zhong-wen-fan-ti/pre-basic/websearch/free-search.md)。

## 工作機制

無論行邊條路徑，對話流程都係：

1. 你問「今日上海天氣點呀？」
2. Cherry Studio 先將問題發畀搜尋服務
3. 搜尋服務回傳 N 條相關網頁摘要
4. Cherry Studio 將呢啲摘要砌埋入提示詞再發畀 AI 模型
5. AI 根據實時數據回答你

<figure><img src="/files/ce03e86de4242e9ded27d110f9efd45cef73e233" alt=""><figcaption><p>聯網搜尋結果示例</p></figcaption></figure>

<figure><img src="/files/f9800d05a3ad2bc178883d88c934ab44bf535469" alt=""><figcaption><p>聯網回答示例</p></figcaption></figure>

***

### 💡 獲取幫助同提交反饋

如果您喺配置或使用過程中遇到任何疑問、Bug 或有功能改進建議，請參考 [反饋同建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/zhong-wen-fan-ti/pre-basic/websearch.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.