issue: RAG / Knowledge base ignored when tool calling is “default”

快速结论：该报错发生在 Open WebUI 使用 Native（默认）Function Calling 时，RAG/Knowledge 检索被静默跳过，模型不会自动查询知识库；切换到 legacy 工具调用模式后知识库检索恢复正常，但日历等工具失效。优先排查 tool calling 模式与内置检索工具（builtin retrieval tools）的兼容性问题。

适用环境：Open WebUI v0.11.0（Docker 安装），Debian 12，未确认使用 Ollama 版本。

最快修复方案：暂无确认的一步修复方案。Issue 中社区成员提到将 advanced parameters 中的 tool calling 设置切换为 “legacy” 可恢复知识库检索，但代价是日历等依赖原生调用的工具失效。该方案属于临时 workaround，并非官方修复。

注意事项：该问题的根因尚在确认中，社区认为可能是内置检索工具（builtin retrieval tools）在 Native Function Calling 模式下存在回归缺陷（确认的 Issue #27641 可能与根因相同）。切换到 legacy 模式后知识库可用，但会牺牲部分工具功能，请确认业务场景可接受。

问题场景

用户在 Open WebUI v0.11.0（Docker 部署）中创建自定义模型并绑定 RAG/Knowledge 知识库。期望在提问时模型自动扫描知识库并返回带引用的答案，但实际在默认（Native）工具调用模式下，知识库检索完全被跳过：模型不搜索知识、回答中无引用链接。将 advanced parameters 中的 tool calling 切换为 “legacy” 后，知识库检索恢复正常，但日历工具无法工作。

报错原文

issue: RAG / Knowledge base ignored when tool calling is "default"

Expected Behavior: When create custom modell with RAG/Knowledge, doesn't automatically scan the knowledge when I ask a question. No searching knowledge, no link in the answer.

Actual Behavior: When create custom modell with RAG/Knowledge, doesn't automatically scan the knowledge when I ask a question. No searching knowledge, no link in the answer. But if the advanced parameters -> tools calling setting is "legacy", then search perfectly in the knowledge.

原因分析

根据 Issue 讨论链，该问题属于已知的回归缺陷（regression family），并非用户环境配置问题。可能原因包括：

Native Function Calling 模式下检索路径回归：Issue 评论指出相关报告（#27232、#26655、#26170）均描述 Native 模式下知识库检索被跳过，legacy 模式正常，指向检索路径在原生调用模式下的回归缺陷。
内置检索工具构建对象不完整：确认的 Issue #27641 指出 builtin retrieval tools 构建的用户对象不完整，可能导致知识库搜索和群组共享文件访问失败。该问题可能与本案例同根因。
官方确认行为：Issue 中 Open WebUI 维护者未认同 “回归家族” 的说法，认为该行为符合预期。但是否属于 bug 尚存争议，需关注后续版本修复。

环境排查

确认 Open WebUI 版本是否为 v0.11.0 或更高（本 Issue 中用户声称已使用最新版）。
检查 Docker 部署方式下，知识库（Knowledge）是否正确挂载并关联到自定义模型。
在 Advanced Parameters 中确认 tool calling 模式：默认（Native）还是 legacy。
确认日历等第三方工具在两种模式下的可用性差异，以判断是否属于模式切换的副作用。
如使用 Ollama，确认 Ollama 版本是否与 Open WebUI 兼容（本 Issue 未提供 Ollama 版本信息）。

解决步骤

可优先尝试：切换到 legacy 模式恢复知识库——在自定义模型的 Advanced Parameters 中，将 tool calling 从默认/原生切换为 “legacy”。验证知识库是否恢复自动检索（本 Issue 用户已确认此步骤有效）。注意：此操作会让日历等依赖原生 tool calling 的工具失效。
检查内置检索工具状态——在模型配置中确认 builtin retrieval tools 是否启用，并检查相关日志是否有检索失败记录。参考确认的 Issue #27641，该问题可能导致检索路径失败。
等待官方修复——由于根因涉及 Native Function Calling 的检索回归，且 Issue 目前尚未给出已验证的修复方案，建议关注 Open WebUI 后续版本更新，或订阅 #27641 跟踪检索工具修复进度。
验证关联 Issue 中的替代方案——由于部分关联 Issue（#27232、#26655）已有用户提交 workaround 或配置改动，可前往查看是否有适用于本环境的已验证替代方案。

验证方法

将 tool calling 设置为 legacy 后，向绑定了知识库的自定义模型提问，确认模型会自动检索知识库、回答中包含知识库内容的引用链接。同时确认日历工具在 legacy 模式下不可用、但在 Native 模式下恢复可用，以排除其他配置引起的干扰。如后续升级 Open WebUI 版本，再次以默认模式测试知识库检索是否恢复正常。