如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

Vercel

在 Vercel 沙盒中运行 Agents API 会话。

请参阅 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 示例发送输入,并以流式方式接收结果。完成后,请删除会话,并单独停止 Vercel 沙盒。

参考资料