centersl/open-webui-docs
1
0
Fork 0
mirror of https://github.com/open-webui/docs.git synced 2026-03-26 13:18:42 +07:00
Code Issues Packages Projects Releases Wiki Activity

docs: Add missing Default Features step to agentic search setup

Browse Source 
The agentic search setup guide omits that Web Search must be enabled
under Default Features in the model settings. Without this, the
search_web and fetch_url tools are not injected in Native Mode, even
when the Web Search capability and Builtin Tools are both enabled.

This was confirmed as the root cause of non-functional agentic search
in v0.8.7 and relates to the behavioral change introduced in commits
c46ef3b and f1a1e64 (open-webui/open-webui#20641).

[Used Claude Code 🤖]
This commit is contained in:
josephsellers
2026-03-02 16:37:37 +00:00
parent 1113fd80f4
commit 257be16faf
1 changed files with 6 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/features/chat-conversations/web-search/agentic-search.mdx
View File

@@ -31,14 +31,15 @@ To unlock these features, your model must support native tool calling and have s
1. **Enable Web Search Globally**: Ensure a search engine is configured in **Admin Panel → Settings → Web Search**.
2. **Enable Model Capability**: In **Admin Panel → Settings → Models**, select your model and enable the **Web Search** capability.
3. **Enable Native Mode (Agentic Mode)**:
3. **Enable Default Feature**: In the same model settings, under **Default Features**, check **Web Search**. This controls whether the `search_web` and `fetch_url` tools are available by default in new chat sessions.
4. **Enable Native Mode (Agentic Mode)**:
* In the same model settings, under **Advanced Parameters**, set **Function Calling** to `Native`.
4. **Use a Quality Model**: Ensure you're using a frontier model with strong reasoning capabilities for best results.
5. **Use a Quality Model**: Ensure you're using a frontier model with strong reasoning capabilities for best results.
:::tip Model Capability vs. Chat Toggle
In **Native Mode**, the `search_web` and `fetch_url` tools are automatically included based on the model's `web_search` capability setting. The chat toggle is not required.
:::tip Model Capability, Default Features, and Chat Toggle
In **Native Mode**, the `search_web` and `fetch_url` tools require both the **Web Search** capability to be enabled *and* **Web Search** to be checked under **Default Features** in the model settings (or toggled on in the chat). If either is missing, the tools will not be injected — even though other builtin tools may still appear.
In **Default Mode** (non-native), the chat toggle still controls whether web search is performed via RAG-style injection.
In **Default Mode** (non-native), the chat toggle controls whether web search is performed via RAG-style injection.
**Important**: If you disable the `web_search` capability on a model but use Native Mode, the tools won't be available even if you manually toggle Web Search on in the chat.
:::