OpenAI Agents SDK 结果与状态
2026-11-06 16:09 更新
运行结果不只是最终答案,它也标识交接边界、提供下一轮的继续入口,并在暂停审查时提供可恢复快照。
选择需要的结果接口
多数应用只需要少量结果属性:
| 需求 | 使用方式 |
|---|---|
| 显示最终答案 | TypeScript的finalOutput或Python的final_output |
| 可在本地重放的历史 | TypeScript的history或Python的to_input_list() |
| 通常应负责下一轮的专项智能体 | TypeScript的lastAgent或Python的last_agent |
| OpenAI管理的响应链 | TypeScript的lastResponseId或Python的last_response_id |
| 待批准项目及可恢复快照 | interruptions,配合TypeScript的state或Python的to_state() |
先掌握这些指南级接口。更丰富的运行项目、原始模型响应和详细诊断,仍以SDK文档及参考资料为准。
下一轮带入哪些内容
按继续策略使用结果:
- 应用管理完整本地历史时,复用TypeScript的
history或Python的to_input_list()。 - 使用会话时,持续传入同一会话,让SDK加载并持久保存历史。
- 使用服务端继续机制时,只传新用户输入并复用保存的ID,不重放全部对话。
- 交接后,若专项智能体应继续控制下一轮,复用TypeScript的
lastAgent或Python的last_agent。
中断运行返回状态,而非最终答案
批准流程是结果有意保持未完成的主要情形。由于运行尚未结束,TypeScript的finalOutput或Python的final_output可能为空。
interruptions指出哪些待处理工具调用需要决策。TypeScript的state或Python的to_state()提供已保存快照,批准或拒绝之后将其传回运行时。
审查需要延后处理时,序列化的也是这份状态。
更丰富的项目与诊断接口
SDK还暴露更丰富的运行项目和诊断,包括项目级工具与交接记录、原始模型响应、护栏结果及用量详情。
这些信息适合审计、自定义界面和深入调试,但多数开发者不必最先学习它们。
后续步骤
以上内容是否对您有帮助:

TRAE-AI编程


更多建议: