バッチでのログ記録

これらには tracing モジュールからアクセスします：

from coreweave.forge.agentlens import tracing

log_turn

def log_turn(
    *,
    conversation_id: str,
    agent_name: str = '',
    conversation_name: str = '',
    model: str = '',
    agent_id: str = '',
    agent_description: str = '',
    agent_version: str = '',
    messages: Union[list[Message], None] = None,
    output_messages: Union[list[Message], None] = None,
    system_instructions: Union[list[str], None] = None,
    spans: Union[list[Union[LLM, Tool, SubAgent]], None] = None,
    started_at: Union[datetime, None] = None,
    ended_at: Union[datetime, None] = None,
    include_content: bool = True,
    continue_parent_trace: bool = False,
    attributes: Attributes = None,
) -> LogResult: ...

1 つのターンとその子スパンを、命令的に OTel へ送信します。コンテキストマネージャーを使用できない場合 (ステートレスなコンテナー、コールバック、キューワーカーなど) に使用します。渡す各子スパンには started_at / ended_at を設定しておく必要があります。送信される OTel スパンのタイムスタンプは、これらのフィールドの値が使用されます。ターン自体がタイムスタンプを指定しない場合は、子スパンの最も早い/最も遅いタイムスタンプが使用され、それもない場合は now() が使用されます。 agent_id / agent_description / agent_version はストリーミングパスと同じように扱われます。 attributes は送信されるすべてのスパンに付与されます。ストリーミングパスでは、これらは実行中の会話から読み取られます。セマンティック規約に含まれない独自のキーを使用してください。スパン自身の gen_ai.* / weave.* 属性と重複するキーはサポートされていません (どちらの値が優先されるかはパスによって異なります)。 messages にはターンの入力が、output_messages にはエージェントの最終的な応答が記録されます。どちらも同じ invoke_agent スパンに記録されます。

log_conversation

def log_conversation(
    *,
    turns: list[Turn],
    conversation_id: str = '',
    conversation_name: str = '',
    agent_name: str = '',
    model: str = '',
    agent_id: str = '',
    agent_description: str = '',
    agent_version: str = '',
    include_content: bool = True,
    continue_parent_trace: bool = False,
    attributes: Attributes = None,
) -> LogResult: ...

完全な会話を命令的に出力します。各 Turn の子は、その Turn の .spans 属性で指定します。conversation_id が空の場合は自動生成されます。デフォルトでは、ターンごとに個別の OTel トレースが割り当てられます。 agent_name / model / agent_id / agent_description / agent_version は会話レベルのデフォルト値です。Turn 自身の値が優先され、会話の値は Turn 側で値が空の場合にのみ補完されます。一方、会話の continue_parent_trace はすべてのターンに適用され、 Turn ごとの値よりも優先されます。 attributes は出力されるすべてのスパンに付与されます。セマンティック規約に含まれない独自のキーを使用してください。スパン自身の gen_ai.* / weave.* 属性と衝突するキーはサポートされていません (どちらの値が優先されるかは処理経路によって異なります) 。

LogResult

class LogResult(BaseModel): ...

log_* のバッチ呼び出しの結果です。 LogResult は Pydantic モデルです。インスタンスを構築する際に、以下の各フィールドをキーワード引数として指定できます。 フィールド

フィールド	タイプ	デフォルト
`conversation_id`	`str`	`''`
`trace_ids`	`list[str]`	`[]`
`root_span_ids`	`list[str]`	`[]`
`span_count`	`int`	`0`

​log_turn

​log_conversation

​LogResult

log_turn

log_conversation

LogResult