SuperAPI AI 工具集

openai-responses

智能体与模型

查看项目

更新于 10-15 23:58

技能介绍

用途:OpenAI Responses API(/v1/responses)是 2025 年 3 月发布的统一接口,面向智能体应用,相比 Chat Completions 可跨轮保留推理状态,官方称在多轮任务上提升约 5%,缓存利用率提升 40-80%。

主要能力:自动状态管理(conversation_id 跨轮记忆);服务端内置工具,包括 Code Interpreter(Python 执行)、File Search(RAG)、Web Search、Image Generation,需显式启用;MCP 服务器集成;background: true 异步后台模式,用于超过 60 秒的长任务并轮询 retrieve;输出为多态类型(message、reasoning、function_call、image),可用 output_text 便捷属性。

使用方式:Node.js 用 openai@5.19.1+,调用 openai.responses.create({ model, input }),首轮保存 conversation_id,后续轮次传入同一 ID;也可用 fetch 直接请求 https://api.openai.com/v1/responses。从 Chat Completions 迁移时,messages 改为 input,system 角色改为 developer,choices[0].message.content 改为 output_text,端点改为 /v1/responses。

限制与注意:API 密钥须用环境变量,不可硬编码;不要忽略 conversation_id,否则状态丢失;不要假设单一输出类型;同一会话中不要混用 Chat Completions 与 Responses;Code Interpreter 标准模式约 30 秒超时,长任务需后台模式;MCP 连接失败常见原因是 URL 无效或令牌缺失/过期。生产部署需处理 401、429、400、500 错误、指数退避限流、持久化会话 ID 并启用流式输出。

适用场景:有状态多轮对话、联网搜索智能体、代码解释、文件检索问答、MCP 外部工具调用。官方文档见 https://platform.openai.com/docs/api-reference/responses。