
I can’t found New Agent in Dify 1.16.0-rc1 release
快速结论:该问题通常发生在自托管 Dify 1.16.0-rc1 版本的用户尝试使用 Agent V2(New Agent)功能时。优先排查 Docker 环境变量中是否启用了 ENABLE_AGENT_V2 和 NEXT_PUBLIC_ENABLE_AGENT_V2。
问题场景
用户在自托管(Self Hosted Docker)方式部署的 Dify 1.16.0-rc1 版本 WebUI 中,无法找到“New Agent”创建入口,期望使用 Agent V2 的 Skills(技能)和 Files(文件)功能。
报错原文
I can't found New Agent in Dify 1.16.0-rc1 release
原因分析
Agent V2 功能在 Dify 1.16.0-rc1(及后续版本)中默认不启用,需要通过环境变量手动开启。用户未设置相应环境变量,导致前端导航栏中缺少 Agent Roster 页面入口。
环境排查
- 确认 Dify 部署方式是否为 Docker(Self Hosted)
- 检查
docker/.env文件是否存在;若不存在,检查是否已从docker/.env.example复制 - 检查
.env文件中是否包含以下两项:ENABLE_AGENT_V2=NEXT_PUBLIC_ENABLE_AGENT_V2=
解决步骤
- 进入 Dify 项目的
docker/目录(如果还没有.env文件,先复制.env.example为.env)。 - 在
docker/.env文件中添加或修改以下两行:ENABLE_AGENT_V2=true NEXT_PUBLIC_ENABLE_AGENT_V2=true - 保存文件后,执行
docker compose up -d重启所有容器。 - 等待容器重启完成,刷新浏览器中的 Dify WebUI 页面。
验证方法
成功启用后,在 Dify 导航栏中应该能看到 Agent Roster 页面(对应路由 /roster),其中可以创建和管理 Agent V2 实例,并使用 Skills 和 Files 功能。



