sandbox-fallback-python-e5d7ae
Fallback to run_shell with Python heredoc when execute_code_sandbox fails
- License 许可
- MIT
- 所属仓库
- HKUDS/AgentPilot
- 最近更新
- 2026-11-12
- Stars
- ★ 8.0k
- Forks
- 944
01 前言 Front Matter
- name
- sandbox-fallback-python-e5d7ae
- description
- Fallback to run_shell with Python heredoc when execute_code_sandbox fails
02 资源文件 1
- 其他.skill_id44 B
03 SKILL.md 正文
Python Sandbox Fallback Pattern
When to Use
Use this pattern when execute_code_sandbox fails with e2b/sandbox initialization errors, especially when running Python code that requires external libraries like reportlab, pandas, numpy, etc.
Common Failure Indicators
Detect these error patterns to trigger the fallback:
e2binitialization errorssandboxcreation/creation timeout failurescontainerstartup errors- Connection/refusal errors from sandbox service
The Fallback Pattern
Basic Heredoc Approach
For short scripts, use a Python heredoc directly in run_shell:
run_shell(
command="""python3 << 'EOF'
import sys
print(f"Python version: {sys.version}")
# Your code here
EOF
""",
timeout=60
)
File-Based Approach for Complex Scripts
For longer scripts or when you need to preserve state across multiple executions:
# Step 1: Write the script to a temporary file
script_content = '''
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
import os
# Your code here
'''
run_shell(command=f"cat > /tmp/script.py << 'SCRIPT_EOF'\n{script_content}\nSCRIPT_EOF")
# Step 2: Execute the script
result = run_shell(command="python3 /tmp/script.py", timeout=120)
Key Considerations
Timeouts
run_shelltypically needs longer timeouts thanexecute_code_sandbox- Use
timeout=60for simple scripts - Use
timeout=120or higher for library-heavy operations (PDF generation, data processing)
Library Availability
- Verify required libraries are installed in the shell environment
- Install missing libraries first if needed:
run_shell(command="pip install reportlab", timeout=60)
Error Handling
- Capture and inspect
run_shelloutput for Python errors - Check stderr for import failures or runtime exceptions
Working Directory
- Files created via
run_shellare in the current working directory by default - Use absolute paths or
os.getcwd()to reference files reliably
Example: PDF Generation with reportlab
# FALLBACK VERSION (when execute_code_sandbox fails):
pdf_code = """
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
from reportlab.lib.units import inch
def create_memo(filename):
c = canvas.Canvas(filename, pagesize=letter)
c.drawString(1*inch, 10*inch, "Legal Memorandum")
c.save()
print(f"Created {filename}")
create_memo('/workspace/output.pdf')
"""
# Write script to file
run_shell(command=f"cat > /tmp/create_pdf.py << 'PYEOF'\n{pdf_code}\nPYEOF")
# Execute and verify
run_shell(command="python3 /tmp/create_pdf.py", timeout=120)
# Verify output exists
run_shell(command="ls -la /workspace/output.pdf", timeout=30)
Comparison Table
| Aspect | execute_code_sandbox | run_shell (fallback) |
|---|---|---|
| Isolation | High (containerized) | Low (host environment) |
| Reliability | Can fail with e2b errors | More reliable |
| Library Access | Pre-configured sandbox | Depends on host |
| Timeout | Default 30s | Configurable |
| File Access | ARTIFACT_PATH convention | Direct filesystem |
Migration Checklist
When switching from execute_code_sandbox to run_shell:
- [ ] Increase timeout values (typically 2-4x)
- [ ] Convert ARTIFACT_PATH references to actual file paths
- [ ] Add explicit file verification steps after execution
- [ ] Handle potential library import errors
- [ ] Test script execution in shell environment first
04 同仓库更多 Skills
agentpilot
Set up AgentPilot and use its single entry to prepare missing inputs and run configured RSI experiments. Use when the user requests AgentPilot installation or work with AgentPilot.
remember
Review auto-memory entries and propose promotions to OPENSPACE.md, OPENSPACE.local.md, or retained auto-memory topics; detect duplicates, stale facts, conflicts, and ambiguous entries before making changes.
skill-discovery
Search reusable OpenSpace skills locally, and browse cloud packages step by step when a cloud skill may help. Reusing proven skills saves tokens, improves reliability, and extends your capabilities beyond built-in tools.
delegate-task
Delegate tasks to OpenSpace — a full-stack autonomous worker for coding, DevOps, web research, and desktop automation, backed by an extensive MCP tool and skill library. Skills auto-improve through use, reducing token consumption over time. A cloud community lets agents share and collectively evolve reusable skills.
write-special-chars-ts-check
Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, plus a reliable TypeScript type-checking step that filters output to only the newly-written files to avoid being misled by pre-existing errors.
write-special-chars-readback
Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, with mandatory post-write verification via read_file and cleanup of /tmp helper scripts.