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

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

参考资料