Box Mount：为沙盒 AI Agent 提供 Box 工作区

作者：@41five

Box Mount 现已开启私有预览。

如果你正在构建一个运行在沙箱中的 AI Agent，让模型完成有用的工作只是任务的一部分。Agent 仍然需要处理的文档、操作这些文档的工具，以及存放生成文件的地方。

一开始，移动这些文档看起来只需要几次 API 调用：下载输入、运行 Agent、上传结果。但当文件在工作流中会发生变化、需要人工审核输出，或者多个 Agent 共享同一份内容时，这一层就会变得复杂起来。这时你还需要处理同步、版本、冲突和重试等问题。

Box Mount 正是为工作流的这一环节而设计的。它为 Agent 沙箱提供了一个兼容 POSIX 的 Box 工作区，让沙箱内的代码和工具可以通过熟悉的文件路径来操作 Box 内容。Box Mount 负责双向的文件流转，而 Box 始终是受管控的记录系统（system of record）。

什么时候适合使用 Box Mount

Box Mount 并不是要取代所有的 Box API 或 MCP 调用。如果你的 Agent 只需要获取一份文档并把它加进提示词里，那么这些接口可能已经足够满足需求了。

区别在于：文档仅仅是上下文，还是 Agent 工作环境的一部分。

想象这样一个 Agent：它审查一个文件夹里的合同，运行文档处理工具，生成一份审查备忘录，然后等待律师进行修改。或者一个 RFP 工作流：从已批准回复库中提取内容、生成草稿，再发回给法务和安全团队审核。

在这些场景中，Agent 不只是获取一次内容就结束。它是在外部运行时环境中处理一批文件。

这正是 Box Mount 所针对的模式：开发者配置一个 Agent 沙箱，把 Box 内容引入该环境，再把 Agent 的工作成果回传到 Box。

看看 Box Mount 的实际效果

这个简短的演示展示了一个合同审查应用如何使用 Box Mount 将 Box 内容引入 E2B 沙箱，在该工作区上运行 Agent，并将完成的审查结果同步回 Box 供人工复核。

这里展示了一个多 Agent 交易室审查场景：使用 Box Mount 将企业内容引入 OpenAI Agents API 沙箱，并行运行一个主 Agent 和三个专家 Agent 处理五个源文件，并在底层 MSA 被修订时自动将四份报告同步回 Box。

这个演示展示了安全问卷审查：使用 Box Mount 将已批准的政策文档引入 Vercel Sandbox microVM，运行 Agent 处理 12 个条目，为其中 10 个通过项找出证据，并将另外 2 个标记为需人工复核，最后自动将完成的 Excel 工作簿同步回 Box。

这个演示展示了交易室尽调备忘录：使用 Box Mount 让 DigitalOcean 沙箱中的 Agent 能够用普通文件路径访问 Box 云端内容，在本地读取交易室文档，并把完成的备忘录写回 Box，全程无需编写任何下载或上传逻辑。

沙箱中熟悉的工作区

挂载 Box 文件夹后，Agent 看到的就是一个普通目录：

1/mnt/box
2├── Incoming/
3│   └── Acme-MSA.docx
4├── Playbook/
5│   └── approved-contract-playbook.md
6└── Reviewed/

在此基础上，现有的库和命令行工具就可以直接操作这些内容，无需为每个操作都准备专门的 Box 工具。例如，Node 应用可以使用与操作本地文件相同的文件系统 API：

1import { readFile, writeFile } from "node:fs/promises";
2
3const playbook = await readFile(
4  "/mnt/box/Playbook/approved-contract-playbook.md",
5  "utf8",
6);
7
8const review = await reviewContract({
9  contractPath: "/mnt/box/Incoming/Acme-MSA.docx",
10  playbook,
11});
12
13await writeFile(
14  "/mnt/box/Reviewed/Acme-MSA-review.md",
15  review,
16);

从应用的角度看，最后那次写入只是一个普通的文件操作。Box Mount 会把新的审查结果同步到 Box，在那里人们可以打开它、编辑它、分配任务或创建新版本。

