SuperAPI AI 工具集

debug-sandbox-execution

编程与开发

查看项目

更新于 11-06 00:49

技能介绍

用途

当 execute_code_sandbox 工具执行失败、静默失败、输出被截断或产生难以理解的错误时,该技能提供一套调试模式,用于定位根本原因并逐步恢复执行。复杂脚本(尤其是包含多个文件输出的脚本)容易出现部分失败,该技能正是针对这类情况设计。

主要能力

该技能采用三阶段调试方法:

第一阶段:捕获部分执行轨迹

当沙箱执行失败时,使用 run_shell 并配合输出管道重新运行代码,以捕获失败前产生的任何输出:

python your_script.py 2>&1 | head -100

这可以揭示:哪些函数或步骤已成功执行、失败发生在何处、以及任何被抑制的错误消息。

第二阶段:隔离失败函数

将脚本拆分为更小、可测试的单元,独立执行每个函数或代码块:

# Test individual components
if __name__ == "__main__":
    # Step 1: Test imports
    import numpy as np
    print("Imports OK")
    
    # Step 2: Test function A in isolation
    result_a = function_a()
    print(f"Function A: {result_a}")
    
    # Step 3: Test function B
    result_b = function_b(result_a)
    print(f"Function B: {result_b}")

用 execute_code_sandbox 分别运行每个部分,以确定哪个组件失败。

第三阶段:增量生成输出

一次生成一个输出文件,在继续之前验证每个文件:

import numpy as np
import soundfile as sf

# Generate and save file 1
audio1 = np.random.randn(48000 * 10).astype(np.float32)
sf.write('output_01.wav', audio1, 48000, subtype='FLOAT')

# Verify file 1 exists and has expected properties
import os
assert os.path.exists('output_01.wav'), "File 1 not created"

# Generate and save file 2
audio2 = np.random.randn(48000 * 10).astype(np.float32)
sf.write('output_02.wav', audio2, 48000, subtype='FLOAT')

# Verify file 2
assert os.path.exists('output_02.wav'), "File 2 not created"

使用方式

示例工作流程:

  1. 初始尝试:用 execute_code_sandbox 运行完整脚本
  2. 失败时:用 run_shell 配合 | head -100 重新运行,查看部分输出
  3. 定位断点:找到最后一个成功的操作
  4. 拆分脚本:为每个主要部分创建独立脚本
  5. 增量测试:运行每个部分,验证输出,再继续下一个
  6. 合并成功部分:所有片段都工作后,合并为最终脚本

最佳实践:

  • 写入文件后立即验证文件创建:assert os.path.exists(path)
  • 在假定成功之前检查文件属性(大小、时长、格式)
  • 大量使用 print 语句标记脚本进度
  • 保存中间输出,避免失败后从头开始
  • 先用短样本(1-2 秒)测试音频/视频生成,再处理完整长度内容

适用场景

  • 包含多个文件输出的复杂脚本
  • 音频/视频生成管线
  • 依赖外部库的脚本
  • 任何产生不完整或无输出的 execute_code_sandbox 调用

限制

该技能的具体平台支持、收费方式、价格等信息暂未提供。