Responses API 与会话状态

为什么使用 Responses API

Responses API 把文本、多模态输入、工具调用和推理放到统一接口中。相比旧式单轮封装，它更适合需要工具和连续状态的新应用。

迁移时不要只替换端点。要重新检查输入格式、输出遍历、工具 schema、流式事件和错误处理。

• 简单文本可通过 input 直接提交。
• 复杂消息可使用角色与内容项。
• 输出可能包含文本、工具调用和其他项目。
• 应用应保存必要标识，而不是依赖进程内内存。

状态管理的两种思路

短对话可以通过 previous_response_id 延续上一响应。需要跨会话持久化、多人参与或更完整管理时，可以使用 Conversations 相关能力。

无论哪种方式，都要定义保留期限、用户隔离和删除机制。不要无限积累上下文，过长历史会增加成本并降低信号质量。