沙盒
没有沙盒时,Agent 只能对话;有了沙盒,它才能真的运行命令、改文件、起服务。
两种运行方式
Section titled “两种运行方式”左侧菜单 SandBox 里可以配置:
| 方式 | 适合谁 | 特点 |
|---|---|---|
| 本地容器 | 自建/单机部署 | 自己提供运行环境,资源与镜像可控 |
| E2B | 使用托管沙盒 | 填 API Key 与模板即可,按需创建 |
两种方式可以并存,但同一时间只有一个处于活跃状态。
| 字段 | 说明 |
|---|---|
| Server 地址 | 容器服务的访问地址 |
| Server 鉴权 Key | 访问容器服务所需的密钥 |
| 默认镜像 | 新沙盒使用的镜像 |
| CPU / 内存 / 磁盘 | 单沙盒资源上限;磁盘是硬资源,必填 |
| 预览域名 | 把沙盒端口映射成可访问地址时使用 |
| 预览协议 | http / https |
| 要求签名访问 | 开启后预览链接带签名,避免被猜到地址 |
| 预览地址有效期 | 到期自动失效,单位小时 |
| 字段 | 说明 |
|---|---|
| 实例标识 / 显示名称 | 区分不同环境 |
| E2B 域名 | 服务地址 |
| 沙盒访问域名 | 可选,自定义访问入口 |
| API Key | E2B 的密钥 |
| 沙箱模板 | 使用哪个预置模板 |
| 使用 HTTPS | 生产环境建议开启 |
| 环境描述 | 可选,写清用途 |
| Skills Git 仓库 | 可选,从公开仓库拉取技能 |
配置好后可以构建模板;模板构建完成会出现在下拉框里。
在会话中使用
Section titled “在会话中使用”- 创建或进入会话后,按界面提示启用沙盒。
- Agent 执行命令时会在沙盒内运行,输出回到会话里。
- 可以查看执行日志、打开预览、随时回收沙盒。
如果配置了预览域名,沙盒里启动的服务可以被映射成 URL:
- 在沙盒里启动服务,例如监听
3000。 - 在会话的沙盒面板里添加端口。
- 打开生成的预览地址。
开启「要求签名访问」后,链接会带时效签名,适合对外演示。
沙盒启动失败:检查 Server 地址/Key、镜像是否存在、磁盘配额是否足够。
命令超时:长任务用后台执行;或调大工具的默认超时。
预览打不开:确认服务监听在 0.0.0.0,端口填写正确,预览域名已解析。
产物丢了:沙盒回收后内部文件不再保留;需要长期保存的内容请下载或提交到仓库。