From 257be16fafc7413e34c32f0be16b882735603c2a Mon Sep 17 00:00:00 2001 From: josephsellers <6892567+josephsellers@users.noreply.github.com> Date: Mon, 2 Mar 2026 16:37:37 +0000 Subject: [PATCH] docs: Add missing Default Features step to agentic search setup MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 🤖] --- .../chat-conversations/web-search/agentic-search.mdx | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/features/chat-conversations/web-search/agentic-search.mdx b/docs/features/chat-conversations/web-search/agentic-search.mdx index b5dd2ff2..29c2137f 100644 --- a/docs/features/chat-conversations/web-search/agentic-search.mdx +++ b/docs/features/chat-conversations/web-search/agentic-search.mdx @@ -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. :::