[ PROMPT_NODE_22792 ]
openai-docs
[ SKILL_DOCUMENTATION ]
# OpenAI 文档
使用 `developers.openai.com` MCP 服务器提供来自 OpenAI 开发者文档的权威、最新指导。对于 OpenAI 相关问题,始终优先使用开发者文档 MCP 工具,而不是 `web.run`。仅当 MCP 服务器已安装且未返回有意义的结果时,才回退到网页搜索。
## 快速开始
- 使用 `mcp__openaiDeveloperDocs__search_openai_docs` 查找最相关的文档页面。
- 使用 `mcp__openaiDeveloperDocs__fetch_openai_doc` 拉取确切章节并准确引用/改写。
- 仅在需要浏览或发现页面而没有明确查询时,使用 `mcp__openaiDeveloperDocs__list_openai_docs`。
## OpenAI 产品快照
1. Apps SDK: 通过提供 Web 组件 UI 和一个将应用工具暴露给 ChatGPT 的 MCP 服务器来构建 ChatGPT 应用。
2. Responses API: 一个统一的端点,专为智能体工作流中具有状态、多模态、工具使用能力的交互而设计。
3. Chat Completions API: 从构成对话的消息列表中生成模型回复。
4. Codex: OpenAI 的软件开发编码智能体,可以编写、理解、审查和调试代码。
5. gpt-oss: 在 Apache 2.0 许可下发布的 OpenAI 开源权重推理模型 (gpt-oss-120b 和 gpt-oss-20b)。
6. Realtime API: 构建低延迟、多模态体验,包括自然的语音到语音对话。
7. Agents SDK: 用于构建智能体应用的工具包,模型可以使用工具和上下文、移交给其他智能体、流式传输部分结果并保持完整追踪。
## 如果缺少 MCP 服务器
如果 MCP 工具失败或没有可用的 OpenAI 文档资源:
1. 自行运行安装命令: `codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp`
2. 如果因权限/沙箱原因失败,立即使用提升的权限重试同一命令,并附上一句批准理由。不要先要求用户运行。
3. 仅在提升权限的尝试失败后,才要求用户运行安装命令。
4. 要求用户重启 Codex。
5. 重启后重新运行文档搜索/获取。
## 工作流
1. 明确产品范围 (Codex、OpenAI API 或 ChatGPT Apps SDK) 和任务。
2. 使用精确的查询搜索文档。
3. 获取最佳页面和所需的特定章节 (尽可能使用 `anchor`)。
4. 提供简洁的指导并引用文档来源。
5. 仅在文档支持的情况下提供代码片段。
## 质量规则
- 将 OpenAI 文档视为真理来源;避免...