用途
code-exec-fallback 是一种回退模式,用于在 execute_code_sandbox 反复失败时执行 Python 代码。当沙箱因环境限制、超时、依赖问题或沙箱限制而连续失败(通常尝试 2 次以上)时,可使用此模式。
主要能力
该模式不直接在沙箱中执行代码,而是将 Python 脚本写入文件,再通过 shell 执行。具体流程为:
- 使用 write_file 写入脚本。
- 使用 run_shell 执行 python3 script.py。
- 可选地清理临时文件。
使用方式
第 1 步:写入 Python 脚本
使用 write_file 保存 Python 代码:
- 路径:选择描述性名称(例如 "process_data.py"、"analyze.py")。
- 内容:包含所有导入和逻辑的完整 Python 脚本。
第 2 步:通过 Shell 执行
使用 run_shell 执行:
- 命令:"python3 <script_name>.py"
- 超时:根据任务适当设置(默认 30s,如有需要可增加)。
第 3 步:处理输出
- 捕获 run_shell 的 stdout/stderr。
- 按需解析结果。
- 可选地在执行后删除脚本文件。
示例
不要这样做(可能失败):
execute_code_sandbox(code="import pandas as pd; df = pd.read_csv('data.csv')...")
而应这样做:
write_file(path="analyze.py", content=""" import pandas as pd import json
df = pd.read_csv('data.csv') result = df.groupby('category').sum() print(json.dumps(result.to_dict())) """)
run_shell(command="python3 analyze.py", timeout=60)
成功技巧
- 在脚本文件中包含所有导入——shell 环境可能与沙箱不同。
- 使用绝对路径或确保工作目录正确。
- 在脚本中添加错误处理,以便更好地调试。
- 对长时间运行的操作增加超时(默认是 30s)。
- 如果需要解析结果,打印结构化输出(JSON)。
- 成功执行后清理临时文件,避免杂乱。
适用场景
此模式在以下情况下有帮助:
- 沙箱缺少依赖。
- 代码在沙箱中执行超时,但在 shell 中可以工作。
- 沙箱中文件 I/O 操作受限。
- 需要运行外部命令或系统工具。
- 需要正确文件结构的复杂多文件项目。
限制
资料中未提供关于该模式的额外限制说明。