如果在沙箱仍在运行时有人在 Box 中更新了文件，这个变更也可以回流到已挂载的工作区中，供 Agent 下一步使用。这就为 Agent 和人类创建了一个共享的工作环境，开发者无需围绕每个文件去构建自定义的传输和同步逻辑。

这也让工作流不再过度依赖某个特定的模型或 Agent 框架。沙箱里可以运行 OpenAI Agent、Anthropic Agent、LangGraph、CrewAI、Python 脚本、LibreOffice CLI，或者多种工具的组合。只要工具知道如何操作文件，就能使用这个已挂载的工作区。

各组件如何协同工作

你的产品或编排器负责配置沙箱并运行 Agent。Box Mount 作为无头（headless）同步组件运行在该沙箱内，提供文件系统接口，并通过 Box API 与 Box 通信。

Agent 通过挂载路径进行操作，而不是每次文档操作都去调用 Box。Box Mount 会保持文件夹最新、上传变更、检测冲突更新，并在工作区卸载时完成最终同步。

Box 继续提供内容层能力，包括权限、版本、分类、保留策略、Shield 防护和审计历史。沙箱中包含的是同步后的工作副本，因此开发者仍应根据自身的安全要求来管理该环境及其本地数据。

客户的产品负责配置沙箱并运行 Agent。Box Mount 通过 Box API 将 Agent 的文件系统工作区连接到 Box。

使用 Box Mount

Box Mount 的基本工作流只需几条命令。首先，配置你的 Box 凭据：

1box-mount config

将 Box 文件夹挂载到 Agent 的沙箱中：

1mkdir -p /mnt/box
2box-mount mount "/mnt/box" "<box-folder-id>"

挂载完成后，Agent 就可以使用普通的文件系统工具了：

1find /mnt/box -type f
2cat /mnt/box/Playbook/approved-contract-playbook.md
3cp generated-review.md /mnt/box/Reviewed/

你可以在 Agent 运行期间检查当前挂载状态：

1box-mount status

运行结束后，卸载工作区并完成最终同步：

1box-mount unmount "/mnt/box"

身份验证和资源配置方式取决于你的应用如何启动沙箱。随二进制文件提供的私有预览文档中涵盖了可用的配置选项。

你能用它构建什么？

合同审查就是一个例子。Agent 可以将收到的协议与已批准的 playbook 进行比对，把发现写回 Box，然后把结果交给律师。如果律师在 Box 中修改了审查内容，Agent 也能在自己的工作环境中看到更新后的文件。

同样的模式还可以支持提案和 RFP 起草、交易室分析、高管简报制作、研究综述、合规审查以及其他以文档为核心的工作流。多个 Agent 也可以通过同一个共享的 Box 文件夹协作——比如一个负责起草，另一个负责审查，最后由人来拍板。

模型和工作流可以变化，但底层模式始终如一：Box 内容进入外部沙箱，成为 Agent 工作环境的一部分，最终产出的成果再回到 Box。

探索示例应用

Box Mount 合同审查示例 展示了使用 E2B 的完整工作流。

该应用会创建沙箱、安装 Box Mount、挂载 Box 合同工作区，并运行 Box AI 或 OpenAI Agent。随后它将生成的审查结果同步回 Box，可选择将其分配给人工审核者，并保持沙箱运行，以便开发者在销毁前检查结果。

该仓库目前为私有仓库，不包含 Box Mount 二进制文件。私有预览参与者需要获得仓库访问权限，并在运行示例前将自己获得的二进制文件放入项目的 private/ 目录中。

加入私有预览

Box Mount 仍处于早期阶段，我们正在寻找那些正在构建（或刚开始探索）在沙箱中运行并操作 Box 内容的 Agent 工作流的开发者。

如果这听起来符合你的架构，我们很想了解你现在是如何传输内容的、沙箱里运行着什么，以及现有方案在哪些地方开始让人感到痛苦。私有预览参与者将获得 Box Mount 二进制文件和设置指南，从而可以在自己的工作流中进行尝试。

https://bit.ly/box-mount-preview

如果需要让 Box 内容成为你 Agent 工作环境的一部分，我们非常期待看到你构建的成果。