实施时先用 POST /v1/agents/environments 创建 openai_hosted 环境,提供 packages、files 与 setup_commands 等准备材料;再轮询环境状态直到 ready,或使用 webhook 等待就绪;用户任务到达后,把返回的 environment_id 传入 Agent Session。官方说明也允许在环境设置尚未完成时先关联,Agent 会等待工作区准备好。仅建议在预计很快需要任务时预热,因为未关联环境约 5 分钟后过期。官方示例所需最低 SDK 包括 Python 3.27.0、Node.js 7.31.0(其他语言有各自最低版本)。预热不等于免费运行整个会话,关联后按标准容器费率计费;应验证权限、SDK 版本、工作区复用及超时策略。本稿是官方文档与原作者教程的内容整理,未亲测。
OpenAI API / Agents / 教程与工作流
OpenAI Agents API 沙箱预热教程:提前准备环境,减少启动等待
OpenAI 官方提供 Agents API sandbox 预热流程,允许先创建环境、安装依赖和加载文件,在 Agent Session 开始时再关联环境 ID。开发者 VeitB 10 月 12 日整理了实操要点:挂载前预热免费,未关联环境约 5 分钟过期,挂载后执行标准容器计费。适合有明显启动准备开销的应用,本文未独立运行示例。
