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

E2B

将 E2B 沙盒连接到 Agents API 会话。

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

选择沙盒预配模式:

  • 应用程序管理: 您的应用程序直接创建并连接 E2B 沙盒。
  • Webhook 管理: 部署一个处理程序,在收到 OpenAI webhook 事件时启动或重新连接沙盒。

有关两种模式的比较,请参阅沙盒生命周期。

开始之前

设置 E2B_API_KEY,并使用 OPENAI_API_KEY 发送应用程序请求。将 OPENAI_EXECUTOR_API_KEY 设置为环境密钥,并且只将这个环境密钥作为 CODEX_API_KEY 传入沙盒。

Webhook 管理

实现一个控制器,用于验证 OpenAI webhook 请求,并为每个会话预配独立的 E2B 工作实例。按照部署并连接处理程序中的说明配置凭据、注册端点并验证签名。

持久保存会话与沙盒之间的映射关系。收到连接请求时,如果工作实例已暂停,请恢复该实例;如果工作实例已删除,请创建新实例来替代它。暂停会保留实例中的文件,替换实例则不会。为控制器和工作实例设置运行超时时间,并在停止使用控制器时移除 OpenAI webhook。

应用程序管理

在您的应用程序中使用 E2B SDK 或 API 管理沙盒:

  1. 创建自托管会话,并保存其环境 ID。
  2. 创建一个隔离的 E2B 沙盒,为其配置会话的工作目录,并在沙盒内安装 Codex CLI。
  3. 使用环境 ID 和环境密钥在沙盒中启动执行器。
  4. 按照运行和继续会话中的说明发送输入并查看本轮运行结果。
  5. 完成后,删除会话并停止 E2B 沙盒。

分别设置沙盒的存续时间和执行器命令的超时时间。即使命令没有超时限制,沙盒到期后也不会继续运行。

参考资料