Replies: 5 comments 4 replies
|
@simonjhy This error means the By default, How to fix it — pick one:
This is a configuration issue that has been reported by several other users — see #39161 and #38283 for more context [3]. What version of Dify are you running, and are you using the standard Docker Compose deployment? To reply, just mention @dosu. Docs are dead. Just use Dosu.
|
|
我正在使用的版本是1.16.1，使用标准的docker compose 部署。 |
|
@simonjhy 你说这两个配置已经设置了，但错误仍然出现，最常见的原因是 在代码中，当 排查步骤：
如果确认环境变量传递正确且 sandbox 服务正常，请把第 1 步的输出和 To reply, just mention @dosu. Share context across your team and agents. Try Dosu.
|
|
$ docker compose exec agent_backend env | grep -i "SANDBOX|SHELLCTL|RUNTIME" 下面的这几个文件我也检查了，都保持默认设置，目前都没有.env 只有在docker目录中设置了.env，而且DIFY_AGENT_LOCAL_SANDBOX_ENDPOINT=http://local_sandbox:5004 (base) soft@AI:/data/ai/github/dify/docker/envs$ docker compose logs local_sandbox 目前我的环境上配置看起来是没问题 |
|
@simonjhy 你的环境变量确认没问题， 不过有一个需要注意的点： 请进一步排查：
另外，你报告的错误消息 To reply, just mention @dosu. Share context across your team and agents. Try Dosu.
|
|
$ docker compose logs agent_backend 2>&1 | head -50 $ docker compose exec agent_backend env | grep SHELLCTL 目前在docker-compose.yaml中配置是：DIFY_AGENT_LOCAL_SANDBOX_ENDPOINT: ${DIFY_AGENT_LOCAL_SANDBOX_ENDPOINT:-${DIFY_AGENT_SHELLCTL_ENTRYPOINT:-http://local_sandbox:5004}} 这些是我目前的配置和发现的错误日志 |
|
@simonjhy 你的环境变量配置确实是正确的， 但是有一个重要发现：你报错信息中的 这个错误很可能来自 v1.16.1 之后的一个更新版本（PR #38528 在 v1.16.1 标签之后合并，重构了 shell provider 逻辑）[2]。 请确认你实际运行的镜像版本： # 检查容器中实际的代码
docker compose exec agent_backend cat /app/api/.venv/lib/python3.12/site-packages/dify_agent/layers/shell/layer.py | head -5
# 检查镜像标签
docker compose exec agent_backend env | grep -i "COMMIT\|VERSION"
# 检查你拉取的 agent_backend 镜像
docker images | grep agent-backend如果你的 如果确认镜像确实是更新的版本，可以尝试将 To reply, just mention @dosu. Docs are dead. Just use Dosu.
|
|
我现在用的就是从github上下载的源代码中的docker-compose文件，未做任何更改。 下面是查询的几个配置 Shell command execution requires a bound execution-context layer with a safe $ docker compose exec agent_backend env | grep -i "COMMIT|VERSION" $ docker images | grep agent-backend |
|
@simonjhy 找到根本原因了！ 在 v1.16.1 的实际代码中， def build_shell_provider(self):
match self.shell_provider:
case "shellctl":
if not self.shellctl_entrypoint: # ← 检查的是 shellctl_entrypoint
return None # ← 返回 None → shell 不可用！然后 问题在于： 查看你的 docker-compose.yaml， 解决方案 — 在你的 DIFY_AGENT_SHELLCTL_ENTRYPOINT=http://local_sandbox:5004或者在 docker-compose.yaml 的 DIFY_AGENT_SHELLCTL_ENTRYPOINT: ${DIFY_AGENT_SHELLCTL_ENTRYPOINT:-http://local_sandbox:5004}然后重启服务： docker compose down agent_backend && docker compose up -d agent_backend添加后可以验证： docker compose exec agent_backend env | grep SHELLCTL_ENTRYPOINT确认输出包含 To reply, just mention @dosu. Share context across your team and agents. Try Dosu.
|
Uh oh!
There was an error while loading. Please reload this page.
Self Checks
1. Is this request related to a challenge you're experiencing? Tell me about your story.
when I create a new agent instnce with all default value, after I deploy it and test, The ui show "DifyShellLayer requires a non-null shell provider when the 'dify.shell' layer is used. (agent_run_id=81df7770-2bf1-4f7e-809c-c0935a356ae7)",
The dify api container show：
2026-07-31 03:15:12.963 ERROR [Thread-94 (_generate_worker)] [app_generator.py:510] dac720a71a8d5f4db8ec4277da1d7c43 - Unknown Error in Agent App generate worker
Traceback (most recent call last):
File "/app/api/core/app/apps/agent_app/app_generator.py", line 493, in _generate_worker
runner.run(
File "/app/api/core/app/apps/agent_app/app_runner.py", line 708, in run
raise _agent_backend_failure_to_exception(terminal)
clients.agent_backend.errors.AgentBackendRunFailedError: DifyShellLayer requires a non-null shell provider when the 'dify.shell' layer is used. (agent_run_id=81df7770-2bf1-4f7e-809c-c0935a356ae7)
2026-07-31 03:16:35.325 INFO [Dummy-96] [_client.py:1025] 98b381f61b855d09a057a9d3a52ad2dc - HTTP Request: GET http://plugin_daemon:5002/plugin/d79cab32-659f-4bbe-bb1c-f608af9c0e9a/management/tools?page=1&page_size=256 "HTTP/1.1 200 OK"
2. Additional context or comments
No response
All reactions