SuperAPI AI 工具集

sandbox-sdk

智能体与模型

查看项目

更新于 10-16 06:22

技能介绍

用途:构建或审查 Cloudflare Sandbox SDK 集成,覆盖安全代码执行、智能体沙箱等场景。核心原则是把 Sandbox SDK 的配置与 API 视为版本敏感内容,先检查仓库,再获取当前 Cloudflare 官方文档,项目既有约定优先于通用示例。

主要能力与用法:编辑前先读仓库的 AGENTS.md 与贡献规则,定位包管理器与锁文件、声明 @cloudflare/sandbox 的清单、基于 cloudflare/sandbox 的 Dockerfile、wrangler.toml/json/jsonc、Worker 入口、Sandbox 绑定、Durable Object 迁移与容器配置,以及仓库自有的构建、类型检查、测试和本地运行命令。可用 rg 搜索相关文件与依赖。若包版本与镜像版本不一致,应报告并停止,不要擅自选择版本。

配置上通常需要容器、Durable Object 绑定与迁移三类概念,需合并进现有 Wrangler 格式,不替换无关路由、绑定、环境或兼容性设置;不重复已有绑定或迁移。Worker 需按所装 SDK 版本导出 Sandbox 类,例如 import { getSandbox } from "@cloudflare/sandbox"; export { Sandbox } from "@cloudflare/sandbox";。

版本对齐:Docker 基础镜像版本须与 @cloudflare/sandbox 包版本匹配;默认镜像精简,面向 JavaScript/TypeScript,需要 Python 时用 -python 变体。API 使用前须核对当前签名,Sandbox ID 应基于真实用户、会话或工作负载边界,临时 Sandbox 需销毁,持久会话状态不应作为通用清理销毁。

验证:用仓库自有命令,从静态到运行时逐步验证,包括 Wrangler 语法与绑定类型、类型检查与聚焦测试、包与镜像版本匹配、本地容器后端健康、实际 Sandbox 操作、Worker 与容器日志,以及暴露服务的进程与外部请求路径。仅凭配置审查不能断言 Sandbox 健康。

限制:资料未提供具体收费、价格、平台支持范围与效果数据;预览与端口 API 会变化,须以官方文档为准。