跳转到内容
EN

沙盒

没有沙盒时,Agent 只能对话;有了沙盒,它才能真的运行命令、改文件、起服务。

左侧菜单 SandBox 里可以配置:

方式 适合谁 特点
本地容器 自建/单机部署 自己提供运行环境,资源与镜像可控
E2B 使用托管沙盒 填 API Key 与模板即可,按需创建

两种方式可以并存,但同一时间只有一个处于活跃状态。

字段 说明
Server 地址 容器服务的访问地址
Server 鉴权 Key 访问容器服务所需的密钥
默认镜像 新沙盒使用的镜像
CPU / 内存 / 磁盘 单沙盒资源上限;磁盘是硬资源,必填
预览域名 把沙盒端口映射成可访问地址时使用
预览协议 http / https
要求签名访问 开启后预览链接带签名,避免被猜到地址
预览地址有效期 到期自动失效,单位小时
字段 说明
实例标识 / 显示名称 区分不同环境
E2B 域名 服务地址
沙盒访问域名 可选,自定义访问入口
API Key E2B 的密钥
沙箱模板 使用哪个预置模板
使用 HTTPS 生产环境建议开启
环境描述 可选,写清用途
Skills Git 仓库 可选,从公开仓库拉取技能

配置好后可以构建模板;模板构建完成会出现在下拉框里。

  • 创建或进入会话后,按界面提示启用沙盒。
  • Agent 执行命令时会在沙盒内运行,输出回到会话里。
  • 可以查看执行日志、打开预览、随时回收沙盒。

如果配置了预览域名,沙盒里启动的服务可以被映射成 URL:

  1. 在沙盒里启动服务,例如监听 3000。
  2. 在会话的沙盒面板里添加端口。
  3. 打开生成的预览地址。

开启「要求签名访问」后,链接会带时效签名,适合对外演示。

沙盒启动失败:检查 Server 地址/Key、镜像是否存在、磁盘配额是否足够。

命令超时:长任务用后台执行;或调大工具的默认超时。

预览打不开:确认服务监听在 0.0.0.0,端口填写正确,预览域名已解析。

产物丢了:沙盒回收后内部文件不再保留;需要长期保存的内容请下载或提交到仓库。