跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

选择 sandbox 环境

最后更新 查看 MarkdownAgent 设置

sandbox 运行你未编写、也不信任的代码,例如模型生成的代码或仓库的测试套件。Cloudflare 会在两种环境之一中运行它:Container(运行 Linux 镜像),或 Dynamic Worker(针对你的 Worker 提供的方法运行 JavaScript)。由你的 Worker 启动其中一种,且同一个 Worker 可以同时使用两者。

代码可以使用什么

Container 中的代码可以使用其 Linux 镜像中的一切:运行时、软件包、文件,以及它启动的进程。

动态 Worker 中的代码可以使用 Workers 运行时 API,以及 Worker 传入的模块、方法和值。它不会继承 Worker 的绑定、凭据或数据。除非将 globalOutbound 设为 null,否则它可以访问 Internet。

当代码需要 Linux 时使用 Container

大多数现有工具既需要操作系统,也需要语言运行时。npm test 需要 Node.js、文件系统上的依赖以及子进程。预览 server 会保持进程运行并监听端口。编译器可能需要工具链或原生二进制文件。

JavaScript 代码也可能需要 Linux。Dynamic Worker 无法启动子进程或加载原生插件,且 Workers 对部分 Node.js 模块仅实现了部分功能。关于 Workers 支持的内容,请参阅 Node.js 兼容性。

你的 Worker 决定 container 何时启动、是否可以访问互联网,以及哪些 HTTP 请求会到达它。Agents sandbox 工具 使用 Container 为 Agent 运行命令。

当代码调用已知方法时使用 Dynamic Worker

当代码只需调用你定义的方法时(例如针对已知 API 的脚本),请在 Dynamic Worker 中运行它。你的 Worker 在传入方法之前,会先决定每个方法可以访问什么。

例如,你的 Worker 可以传入仅对一个仓库生效、并自行保管 API token 的 listPullRequests() 方法。生成的代码可以筛选 pull request,但无法访问其他仓库或读取 token。更多信息请参阅 Bindings。

Code Mode 将此模式用于 Agent。模型针对带类型的方法编写 JavaScript,Dynamic Worker 运行它,只有结果会返回到模型上下文。

load() 会创建新的 Dynamic Worker。使用稳定 ID 的 get() 可让运行时在相同代码再次运行时复用已预热的 Dynamic Worker。要为生成的应用提供独立存储,请使用 Durable Object facets。该存储不会让应用访问你的其他资源。

每种环境如何隔离代码

Container 运行在自带内核和网络的 Firecracker microVM 中,不会与其他工作负载共享。你的镜像作为 Linux container 运行在该 VM 内。

V8(Chrome 中的 JavaScript 引擎)会在无法读取外部内存的 sandbox 中运行每个 Dynamic Worker。Workers 运行时还会在其外围添加进程级 sandbox。更多信息请参阅 Workers 安全模型。

你需要维护什么

使用 Container 时,你需要构建并更新镜像。现有工具无需修改即可运行,但必须先启动 container 才能运行第一条命令。更多信息请参阅 Container 冷启动。

使用 Dynamic Worker 时,你需要编写每个方法并决定其返回内容。当生成的代码需要另一项操作时,你再添加一个方法。加载 Dynamic Worker 的代码会列出生成代码可以访问的一切。

在同一应用中同时使用两者

编程 Agent 可以通过 Dynamic Worker 中带范围限制的方法回答关于仓库的问题。当 Agent 提出补丁时,同一个 Worker 可以启动 Container 并运行该仓库的测试套件。

运行 JavaScript

向 Worker POST JavaScript,并读取 sandbox 中的运行结果。

这篇文档对您有帮助吗?