コンテンツにスキップ

結果

Runner.run メソッドを呼び出すと、次のいずれかが返ります。

どちらも RunResultBase を継承しており、ここに最も有用な情報が含まれます。

最終出力

final_output プロパティには、最後に実行されたエージェントの最終出力が含まれます。これは次のいずれかです。

  • 最後のエージェントに output_type が定義されていない場合は str
  • エージェントに出力タイプが定義されている場合は last_agent.output_type 型のオブジェクト

Note

final_output の型は Any です。handoffs のため、これを静的に型付けすることはできません。handoffs が発生すると、どのエージェントが最後になるか分からないため、可能な出力タイプの集合を静的に把握できないためです。

次ターンの入力

result.to_input_list() を使用すると、あなたが提供した元の入力に、エージェントの実行中に生成されたアイテムを連結した入力リストに変換できます。これにより、あるエージェント実行の出力を別の実行に渡したり、ループで実行して毎回新しいユーザー入力を追加したりするのが容易になります。

最後のエージェント

last_agent プロパティには、最後に実行されたエージェントが含まれます。アプリケーションによっては、次回ユーザーが入力する際に有用です。例えば、フロントラインのトリアージ用エージェントが言語別のエージェントへ handoff する場合、最後のエージェントを保存しておき、次回ユーザーがエージェントにメッセージを送る際に再利用できます。

新規アイテム

new_items プロパティには、実行中に生成された新しいアイテムが含まれます。アイテムは RunItem です。実行アイテムは、LLM が生成した raw アイテムをラップします。

  • MessageOutputItem は LLM からのメッセージを示します。raw アイテムは生成されたメッセージです。
  • HandoffCallItem は、LLM が handoff ツールを呼び出したことを示します。raw アイテムは LLM からのツール呼び出しアイテムです。
  • HandoffOutputItem は、handoff が発生したことを示します。raw アイテムは handoff ツール呼び出しに対するツールのレスポンスです。アイテムから送信元/送信先のエージェントにもアクセスできます。
  • ToolCallItem は、LLM がツールを呼び出したことを示します。
  • ToolCallOutputItem は、ツールが呼び出されたことを示します。raw アイテムはツールのレスポンスです。アイテムからツール出力にもアクセスできます。
  • ReasoningItem は LLM からの推論アイテムを示します。raw アイテムは生成された推論です。

その他の情報

ガードレール結果

input_guardrail_resultsoutput_guardrail_results プロパティには、存在する場合はガードレールの結果が含まれます。ガードレール結果には、ログ記録や保存に有用な情報が含まれる場合があるため、利用できるようにしています。

raw レスポンス

raw_responses プロパティには、LLM によって生成された ModelResponse が含まれます。

元の入力

input プロパティには、run メソッドに渡した元の入力が含まれます。ほとんどの場合これは不要ですが、必要な場合のために参照できるようになっています。