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

Runloop

将 Runloop Devbox 连接到 Agents API 会话。

请参阅 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。

应用程序管理

  1. 创建自托管会话并保存其环境 ID。
  2. 创建使用该会话工作目录的 Runloop Devbox,并在其中安装 Codex CLI。
  3. 使用环境 ID 和环境密钥在后台启动执行器
  4. 发送输入并检查结果。对于文件任务,在工作空间中创建 brief.txt,并让智能体将迁移计划写入 plan.md
  5. 确认该轮交互已完成,获取您需要的所有文件,然后关闭 Devbox 并删除会话

为设置和执行设定明确的超时时限,并设置 Devbox 存活时间上限,以便在您的应用程序意外退出时提供兜底保障。如果您需要后续交互,请保持会话和 Devbox 运行。每个会话只能由一个主体负责资源预配;不要为应用程序直接管理的会话附加资源预配 webhook 处理程序。

参考资料