fallback-python-execution 是一种在常规 Python 执行方式不可靠时使用的备用执行模式,资料将其定位为“回退式 Python 执行”。
适用时机:当 execute_code_sandbox 返回未知错误或反复失败、shell_agent 无法成功执行 Python 代码、需要通过 Python 创建文件(如电子表格、文档、数据文件),或直接委托方式在当前环境中被证明不可靠时,可采用此模式。
核心做法:不再把 Python 执行委托给智能体,而是采用两步内联流程:第一步用 write_file 将完整 Python 代码写入 .py 文件;第二步用 run_shell 执行 python <script.py>。
使用步骤:第一步,在 write_file 中指定脚本路径并提供包含全部必要逻辑的内联代码,例如使用 pandas 构建 DataFrame 并输出 Excel。第二步,通过 run_shell 运行该脚本。第三步,检查输出中的成功信息或错误,确认预期文件已生成,如不再需要可清理临时脚本。
在资料给出的 Excel 文件创建示例中,脚本导入 pandas 与 openpyxl,构造数据字典并生成 DataFrame,调用 to_excel 保存为 report.xlsx,然后打印成功信息;随后通过 run_shell 执行 create_report.py,数据内容与文件名保持原样。
该方式可靠的原因包括:避开可能引入错误的智能体解释层;直接控制执行环境;错误输出清晰便于调试;绕过沙箱委托问题。
实践提示:在 Python 代码中加入错误处理以便调试;尽量使用绝对路径避免工作目录问题;添加 print 语句跟踪执行进度;保持脚本自包含并将所有导入放在顶部;复杂任务可拆分为多个脚本。
故障排查:模块缺失时可在 python 命令前添加 pip install 命令;权限错误应检查文件路径是否可写;脚本未找到可使用绝对路径或先 cd 到目录;输出未生成应检查 run_shell 输出中的 Python 错误。
限制:资料未提供该模式的具体平台支持范围、性能数据或收费信息,暂未提供。