For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主要導覽

Vercel

在 Vercel Sandbox 中執行 Agents API 工作階段。

請參閱 OpenAI Cookbook 中的應用程式管理webhook 管理範例。

如需執行器設定與連線需求,請參閱自行託管的沙盒

選擇佈建模式:

  • 應用程式管理 依照本指南,透過你的應用程式啟動與停止沙盒。
  • Webhook 管理 部署處理常式,在收到 OpenAI webhook 時啟動沙盒或重新連線至沙盒。

如需比較這兩種模式,請參閱沙盒生命週期

開始之前

使用具備沙盒存取權的 Vercel 專案。Vercel Sandbox SDK 的驗證方式取決於此應用程式的執行環境:

  • 在本機執行: 在環境中設定 VERCEL_TOKENVERCEL_TEAM_IDVERCEL_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 範例傳送輸入,並以串流方式接收結果。完成後,請刪除工作階段,並另行停止供應商端的沙盒。

參考資料