如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

Vercel

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

請參閱 OpenAI Cookbook 中由應用程式管理沙盒和透過 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 提供的沙盒。

參考資料