Cloudflare Sandbox SDK

活跃
GitHub TypeScript NOASSERTION

简介

在 Cloudflare 边缘网络上运行隔离代码环境的 TypeScript SDK,支持多语言与 AI Agent 工具调用。

核心特性

  • 边缘沙箱 — 在 Cloudflare 全球网络运行轻量级 microVM 沙箱,低延迟启动
  • 多语言执行 — 支持 Python/Node.js/Java/Bash 等多语言代码运行
  • 快照与恢复 — 沙箱状态可快照并快速恢复,适合长任务 Agent
  • 文件与进程 API — 提供文件读写、命令执行、流式输出
  • Agent 工具集成 — 原生暴露 `@tool` 装饰器,直接注册为 AI Agent 工具

适用场景

💡 部署 AI Agent 工具让大模型安全执行任意代码片段
💡 在边缘节点运行用户提交的不可信脚本,作为代码解释器后端
💡 为工作流自动化提供隔离的执行环境
💡 集成到 RAG/工具链,实现数据预处理与计算

快速开始

# 安装 Cloudflare Sandbox SDK
npm install @cloudflare/sandbox-sdk

# 创建一个简单的 Python 执行器
import { getSandbox } from '@cloudflare/sandbox-sdk';
const sb = getSandbox('my-agent');
const result = await sb.exec('python', 'print(sum(range(10)))');

相关项目