On the agent configuration page, the ‘Knowledge Base’ configuration option is missing

问题场景

在 Dify v1.17.0 中，用户在 Agent V2 编排面板（Orchestrate）配置 Agent 时，发现“知识库（Knowledge Base）”配置选项缺失，而 v1.16.0 中该选项是存在的且能正常工作。

报错原文

On the agent configuration page, the 'Knowledge Base' configuration option is missing

原因分析

可能原因是 Dify v1.17.0 引入了一个编译期功能开关（compile-time feature flag），将 Agent V2 编排面板中的知识检索（Knowledge Retrieval）配置区块默认隐藏。该开关在 PR #40679 中引入，且被官方描述为“unsupported”（不支持）和临时性的。需要说明的是，后端知识检索运行时（dify-agent/src/dify_agent/layers/knowledge/layer.py）已经实现，所以这纯粹是前端开关导致的功能隐藏，不是后端故障。

环境排查

• 确认 Dify 版本是否为 v1.17.0（升级后出现此问题）。
• 确认部署方式是否为 Self Hosted（Docker）。
• 检查同版本下是否还有其他 Agent V2 功能被同时隐藏（例如 CLI 工具、内容审核、密钥环境变量等）。

解决步骤

1. 确认你使用的是自托管（Docker）版 Dify v1.17.0。
2. 找到 web/features/agent-v2/agent-detail/configure/feature-flags.ts 文件。
3. 将文件中 ENABLE_AGENT_KNOWLEDGE_RETRIEVAL 的值从 false 修改为 true。
4. 重新构建（rebuild）Dify 的 web 容器，使前端代码变更生效。
5. 重新打开 Agent V2 编排页面，检查“知识库”配置选项是否恢复显示。

验证方法

重新访问 Agent V2 编排页面，确认“知识库（Knowledge Base）”配置选项已恢复显示，并能正常进行知识库的检索配置。

参考来源

langgenius/dify #41588

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。