OpenAI在9月10日发布Agents API公开测试版，把Codex使用的Agent执行框架和长任务基础设施开放给开发者。API负责模型调用、上下文管理、工具使用和子Agent协调，开发者可选择OpenAI托管沙箱、自有基础设施或合作伙伴环境。它降低了搭建Agent循环的门槛，但文件、密钥、网络和外部动作仍由应用方负责设计权限。
先选择执行环境
无敏感数据的短期原型可使用托管沙箱快速启动；需要特定网络、数据驻留或硬件的任务选择VPC或自建环境。比较CPU、内存、冷启动、存储、区域、日志和成本。环境选择要对应数据分类，而不是只看哪种接入最省代码。
把文件和密钥分开管理
任务文件只在必要时间挂载，输出经过扫描后再导出。API密钥通过密钥服务按任务注入，禁止写入提示、仓库或生成产物。Agent只能访问指定域名和工具，默认关闭任意公网请求与本地系统访问。任务结束按策略销毁环境。
长会话需要外部状态
自动上下文压缩有助于连续运行，但业务事实、审批和进度不能只存在模型上下文。把任务状态、已完成步骤、产物位置和待确认项写入结构化存储。每次恢复先读取状态并校验，不允许模型凭压缩摘要猜测已执行动作。
子Agent按职责与预算拆分
研究、实现、测试和审查可以并行，但每个子Agent要有明确输入、输出、工具和截止条件。主Agent只合并有证据的结果。设置最大并发、令牌、工具调用和运行时间，防止错误任务不断派生或并行费用失控。
生产动作加入审批和幂等
发邮件、修改数据库、发布内容或部署服务前生成预览，由规则和人确认。每个动作带唯一幂等键，重试不应重复执行。保存Agent、模型、沙箱、工具参数和结果日志，异常时可以立即停止、撤销权限和回滚。
进一步实施建议
建议先实现一个只读Agent：读取指定文档，生成报告和来源清单。稳定后再增加代码执行，最后才开放外部写操作。评测包含正常完成、工具超时、恶意文件、提示注入、上下文压缩和人工拒绝。公开测试版接口仍可能变化，生产系统应封装适配层、固定版本并准备回退路径，不把核心业务直接绑死在实验字段上。
落地检查清单
- 执行环境与数据分类相匹配。
- 密钥不进入提示、文件和产物。
- 长任务状态写入外部结构化存储。
- 外部写操作采用审批、幂等与回滚。
