Sandbox Fallback Execution

When to Use This Skill

Use this pattern when

execute_code_sandbox

run_shell

Pattern Overview

execute_code_sandbox fails → run_shell with pip install → Python heredoc execution

Step-by-Step Instructions

Step 1: Detect Sandbox Failure

Monitor for these failure indicators from

execute_code_sandbox

• Unknown or unexplained errors
• Repeated execution failures (>2 attempts)
• Timeout errors
• Environment/package availability issues

Step 2: Install Required Dependencies (If Needed)

Use

run_shell

pip install <package_name>

For multiple packages:

pip install package1 package2 package3

Step 3: Execute Python via Heredoc

Run Python code using a heredoc script with

run_shell

python3 << 'EOF'
# Your Python code here
import sys
print("Hello from fallback execution")
EOF

Key heredoc syntax notes:

• Use

  << 'EOF'

  (quoted) to prevent shell variable expansion
• Use

  << EOF

  (unquoted) if you need shell variable interpolation
• Close with

  EOF

  on its own line

Step 4: Verify and Iterate

• Check stdout/stderr for success indicators
• If errors persist, inspect output and adjust the script
• Capture any generated artifacts (files, outputs) for verification

Complete Example

Scenario: Need to create a Word document but

execute_code_sandbox

# Step 1: Install required package
pip install python-docx

# Step 2: Execute Python script via heredoc
python3 << 'EOF'
from docx import Document

doc = Document()
doc.add_heading('Proposal Document', 0)
doc.add_paragraph('This is the proposal content.')
doc.save('proposal.docx')
print("Document created successfully")
EOF

Best Practices

1. Quote the heredoc delimiter (

   'EOF'

   ) to avoid unintended shell expansion of Python code
2. Install packages first before running the script to ensure availability
3. Print status messages in your script for easier debugging
4. Save outputs to files when possible for verification
5. Keep scripts focused - break complex tasks into multiple heredoc executions if needed

Troubleshooting

pip

pip3

python3 -m pip install

run_shell

Related Tools

• run_shell

  : Execute shell commands directly

• execute_code_sandbox

  : Primary Python execution tool (try first)

• shell_agent

  : For more complex multi-step shell tasks