请参阅 OpenAI Cookbook 中的应用管理和 Webhook 管理示例。
有关执行器设置和连接要求,请参阅自行托管的沙盒。
选择一种资源配置模式:
- 应用管理: 按照本指南,从您的应用中启动和停止沙盒。
- Webhook 管理: 部署一个处理程序,根据 OpenAI Webhook 启动沙盒或重新连接沙盒。
请参阅沙盒生命周期,了解这两种模式的区别。
开始之前
请使用具有沙盒访问权限的 Vercel 项目。Vercel 沙盒 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. 运行会话
Vercel 执行器连接后,使用运行和继续会话中的 HTTP 示例发送输入并以流式方式接收结果。完成后,请删除会话,并另行停止提供商的沙盒。