All-In-One Sandbox：Agent自动化任务的统一执行环境

All-In-One Sandbox：Agent自动化任务的统一执行环境当你的Agent需要同时操作浏览器、执行代码、运行Shell命令来完成一个任务时，是否曾陷入这样的困境：浏览器下载的文件要上传到云存储，代码沙箱才能读取；代码生成的结果又要重新上传，供下一个工具使用……这种“文件共享噩梦”让本该流畅的自动化流程变得支离破碎。阿里云AgentRun团队推出的All-In-One Sandbox（AIO），正是为了解决这一系列痛点而生。一、传统沙箱方案的四大痛点在开发AgentRun的过程中，团队深刻体会到现有沙箱方案的零散带来的问题：1.1 文件共享噩梦浏览器沙箱下载的文件需先上传到NAS/OSS，代码沙箱才能使用代码生成的文件又要重新上传，其他沙箱再下载多个沙箱间的文件传递慢如蜗牛1.2 工具协调复杂完整Agent任务往往需要同时调用浏览器、代码执行和Shell环境需手动编排多个沙箱的启动、通信和数据传递调试时要在多个地方切换看日志，效率极低1.3 环境配置繁琐本地方案需要安装Node.js、浏览器、各类系统依赖多沙箱方案每个环境都要单独配置管理环境污染问题严重，任务间相互干扰1.4 成本与效率双重打击多个沙箱同时运行，内存占用翻倍文件传输依赖网络I/O，延迟高需额外付费购买OSS/NAS存储服务二、All-In-One Sandbox的核心设计2.1 统一架构：把所有组件放进同一个沙箱AIO的解决方案简单而直接：将浏览器、Shell、代码执行、文件系统全部集成在同一个沙箱实例中。对比项传统多沙箱方案All-In-One沙箱启动时间2个沙箱启动=4-15秒1个沙箱启动=5秒文件传递通过OSS，耗时2-3秒直接访问，100ms内存占用2×独立运行=2c2g+2c2g1×共享运行=2c2g2.2 底层技术栈浏览器：Chromium 136+（固定版本，稳定可靠）协议：WebSocket CDP（:5000/ws/automation端口）隔离：函数计算资源隔离及严格的资源限制文件系统：支持实例级别的NAS/OSS动态挂载2.3 五大核心能力代码执行：内置Node.js + 原生Puppeteer自动化脚本支持文件处理：提供FileSystem API，可通过MCP方式调用状态保持：结合OSS/NAS动态挂载，支持多步骤任务实时日志：流式输出执行日志，监控毫不费力多工具集成：VNC、Terminal、代码执行无缝配合三、快速上手：第一个AIO任务3.1 安装SDKpipinstallagentrun-sdk['server','playwright']3.2 验证沙箱基本功能fromagentrun.sandboximportSandbox,TemplateTypeimportasyncioasyncdefquick_start():# 创建沙箱sandbox=Sandbox.create(template_type=TemplateType.AIO,template_name="quick-test",sandbox_idle_timeout_seconds=600)print(f"沙箱已创建:{sandbox.sandbox_id}")# 执行代码：连接已运行的浏览器，获取页面标题code=""" const puppeteer = require('puppeteer-core'); const browser = await puppeteer.connect({ browserWSEndpoint: 'ws://localhost:5000/ws/automation' }); const page = (await browser.pages())[0]; await page.goto('https://example.com'); console.log(await page.title()); await browser.disconnect(); """awaitsandbox.context.execute_async(code=code,language="javascript")sandbox.destroy()asyncio.run(quick_start())3.3 多步骤任务实战第一步：打开登录页constpuppeteer=require('puppeteer-core');constbrowser=awaitpuppeteer.connect({browserWSEndpoint:'ws://localhost:5000/ws/automation'});constpage=(awaitbrowser.pages())[0];