OpenAI Vercel 沙箱

完整实现见Cookbook的应用管理与Webhook管理。执行器安装与连接要求见自托管沙箱。

• 应用管理：应用启动和停止沙箱。
• Webhook管理：处理器根据OpenAI事件启动或重连沙箱。

模式比较见沙箱生命周期。

开始之前

使用有Sandbox权限的Vercel项目。Sandbox SDK认证取决于应用运行位置：

• 本地运行：设置 VERCEL_TOKEN、VERCEL_TEAM_ID、VERCEL_PROJECT_ID。
• 部署在Vercel：使用Vercel OIDC。

应用请求使用 OPENAI_API_KEY。OPENAI_EXECUTOR_API_KEY 设置为环境密钥，只把后者作为 CODEX_API_KEY 传入沙箱。

1. 配置 Vercel 环境

创建自托管会话，保存环境ID。通过Vercel SDK或API创建工作目录匹配的隔离沙箱，安装Codex CLI，再用环境ID及环境密钥启动执行器。

常规使用可把Codex放入Vercel快照，缩短连接前准备。

2. 运行会话

执行器连接后，用运行与继续会话的HTTP示例提交输入并读取结果流。完成后分别删除会话和停止沙箱。

参考

• Vercel Sandbox文档。
• Vercel Python SDK。
• Vercel JavaScript/TypeScript SDK。