コンテンツにスキップ

結果

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

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

最終出力

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

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

Note

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

次ターンの入力

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

最後のエージェント

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

新規アイテム

new_items プロパティには、実行中に生成された新しいアイテムが含まれます。アイテムは RunItem です。run item は、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 メソッドに提供した元の入力が含まれます。たいていの場合これは不要ですが、必要な場合に備えて利用できます。