SuperAPI AI 工具集

code-exec-fallback

编程与开发

查看项目

更新于 11-06 00:49

技能介绍

用途

code-exec-fallback 是一种回退模式,用于在 execute_code_sandbox 反复失败时执行 Python 代码。当沙箱因环境限制、超时、依赖问题或沙箱限制而连续失败(通常尝试 2 次以上)时,可使用此模式。

主要能力

该模式不直接在沙箱中执行代码,而是将 Python 脚本写入文件,再通过 shell 执行。具体流程为:

  1. 使用 write_file 写入脚本。
  2. 使用 run_shell 执行 python3 script.py。
  3. 可选地清理临时文件。

使用方式

第 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 操作受限。
  • 需要运行外部命令或系统工具。
  • 需要正确文件结构的复杂多文件项目。

限制

资料中未提供关于该模式的额外限制说明。