如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

运行结果与状态

了解最终输出、历史记录和中断,以及下一轮需要沿用哪些信息。

运行智能体时,您可以从运行结果中获取最终答案,也可以查看交接后由哪个智能体接手,并获取继续下一轮对话所需的信息。如果运行暂停以等待审核,结果中还包含可用于恢复运行的状态快照。

选择所需的结果属性

大多数应用只需使用少数几个结果属性:

您需要的信息或功能 使用的属性或方法
向用户展示的最终答案 finalOutput 在 TypeScript 中,或 final_output 在 Python 中
可在本地重放的历史记录 history 在 TypeScript 中,或 to_input_list() 在 Python 中
通常应负责下一轮对话的专用智能体 lastAgent 在 TypeScript 中,或 last_agent 在 Python 中
由 OpenAI 管理的响应串联 lastResponseId 在 TypeScript 中,或 last_response_id 在 Python 中
待审批事项和可用于恢复运行的快照 interruptions 和 state 在 TypeScript 中,或 to_state() 在 Python 中

建议先熟悉表中的属性和方法。有关更详细的运行条目、原始模型响应和诊断信息,请参阅 SDK 文档和参考资料。

下一轮需要沿用哪些信息

如何使用运行结果取决于您的应用如何继续对话:

  • 如果应用在本地维护完整的历史记录,请复用 history 在 TypeScript 中,或 to_input_list() 在 Python 中。
  • 如果您使用会话,请继续传入同一个会话,由 SDK 加载并保存历史记录。
  • 如果由服务器管理对话的延续,请只传入新的用户输入,并复用已保存的 ID,无需重放完整的对话记录。
  • 如果交接后应由接手的专用智能体继续负责下一轮对话,请复用 lastAgent 在 TypeScript 中,或 last_agent 在 Python 中。

运行中断时会返回状态,此时尚无最终答案

在审批流程中,SDK 会在运行完成前返回结果。这是按设计返回不完整结果的主要场景。

  • finalOutput 在 TypeScript 中,或 final_output 在 Python 中 可能仍为空,因为运行尚未结束。
  • interruptions 列出等待您决定是否批准的工具调用。
  • state 在 TypeScript 中,或 to_state() 在 Python 中 是已保存的状态快照。批准或拒绝这些调用后,请将快照传回运行时。

如果审核可能要等到当前请求结束后才进行,请序列化同一份状态快照。

更详细的运行条目和诊断信息

如果上述高层接口提供的信息不足以满足应用需求,您还可以通过 SDK 获取更详细的运行条目和诊断信息,包括条目级的工具调用和交接记录、原始模型响应、安全护栏检查结果以及用量明细。

这些信息适用于审计、构建自定义界面和深入调试。大多数开发者可以在熟悉基本用法后再阅读本站的相关内容。

后续步骤

确定需要哪些结果属性后,您可以继续阅读以下指南,了解这些结果是如何产生的,以及如何查看它们。