指南
API
博客
Version
指南
API
博客
简体中文

沙盒信息

概述

沙盒 API 提供了一个综合的环境，用于在隔离的容器环境中执行代码、管理文件以及与各种开发工具进行交互。该 API 旨在支持多种编程语言、文件操作、浏览器自动化和终端交互。

控制面板

沙盒控制面板提供了一个统一的 Web 界面，可通过 /index.html 访问，通过多个集成视图与所有沙盒功能进行交互。

控制面板视图

控制面板界面包含四个主要选项卡，用于不同的开发工作流程：

代码选项卡

代码选项卡提供了集成的代码编辑器环境：

  • 文件浏览器：导航和管理沙盒中的项目文件
  • 代码编辑器：具有语法高亮和自动完成功能的文件编辑
  • 多文件支持：同时打开和编辑多个文件
  • 文件操作：创建、重命名、删除文件和目录
  • 集成终端：直接从代码视图执行命令

浏览器选项卡

浏览器选项卡支持 Web 开发和测试：

  • 无头浏览器：用于 Web 自动化的 Chrome/Chromium 实例
  • 实时预览：Web 应用程序的实时预览
  • 开发者工具：检查元素、控制台、网络活动
  • 浏览器自动化：支持自动化测试和爬虫
  • 视口控制：调整屏幕大小和设备模拟
  • 截图捕获：对渲染页面进行截图

终端选项卡

终端选项卡提供完整的 shell 访问：

  • 交互式 Shell：具有完整命令行访问权限的 Bash 终端
  • 多会话支持：创建和管理多个终端会话
  • 命令历史：浏览之前执行的命令
  • 文件系统访问：完全访问沙盒文件系统
  • 包管理：安装和管理 Python/Node.js 包
  • 进程管理：运行和监控后台进程

Jupyter 选项卡

Jupyter 选项卡提供基于笔记本的开发：

  • Jupyter 笔记本：创建和编辑 .ipynb 笔记本文件
  • Python 内核：交互式执行 Python 代码单元
  • 丰富输出：显示图表、图像和格式化数据
  • Markdown 支持：将代码与文档混合
  • 变量浏览器：检查变量和数据结构
  • 会话持久性：跨执行维护内核状态

访问控制面板

本地访问
远程访问
# 控制面板可通过以下地址访问
http://localhost:8080/index.html

控制面板功能

集成开发环境

  • 在代码、浏览器、终端和 Jupyter 视图之间无缝切换
  • 所有选项卡共享文件系统
  • 持久会话状态
  • 实时更新和同步

项目管理

  • 通过拖放上传文件和项目
  • 下载文件和项目归档
  • Git 集成用于版本控制
  • 项目模板和快速启动

资源监控

  • CPU 和内存使用指示器
  • 磁盘空间利用率
  • 网络活动监控
  • 进程和服务状态

沙盒上下文

/llms.txt

llms.txt 是智能体的使用手册。通过这个手册，智能体可以更好地使用沙盒。

获取沙盒上下文

Python
Curl
ctx = client.sandbox.get_context()
print(ctx)

检索沙盒环境信息，包括系统配置和可用资源。

响应: SandboxResponse

  • success: 指示操作成功的布尔值
  • message: 操作结果消息
  • data: 沙盒环境数据
  • home_dir: 沙盒中的主目录路径

示例 data：

System Environment (v1.0.0.93):
- Linux 6.10.14-linuxkit (x86_64), with internet access
- User: e3f8da5a6253, with sudo privileges
- Home directory: /home/gem
- Timezone: Asia/Shanghai
- Occupied Ports: 8080,8079,8088,8091,8100,8101,8102,8200,8888,9222

Development Environment:
- Python 3.12.11 (commands: python3, pip3)
- Node.js v22.19.0 (commands: node, npm)
- Git git version 2.34.1 (command: git)
- GitHub CLI (command: gh)
- UV uv 0.8.9 (command: uv)

Available Tools:
- Text editors: vim, nano
- File operations: wget, curl, tar, zip, unzip, tree
- Network tools: ping, telnet, netcat, nmap
- Text processing: grep, sed, awk, jq
- System monitoring: htop, procps
- Image processing: imagemagick
- Audio/Video Downloader: yt-dlp

包管理

Python 包

列出沙盒环境中所有已安装的 Python 包。

Python
Curl
python_packages = client.sandbox.python_packages()
print(python_packages.data) # [{ "name": "requests", "version": "2.32.5" }]

响应: Response

  • 返回已安装 Python 包及其版本的列表

Node.js 包

列出沙盒环境中所有已安装的 Node.js 包。

Python
Curl
nodejs_packages = client.sandbox.nodejs_packages()
print(nodejs_packages.data)

响应: Response

  • 返回已安装 npm 包及其版本的列表