SuperAPI AI 工具集

code-execution-fallback

编程与开发

查看项目

更新于 11-06 00:49

技能介绍

用途

该技能用于处理代码执行失败的情况,提供回退策略,并通过工作区路径锚定防止文件位置错误。它面向需要在代码沙箱执行失败后仍能可靠完成任务的智能体场景。

主要能力

1. 工作区路径锚定

在任何任务开始时建立并验证工作目录。Python 中通过 os.getcwd() 获取并打印工作目录;Shell 脚本中使用 pwd 并输出当前目录。目的是防止智能体在切换工具时把文件写入意外位置。

2. 执行回退阶梯

当 execute_code_sandbox 失败时,按以下升级模式处理:

  • 第一级:用更简单的代码重试。简化代码结构、移除复杂依赖、添加显式错误处理。
  • 第二级:使用 run_shell 配合 Heredoc。当沙箱执行反复失败时,切换到 shell 执行。要点包括:使用 << 'EOF'(带引号)防止变量展开;将所有导入和依赖内联;添加明确的成功/失败消息。
  • 第三级:委托给 shell_agent。适用于需要错误恢复的复杂多步任务。

3. 显式路径管理

始终使用绝对路径或明确相对路径。资料给出了正反示例:反例是依赖隐式工作目录的 df.to_csv("output/data.csv") 和 cd some_dir && python script.py;正例是先获取 os.getcwd() 作为 base_path,再用 os.path.join 拼接输出目录并 os.makedirs(..., exist_ok=True),Shell 中则通过 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" 定位脚本目录。

使用方式

资料提供了一棵决策树:

  • execute_code_sandbox 失败且为语法/导入错误 → 修复代码,第一级重试
  • 失败且为超时/资源错误 → 使用第二级(run_shell heredoc)
  • 失败且为未知/不明确错误 → 使用第三级(shell_agent)
  • 成功 → 验证输出文件是否存在于预期路径

资料还给出常见失败场景与推荐回退的对照:ModuleNotFoundError(缺少包)→ 先用 run_shell 执行 pip install;Timeout(长时间运行操作)→ 使用带进度跟踪的 shell_agent;PermissionError(目录错误)→ 验证工作区路径并使用显式路径;未知错误(沙箱限制)→ run_shell 或 shell_agent。

资料包含一个健壮文件生成示例,分三步:锚定工作区、显式创建输出目录、带错误处理地生成内容,并在异常时抛出以提示升级到 run_shell 或 shell_agent。

适用场景

适用于智能体执行代码时遇到沙箱失败、超时、缺少依赖、权限错误或路径混乱等情况,需要在不同执行方式之间切换并保证输出文件落在正确位置的任务。

限制与注意事项

资料列出了应避免的反模式:未经验证就假设当前目录;在没有上下文的情况下使用 ../output/file.txt 这类相对路径;在不改变方法的情况下反复重试失败的 execute_code_sandbox;生成后不检查输出文件是否存在;在同一任务中混用隐式和显式路径风格。

执行后的验证清单包括:确认开始时已验证工作目录;确认输出文件存在于预期路径;确认文件内容非空且有效;如果执行失败,在 2 次重试内升级到下一回退级别。

关于该技能的收费、价格、平台支持范围等事实,资料暂未提供。