RunCollectorCallbackHandler Class — langchain Architecture

Architecture documentation for the RunCollectorCallbackHandler class in run_collector.py from the langchain codebase.

Class python

Entity Profile

Dependency Diagram

graph TD
  c7686d6d_3f34_d781_f3ed_dce4f50f9a31["RunCollectorCallbackHandler"]
  0f6b3261_31fa_c34e_ca33_cb141bdf78ff["BaseTracer"]
  c7686d6d_3f34_d781_f3ed_dce4f50f9a31 -->|extends| 0f6b3261_31fa_c34e_ca33_cb141bdf78ff
  1167bc74_f368_1293_a04d_8e64292353c7["run_collector.py"]
  c7686d6d_3f34_d781_f3ed_dce4f50f9a31 -->|defined in| 1167bc74_f368_1293_a04d_8e64292353c7
  38193dcd_dc5c_0ead_71ad_2cf0fb8e0fa7["__init__()"]
  c7686d6d_3f34_d781_f3ed_dce4f50f9a31 -->|method| 38193dcd_dc5c_0ead_71ad_2cf0fb8e0fa7
  f7f8a36d_666a_1a56_577c_cbfde525f5c7["_persist_run()"]
  c7686d6d_3f34_d781_f3ed_dce4f50f9a31 -->|method| f7f8a36d_666a_1a56_577c_cbfde525f5c7

Relationship Graph

Source Code

libs/core/langchain_core/tracers/run_collector.py lines 11–40

class RunCollectorCallbackHandler(BaseTracer):
    """Tracer that collects all nested runs in a list.

    This tracer is useful for inspection and evaluation purposes.
    """

    name: str = "run-collector_callback_handler"

    def __init__(self, example_id: UUID | str | None = None, **kwargs: Any) -> None:
        """Initialize the `RunCollectorCallbackHandler`.

        Args:
            example_id: The ID of the example being traced.
            **kwargs: Additional keyword arguments.
        """
        super().__init__(**kwargs)
        self.example_id = (
            UUID(example_id) if isinstance(example_id, str) else example_id
        )
        self.traced_runs: list[Run] = []

    def _persist_run(self, run: Run) -> None:
        """Persist a run by adding it to the `traced_runs` list.

        Args:
            run: The run to be persisted.
        """
        run_ = run_copy(run)
        run_.reference_example_id = self.example_id
        self.traced_runs.append(run_)