请参阅 OpenAI Cookbook 中的应用程序管理示例。
本指南采用 应用程序管理 的资源预配方式:您的应用程序启动 Devbox、连接其执行器,并在完成后关闭 Devbox。有关生命周期行为,请参阅沙盒生命周期。
开始之前
使用 Runloop SDK 或 API 管理 Devbox,并使用 HTTP 请求管理 Agents API 会话。
设置 RUNLOOP_API_KEY,并使用 OPENAI_API_KEY 发送应用程序请求。将 OPENAI_EXECUTOR_API_KEY 设置为环境密钥,并仅将该密钥作为 CODEX_API_KEY 传入 Devbox。
应用程序管理
- 创建自托管会话并保存其环境 ID。
- 创建使用该会话工作目录的 Runloop Devbox,并在其中安装 Codex CLI。
- 使用环境 ID 和环境密钥在后台启动执行器。
- 发送输入并检查结果。对于文件任务,在工作空间中创建
brief.txt,并让智能体将迁移计划写入plan.md。 - 确认该轮交互已完成,获取您需要的所有文件,然后关闭 Devbox 并删除会话。
为设置和执行设定明确的超时时限,并设置 Devbox 存活时间上限,以便在您的应用程序意外退出时提供兜底保障。如果您需要后续交互,请保持会话和 Devbox 运行。每个会话只能由一个主体负责资源预配;不要为应用程序直接管理的会话附加资源预配 webhook 处理程序。