用途:当 execute_code_sandbox 反复失败时,提供可靠的代码执行回退方案。适用触发条件包括连续 2 次以上出现不透明或未知错误、重试后仍超时、以及无法通过改代码解决的环境类错误。
主要能力与流程:第一步检测重复失败,连续 2 次失败后切换回退方式;第二步用 write_file 将 Python 脚本写入文件,例如 write_file(path="/workspace/script_name.py", content="...");第三步用 run_shell 执行,例如 run_shell(command="python /workspace/script_name.py", timeout=300);第四步解析 stdout/stderr 判断成功或诊断问题。
最佳实践:脚本内加入 try/except 并用 sys.exit() 返回状态码;按需增大超时(run_shell 默认 30 秒);必要时清理临时文件;记录触发回退的原因;确认环境默认提供 Python 3.x。
不适用场景:首次执行失败应先重试沙箱;简单单行代码用沙箱更快;错误明显是代码缺陷时应直接修代码;需要沙箱隔离的安全敏感操作不应使用此模式。
限制:资料未提供具体平台支持范围、依赖安装方式及更多配置细节。