用途
当 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"
使用方式
示例工作流程:
- 初始尝试:用 execute_code_sandbox 运行完整脚本
- 失败时:用 run_shell 配合
| head -100重新运行,查看部分输出 - 定位断点:找到最后一个成功的操作
- 拆分脚本:为每个主要部分创建独立脚本
- 增量测试:运行每个部分,验证输出,再继续下一个
- 合并成功部分:所有片段都工作后,合并为最终脚本
最佳实践:
- 写入文件后立即验证文件创建:
assert os.path.exists(path) - 在假定成功之前检查文件属性(大小、时长、格式)
- 大量使用 print 语句标记脚本进度
- 保存中间输出,避免失败后从头开始
- 先用短样本(1-2 秒)测试音频/视频生成,再处理完整长度内容
适用场景
- 包含多个文件输出的复杂脚本
- 音频/视频生成管线
- 依赖外部库的脚本
- 任何产生不完整或无输出的 execute_code_sandbox 调用
限制
该技能的具体平台支持、收费方式、价格等信息暂未提供。