AGENT SKILL

sandbox-execution-fallback-238489

Fallback pattern for when execute_code_sandbox fails - write script to file and execute directly with run_shell

License 许可
MIT
所属仓库
HKUDS/AgentPilot
最近更新
2026-11-12
Stars
★ 8.0k
Forks
944

01 前言 Front Matter

name
sandbox-execution-fallback-238489
description
Fallback pattern for when execute_code_sandbox fails - write script to file and execute directly with run_shell

02 资源文件 1

03 SKILL.md 正文

Sandbox Execution Fallback

This skill provides a reliable fallback pattern when execute_code_sandbox fails for code execution tasks (especially PDF generation, complex file operations, or library-dependent tasks).

When to Use

Use this fallback pattern when:

  • execute_code_sandbox returns errors or fails to produce expected output
  • The task requires specific Python libraries not available in the sandbox
  • File I/O operations (especially PDF, docx, xlsx) fail in the sandbox environment
  • You need more control over the execution environment

Step-by-Step Instructions

Step 1: Write the Python Script to a File

Instead of executing code directly in the sandbox, use write_file to create a standalone Python script:

Use write_file to create a script (e.g., script.py) with your complete Python code.

Step 2: Execute the Script Directly

Run the script using run_shell with Python:

Use run_shell with command: python3 script.py

Step 3: Verify Output

Check that the script executed successfully and produced the expected files or output.

Example Pattern

Instead of this (sandbox execution):

execute_code_sandbox with code using libraries like reportlab, fpdf, etc.

Do this (fallback pattern):

# Step 1: Create the script
write_file:
  path: generate_pdf.py
  content: |
    from reportlab.lib.pagesizes import letter
    from reportlab.pdfgen import canvas
    
    def create_pdf(filename):
        c = canvas.Canvas(filename, pagesize=letter)
        c.drawString(100, 750, "Hello World")
        c.save()
    
    create_pdf("output.pdf")

# Step 2: Execute directly
run_shell:
  command: python3 generate_pdf.py

Best Practices

  1. Include all dependencies in the script - Make the script self-contained
  2. Add error handling - Include try/except blocks to catch and report errors
  3. Use absolute or clear relative paths - Ensure file paths work in the execution context
  4. Verify prerequisites - Check that required Python packages are available
  5. Clean up temporary files - Remove intermediate scripts after successful execution if needed

Troubleshooting

If run_shell also fails:

  • Check if Python 3 is available: run_shell command: python3 --version
  • Install missing packages: run_shell command: pip3 install package_name
  • Check file permissions and paths
  • Review error output from the shell execution for specific issues

Why This Works

This pattern bypasses sandbox limitations by:

  • Running code in the actual execution environment with full library access
  • Avoiding sandbox timeout or resource constraints
  • Enabling direct file system access for I/O operations
  • Providing better error messages from the native Python interpreter

Self-Assessment

This skill captures a genuinely reusable pattern that:

  • Is generalizable beyond just PDF generation to any execute_code_sandbox failure
  • Provides clear, actionable steps
  • Includes example code and troubleshooting guidance
  • Would benefit future executions facing similar sandbox limitations

04 同仓库更多 Skills

HKUDS
HKUDS/AgentPilot

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.

★ 8.0k
HKUDS
HKUDS/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.

★ 8.0k
HKUDS
HKUDS/AgentPilot

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.

Skill与智能体开发
★ 8.0k
HKUDS
HKUDS/AgentPilot

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.

Skill与智能体开发
★ 8.0k
HKUDS
HKUDS/AgentPilot

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.

★ 8.0k
HKUDS
HKUDS/AgentPilot

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.

★ 8.0k