Skip to main content
会話を表します。conversation_id ごとにターンをグループ化します (スパンは作成しません) 。 continue_parent_trace は、この会話が作成するターンのトレース分離を制御します。 デフォルトの False では、各ターンがそれぞれ独自の OTel トレースを開始します (スタンドアロンの Conversations タブのビューにはこの設定が適しています) 。エージェントの invocation を含めるべき外側のトレース (たとえば fastapi でインストルメントされた リクエスト) がアプリケーションにある場合は、True に設定します。 Conversation は Pydantic モデルです。インスタンスを構築する際に、以下の任意のフィールドをキーワード引数として指定できます。 Conversation はコンテキストマネージャーであり、with ステートメントで使用できます。

フィールド

メソッド

start_turn

ターンを作成して開始します。前のターンがまだ開いている場合は、自動的に終了します。 _current_turn contextvar を設定するため、コンテキストマネージャーを使用するかどうかにかかわらず、 get_current_turn() でターンを参照できます。 agent_name / model / agent_id / agent_description / agent_version は、空のままにするとそれぞれ会話のデフォルト値が使用されます。 continue_parent_trace は継承されます。これらはいずれも、後から turn.record(...) で上書きできます。 system_instructions (エージェントのシステムプロンプト) は、ターンの invoke_agent スパンに保持されます。start_llm と同様に、返された Turn の 属性に値を代入して後から設定することもできます。

end

最終更新日 2026年9月30日