OpenAI Agents API
20 days ago
- Agents API 提供了一个由 OpenAI 管理的 Codex 框架，用于处理会话、编排、上下文压缩和恢复，而您的应用程序则提供工具并选择执行环境。
- 代理可以在沙箱中运行以执行代码、编辑文件、连接到 MCP 服务器并生成工件，使用费用按模型 API 费率、标准 OpenAI 工具费率和 OpenAI 托管沙箱的标准容器费率计费。
- 该 API 围绕四个核心概念构建：代理（模型、指令、工具、MCP 服务器）、环境（可选沙箱或计算机）、会话（持久化代理实例）以及事件/项目（会话期间的输入和输出）。
- 会话生命周期包括创建会话、向代理分配任务、流式输出或使用 webhook 跟踪进度，以及在后续轮次中继续或引导代理。
- 托管框架支持运行命令和代码、应用技能/指令、通过工具或 MCP 连接到外部数据、在轮次中引导代理、总结先前工作以进行上下文管理、将子任务委派给子代理以及恢复会话。
- 会话状态在轮次之间保留，无需重建对话上下文；不再需要时可以删除会话和已发布的工件。
- 目前，Agents API 仅支持美国境内的数据驻留，并且不支持零数据保留（ZDR），即使使用自托管沙箱也是如此。
- 配置示例展示了如何创建会话，包括模型、指令、工具（程序化工具调用、MCP 服务器、网络搜索）、多代理委派以及具有能力目录的自托管环境。