Struct RunTree 

pub struct RunTree {

    pub id: Uuid,
    pub name: String,
    pub run_type: RunType,
    pub inputs: Value,
    pub outputs: Option<Value>,
    pub error: Option<String>,
    pub parent_run_id: Option<Uuid>,
    pub trace_id: Option<Uuid>,
    pub start_time: DateTime<Utc>,
    pub end_time: Option<DateTime<Utc>>,
    pub metadata: HashMap<String, Value>,
    pub tags: Vec<String>,
    pub project_name: Option<String>,
    pub serialized: Value,
}

Run tree node for tracing

Each run is a node in a tree, with optional parent and children. The entire trace forms a tree structure, with the root being the top-level call.

Fields

id: Uuid

Unique run ID (UUID v7 with timestamp)

name: String

Run name

run_type: RunType

Run type

inputs: Value

Input data

outputs: Option<Value>

Output data (set when run ends)

error: Option<String>

Error message (if run failed)

parent_run_id: Option<Uuid>

Parent run ID

trace_id: Option<Uuid>

Trace ID (ID of the root run)

start_time: DateTime<Utc>

Start time

end_time: Option<DateTime<Utc>>

End time

metadata: HashMap<String, Value>

Metadata

tags: Vec<String>

Tags

project_name: Option<String>

Project name (LangSmith project)

serialized: Value

Serialized representation of the component

Implementations

impl RunTree

pub fn new(name: impl Into<String>, run_type: RunType, inputs: Value) -> Self

Create a new run

pub fn create_child( &self, name: impl Into<String>, run_type: RunType, inputs: Value, ) -> Self

Create a child run from this run

pub fn end(&mut self, outputs: Value)

End the run with outputs

pub fn end_with_error(&mut self, error: impl Into<String>)

End the run with an error

pub fn with_tag(self, tag: impl Into<String>) -> Self

Add a tag

pub fn with_metadata(self, key: impl Into<String>, value: Value) -> Self

Add metadata

pub fn with_project(self, project: impl Into<String>) -> Self

Set project name

pub fn duration_ms(&self) -> Option<i64>

Calculate run duration in milliseconds

Trait Implementations

impl Clone for RunTree

fn clone(&self) -> RunTree

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RunTree

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunTree

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&RunTree> for RunCreate

fn from(run: &RunTree) -> Self

Converts to this type from the input type.

impl From<&RunTree> for RunUpdate

fn from(run: &RunTree) -> Self

Converts to this type from the input type.

impl Serialize for RunTree

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.