Agent transient commands ignore timeout while replaying truncated output

这个报错通常出现在 Dify Agent 的完整命令执行路径中:当 Shell 调用或绑定文件操作返回被截断的输出且需要回放时,命令助手在进入截断输出分支后不再检查总超时,导致慢速或卡死的输出回放超出设定时限。优先排查 execute_complete_with_commands 在 truncat

快速结论:这个报错通常出现在 Dify Agent 的完整命令执行路径中:当 Shell 调用或绑定文件操作返回被截断的输出且需要回放时,命令助手在进入截断输出分支后不再检查总超时,导致慢速或卡死的输出回放超出设定时限。优先排查 execute_complete_with_commands 在 truncated 分支中的截止时间检查与清理策略。

适用环境:Dify Agent package 1.20.0,main 提交 6b8e067e6690860e76a3622de1021fc3202dc54f;自托管源码部署;Windows / Python 3.13.18 的隔离 Agent 运行时复现。显卡、CUDA、PyTorch 版本在 Issue 中没有证据。

最快修复方案:暂无确认的一步修复方案。可优先尝试:在 truncated 输出分支中,每次启动 read_output 前检查截止时间,并用剩余时间约束这次 await;超时后返回已捕获前缀并标记 output_complete=False、incomplete_reason="timeout",同时保留原有的 interrupt/delete 清理策略。

注意事项:复现脚本是协议级测试,不涉及远程 provider 和凭据;Issue 讨论中的修复行为描述属于源码层面确认,评论者明确表示没有实际执行复现。外层 asyncio.wait_for 只是安全护栏,会走 finally 强制删除,但绕过显式 interrupt(),不能替代命令助手自身的超时处理。

问题场景

在自托管 Dify Agent 中,execute_complete_with_commands 被完整 Shell 调用和 Binding 文件操作使用。当命令运行返回截断输出(truncated=True),助手会调用 read_output 回放输出;如果回放很慢或卡住,而 truncated 分支在 continue 前没有检查截止时间、也没有给这次 await 设置时间上界,命令助手就可能超过命令的总超时。另一个相关情况是:run 在耗尽全部预算后才返回截断分页,助手仍会启动新的输出读取。

报错原文

deleted job-1 True
outer guard expired; command helper did not honor timeout

原因分析

可能原因:execute_complete_with_commands 只在 wait 之前检查 deadline,进入 truncated 分支后调用 read_output 并 continue,没有再次检查 deadline,也没有用剩余时间约束这次 await。因此慢速或卡死的输出回放可以超出命令的总超时,最终只能由外层 asyncio.wait_for 取消。

清理路径也存在差异:外部取消会到达 finally 并强制删除 job,但绕过显式 interrupt();而返回内部 incomplete_reason="timeout" 时,会先中断非终态 job,再强制删除。这说明外层取消并不等价于助手自身的超时行为。

环境排查

  • 确认 Dify Agent 版本是否为 1.20.0,以及源码是否对应提交 6b8e067e6690860e76a3622de1021fc3202dc54f,避免在已改动代码上误判。
  • 确认运行环境:自托管源码部署,Windows,Python 3.13.18。
  • 确认触发路径是否涉及完整 Shell 调用或 Binding 文件操作,即是否经过 execute_complete_with_commands。
  • 确认命令结果是否带有 truncated=True,以及是否走入了截断输出回放分支。
  • 检查现有本地命令执行器测试是否覆盖卡住 read_output 的场景;Issue 指出已有测试的 read_output 桩会拒绝每次调用,覆盖不到该缺口。
  • 显卡、CUDA、PyTorch 等依赖版本在 Issue 中没有证据,无需作为排查前提。

解决步骤

  1. 在 dify-agent 中定位 src/dify_agent/runtime/command_runner.py 的 execute_complete_with_commands。
  2. 找到处理 truncated 输出的分支:该分支当前会调用 read_output 并 continue。
  3. 在每次启动新的 read_output 之前检查截止时间;如果预算已经耗尽,不再发起输出读取。
  4. 对仍在进行的回放,用剩余时间约束这次 await,避免无界等待。
  5. 超时后返回已捕获的输出前缀,并设置 output_complete=False、incomplete_reason="timeout"。
  6. 保留原有清理策略:对非终态 job 先调用 interrupt(),再强制删除;对已终态但有未读截断输出的 job,按现有策略删除而不 interrupt。
  7. 补充回归测试,至少区分两种情况:运行中的 job 需要中断;已终态、有未读截断输出的 job 只删除不中断。测试应能模拟 read_output 卡住,而不是拒绝每次调用。

验证方法

可优先尝试用 Issue 中的 repro.py 作协议级验证:修复前,0.01 秒超时不会结束助手,只有外层 1 秒保护触发并输出 outer guard expired; command helper did not honor timeout;按预期修复后,同样脚本应输出:

deleted job-1 True
timeout False first

同时确认卡住的 read_output 不再让助手无限等待,并且清理顺序符合上述 interrupt/delete 策略。注意评论者只做了源码层面确认,未实际执行该复现,修复效果仍需以实际测试结果为准。

参考来源

langgenius/dify #46784

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36438

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注