SuperAPI AI 工具集

code-exec-fallback

编程与开发

查看项目

更新于 10-16 14:57

技能介绍

用途\ncode-exec-fallback 用于在 execute_code_sandbox 反复失败(通常是两次或以上尝试)时,改用文件加 shell 的方式执行 Python 代码。触发原因包括环境限制、超时、依赖问题或沙箱限制。\n\n主要能力\n该模式的核心做法是:不直接在沙箱中执行代码,而是先把 Python 脚本写入文件,再通过 shell 执行。具体步骤为:使用 write_file 写入脚本;使用 run_shell 执行 python3 script.py;可选地清理临时文件。\n\n使用方式\n第一步,使用 write_file 保存 Python 代码,路径选择有描述性的名称,例如 process_data.py 或 analyze.py,内容为包含全部导入与逻辑的完整 Python 脚本。第二步,使用 run_shell 执行命令 python3 <script_name>.py,并根据任务需要设置合适超时(默认 30 秒,必要时增加)。第三步,处理输出:捕获 run_shell 的 stdout/stderr,按需解析结果,并可在执行后选择删除脚本文件。\n\n示例\n与其直接使用可能失败的 execute_code_sandbox(code="import pandas as pd; df = pd.read_csv('data.csv')..."),不如先 write_file(path="analyze.py", content="""..."""),再 run_shell(command="python3 analyze.py", timeout=60)。示例脚本中包含导入 pandas 与 json,读取 data.csv,按 category 分组求和,并打印 JSON 结果。\n\n适用场景\n当沙箱缺少依赖、代码在沙箱中超时但在 shell 中可行、文件 I/O 操作在沙箱中受限、需要运行外部命令或系统工具,或需要复杂多文件项目与合理文件结构时,这一备用方案会有帮助。\n\n限制与注意事项\n该模式属于备用方案,通常在 execute_code_sandbox 反复失败后启用。使用时应把所有导入写进脚本文件,因为 shell 环境可能与沙箱不同;使用绝对路径或确保工作目录正确;在脚本中加入错误处理以便调试;对长时间运行的操作增加超时(默认 30 秒);如需解析结果,可打印结构化输出(如 JSON);执行成功后清理临时文件以避免混乱。