> 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/en-us/pre-basic/websearch/free-search.md).

# Free Web-enabled Mode

Cherry Studio has built-in powerful web search functionality, allowing you to fetch the latest online information in real time during conversations. Follow these steps to easily enable and use this feature:

***

### Enable steps

1. **Open the Settings menu**
   * Launch the Cherry Studio app.
   * In the main interface, find and click **Settings** the icon or menu option; located in the lower-left corner of the interface.\\
2. **Access web search configuration**
   * In the Settings menu, find and select **Web Search** settings.\\
3. **Choose your search engine**
   * On the "Web Search" settings page, find the **Search provider** option.
   * Click this option and choose your preferred search engine from the dropdown list or options:
     * **Bing**: A search engine provided by Microsoft, generally accessible well worldwide.
     * **Baidu**: A search engine commonly used by Chinese users, with broad content coverage in mainland China.
     * **Google**: A leading global search engine that provides extensive international information.
   * **⚠️ Important Note**: If you choose **Google** as your search engine, please make sure your network environment can **access Google services smoothly**. If you encounter connection issues, it is recommended to try switching to another provider or check your network proxy settings.\\
4. **Confirm search enhancement mode**
   * Look for the option named **Search Enhancement Mode** option.
   * Make sure the toggle or checkbox for this option is in the **enabled** enabled
5. **Activate web search in the chat interface**
   * After completing the above settings, return to Cherry Studio's main **chat interface**.
   * in the \*\*text box toolbar\*\* where you enter messages.
   * Find the **Web Search** 🌐 icon on the toolbar.
   * **Click the icon** to enable web search. Once enabled, the icon will **be highlighted** , indicating that the message you send will trigger a web search.\\
6. **Start searching!**
   * Make sure the web search icon is in the **enabled state** After that, type in the **keywords, questions, or instructions**.
   * you want to query in the input box and send the message as usual. Cherry Studio will automatically call the search engine you selected to perform the search and integrate the fetched online information into its reply.\\

***

### ✨ Important Notes and Tips

* **Number of search results**:
  * By default, Cherry Studio may be configured to return **about 6** search result summaries, which is a setting that balances speed and information volume.
  * If options are available in the settings, you can try **increasing the number of returned results**. This can provide richer, more comprehensive online information, helping cover more aspects of the question.\\
* **Performance and limitations**:
  * **Please note**: requesting more search results will **increase processing time**, thereby **slowing down search and response speed**.
  * At the same time, retrieving too much web content may also **exceed the model's context length limit**, which can sometimes lead to **missing information, incomplete responses, or errors**.
* **Recommendation**:
  * When you first start using it, it is recommended to keep the default settings.
  * If the information seems insufficient, adjust the number of results appropriately according to your specific needs and acceptable waiting time (if configurable).
  * If you do not need real-time information, remember to **click the web search icon on the toolbar again**, to **turn it off**, to avoid unnecessary searches and potential delays.

***

Now you have mastered how to use web search in Cherry Studio. Make full use of this feature to get the latest news, verify information, or explore the unknown!

***

### 💡 Get help and submit feedback

If you encounter any questions, bugs, or have suggestions for feature improvements during configuration or use, please refer to [Feedback and Suggestions](https://github.com/CherryHQ/cherry-studio-docs/blob/main/pre-basic/question-contact/suggestions.md) the official channels provided there.


---

# 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/en-us/pre-basic/websearch/free-search.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.
