结果
当你调用 Runner.run 方法时,你会得到:
- 如果调用
run或run_sync,则返回RunResult - 如果调用
run_streamed,则返回RunResultStreaming
二者都继承自 RunResultBase,其中包含大多数有用信息。
最终输出
final_output 属性包含最后一个运行的智能体的最终输出。它可能是:
str,如果最后一个智能体没有定义output_type- 类型为
last_agent.output_type的对象,如果该智能体定义了输出类型
Note
final_output 的类型为 Any。由于存在 任务转移,我们无法进行静态类型标注。如果发生 任务转移,意味着任意智能体都可能成为最后一个,因此我们无法静态地知道可能的输出类型集合。
下一轮输入
你可以使用 result.to_input_list() 将结果转换为一个输入列表,该列表把你提供的原始输入与智能体运行期间生成的条目进行拼接。这样可以方便地将一次智能体运行的输出传递给另一次运行,或在循环中运行并每次附加新的用户输入。
最后一个智能体
last_agent 属性包含最后一个运行的智能体。根据你的应用,这通常对下一次用户输入很有用。例如,如果你有一个前线分诊智能体会将任务转移给特定语言的智能体,你可以存储下最后一个智能体,并在下次用户向智能体发送消息时复用它。
新增条目
new_items 属性包含本次运行期间生成的新条目。条目是 RunItem。运行条目封装了由 LLM 生成的原始条目。
MessageOutputItem表示来自 LLM 的消息。原始条目是生成的消息。HandoffCallItem表示 LLM 调用了 任务转移 工具。原始条目是来自 LLM 的工具调用条目。HandoffOutputItem表示发生了 任务转移。原始条目是对 任务转移 工具调用的工具响应。你也可以从该条目访问源/目标智能体。ToolCallItem表示 LLM 调用了某个工具。ToolCallOutputItem表示某个工具被调用。原始条目是工具响应。你也可以从该条目访问工具输出。ReasoningItem表示来自 LLM 的推理条目。原始条目是生成的推理内容。
其他信息
安全防护措施结果
input_guardrail_results 和 output_guardrail_results 属性包含安全防护措施的结果(如果有)。安全防护措施结果有时包含你可能希望记录或存储的有用信息,因此我们将其提供给你。
原始响应
raw_responses 属性包含由 LLM 生成的 ModelResponse。
原始输入
input 属性包含你传递给 run 方法的原始输入。大多数情况下你不需要它,但以备不时之需我们仍然提供。