结果
当你调用 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
] 列表。[agents.items.ModelResponse]
原始输入
input
属性包含你提供给 run
方法的原始输入。大多数情况下你可能不需要它,但在需要时可以使用。