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

Modal

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

请参阅 OpenAI Cookbook 中的应用管理Webhook 管理示例。

有关执行器设置和连接要求,请参阅自行托管的沙盒

选择资源预配模式:

  • 应用管理 按照本指南,从您的应用中启动和停止沙盒。
  • Webhook 管理 部署处理程序,根据 OpenAI Webhook 启动或重新连接沙盒。

请参阅沙盒生命周期,了解这两种模式的区别。

开始之前

您需要准备 OpenAI 项目 API 密钥、Modal 令牌 ID 和密钥,以及 Codex CLI 软件包。

使用 OPENAI_API_KEY 发起应用程序请求。将 OPENAI_EXECUTOR_API_KEY 设为环境密钥,并仅将该密钥以 CODEX_API_KEY 的形式传入沙盒。

1. 设置 Modal 环境

创建一个自托管会话并保存其环境 ID。使用 Modal SDK 或 API 创建一个采用已配置工作目录的隔离沙盒。在沙盒中安装 Codex CLI,然后使用该环境 ID 和环境密钥启动其执行器

2. 运行会话

Modal 执行器连接后,使用运行和继续会话中的 HTTP 示例发送输入并以流式方式接收结果。完成后,删除会话,并单独停止提供商的沙盒。

参考资料