JSPM

@agentsphere/code-interpreter

1.0.6-beta.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 13
  • Score
    100M100P100Q50990F

云端代码沙箱 SDK - 为 AI agents 提供安全的代码执行环境

Package Exports

  • @agentsphere/code-interpreter
  • @agentsphere/code-interpreter/dist/index.js
  • @agentsphere/code-interpreter/dist/index.mjs

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@agentsphere/code-interpreter) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@agentsphere/code-interpreter

云端代码沙箱 SDK - 为 AI agents 提供安全的代码执行环境

简介

这是一个强大的云端代码执行平台 SDK,专为 AI agents 和自动化系统设计。提供安全隔离的沙箱环境,支持在云端运行各种编程语言的代码。基于 agentsphere-sandbox-base 构建,提供更好的性能和稳定性。

✨ 新特性 (v1.0.4)

  • 🔄 沙箱暂停/恢复功能 - 支持暂停沙箱状态并稍后恢复,保持代码执行上下文
  • 🔧 优化的依赖管理 - 从 e2b 迁移到 agentsphere-sandbox-base,提供更好的兼容性
  • 🏷️ 包名重构 - 新的包名 @agentsphere/code-interpreter 更符合命名规范
  • 🚀 改进的模板系统 - 使用新的 code-interpreter-v1 模板,提供更好的性能
  • 🔐 增强的身份验证 - 支持访问令牌和更灵活的头部配置
  • 📦 TypeScript 优化 - 更好的类型定义和代码格式化

安装

npm install @agentsphere/code-interpreter

快速开始

1. 获取 API 密钥

  1. 注册 agentsphere 账号 这里
  2. 获取 API 密钥 这里
  3. 设置环境变量:
AGENTSPHERE_API_KEY=your_api_key_here

2. 基础使用

import { Sandbox } from '@agentsphere/code-interpreter'

const sandbox = await Sandbox.create()
console.log('沙箱已创建:', sandbox.sandboxId)

// 执行 Python 代码
const execution = await sandbox.runCode(`
import numpy as np
import matplotlib.pyplot as plt

x = np.linspace(0, 10, 100)
y = np.sin(x)

plt.plot(x, y)
plt.title('正弦波')
plt.show()
`)

console.log('执行结果:', execution.text)
console.log('图表数据:', execution.results[0]?.data)

3. 沙箱暂停与恢复 🆕

import { Sandbox } from '@agentsphere/code-interpreter'

// 创建沙箱并执行代码
const sbx = await Sandbox.create()
await sbx.runCode('x = 42')

// 暂停沙箱
const sandboxId = await sbx.betaPause()
console.log('沙箱已暂停:', sandboxId)

// 稍后恢复沙箱
const resumedSbx = await Sandbox.connect(sandboxId)
const result = await resumedSbx.runCode('print(f"x 的值是: {x}")')
console.log(result.text) // 输出: x 的值是: 42

await resumedSbx.kill()

API 文档

核心方法

Sandbox.create(template?: string)

创建新的沙箱实例

runCode(code: string, options?: RunCodeOpts)

执行代码,支持回调和自定义配置

createCodeContext(options?: CreateCodeContextOpts)

创建新的代码执行上下文

betaPause() 🆕

暂停沙箱状态,返回沙箱ID用于后续恢复

Sandbox.connect(sandboxId: string) 🆕

连接到已暂停的沙箱实例

选项接口

interface RunCodeOpts {
  onStdout?: (output: OutputMessage) => Promise<any> | any
  onStderr?: (output: OutputMessage) => Promise<any> | any
  onResult?: (data: Result) => Promise<any> | any
  onError?: (error: ExecutionError) => Promise<any> | any
  envs?: Record<string, string>
  timeoutMs?: number
  requestTimeoutMs?: number
}

支持的语言

  • Python (默认)
  • JavaScript/TypeScript
  • Java
  • R
  • Bash
  • 更多语言持续添加中...

更新日志

v1.0.4 (最新)

  • ✅ 添加沙箱暂停/恢复功能
  • ✅ 迁移到 agentsphere-sandbox-base 依赖
  • ✅ 更新包名为 @agentsphere/code-interpreter
  • ✅ 优化 TypeScript 类型定义
  • ✅ 改进错误处理和超时机制
  • ✅ 增强身份验证支持

开始使用云端沙箱,让您的应用拥有安全的代码执行能力! 🚀