langsmith.schemas.Run

class langsmith.schemas.Run

Run schema when loading from the DB.

Initialize a Run object.

Fields:

• app_path (str | None)

• child_run_ids (List[uuid.UUID] | None)

• child_runs (List[langsmith.schemas.Run] | None)

• completion_cost (decimal.Decimal | None)

• completion_tokens (int | None)

• dotted_order (str)

• feedback_stats (Dict[str, Any] | None)

• first_token_time (datetime.datetime | None)

• in_dataset (bool | None)

• manifest_id (uuid.UUID | None)

• parent_run_ids (List[uuid.UUID] | None)

• prompt_cost (decimal.Decimal | None)

• prompt_tokens (int | None)

• session_id (uuid.UUID | None)

• status (str | None)

• total_cost (decimal.Decimal | None)

• total_tokens (int | None)

• trace_id (uuid.UUID)

param app_path: str | None = None

Relative URL path of this run within the app.

param child_run_ids: List[UUID] | None = None

The child run IDs of this run.

param child_runs: List[Run] | None = None

The child runs of this run, if instructed to load using the client These are not populated by default, as it is a heavier query to make.

param completion_cost: Decimal | None = None

The estimated cost associated with the completion tokens.

param completion_tokens: int | None = None

Number of tokens generated as output.

param dotted_order: str = ''

Dotted order for the run.

This is a string composed of {time}{run-uuid}.* so that a trace can be sorted in the order it was executed.

Example

• Parent: 20230914T223155647Z1b64098b-4ab7-43f6-afee-992304f198d8

• Children:

• 20230914T223155647Z1b64098b-4ab7-43f6-afee-992304f198d8.20230914T223155649Z809ed3a2-0172-4f4d-8a02-a64e9b7a0f8a

• 20230915T223155647Z1b64098b-4ab7-43f6-afee-992304f198d8.20230914T223155650Zc8d9f4c5-6c5a-4b2d-9b1c-3d9d7a7c5c7c

param feedback_stats: Dict[str, Any] | None = None

Feedback stats for this run.

param first_token_time: datetime | None = None

Time the first token was processed.

param in_dataset: bool | None = None

Whether this run is in a dataset.

param manifest_id: UUID | None = None

Unique ID of the serialized object for this run.

param parent_run_ids: List[UUID] | None = None

List of parent run IDs.

param prompt_cost: Decimal | None = None

The estimated cost associated with the prompt (input) tokens.

param prompt_tokens: int | None = None

Number of tokens used for the prompt.

param session_id: UUID | None = None

The project ID this run belongs to.

param status: str | None = None

Status of the run (e.g., ‘success’).

param total_cost: Decimal | None = None

The total estimated LLM cost associated with the completion tokens.

param total_tokens: int | None = None

Total tokens for prompt and completion.

param trace_id: UUID [Required]

Unique ID assigned to every run within this nested trace.

property url: str | None

URL of this run within the app.