LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
LangSmith
  • Client
  • Run Trees
  • Traceable
  • Evaluation
  • Schemas
  • Langchain
  • Jest
  • Vitest
  • Wrappers
  • Anonymizer
  • Jestlike
  • Vercel
  • Anthropic
  • Sandbox
⌘I

LangChain Assistant

Ask a question to get started

Enter to send•Shift+Enter new line

Menu

LangSmith
ClientRun TreesTraceableEvaluationSchemasLangchainJestVitestWrappersAnonymizerJestlikeVercelAnthropicSandbox
Language
Theme
JavaScriptlangsmithindexRun
Interface●Since v0.0

Run

Describes properties of a run when loaded from the database. Extends the BaseRun interface.

Copy
interface Run

Bases

BaseRun

Used in Docs

  • How to create and manage datasets programmatically
  • How to define a code evaluator
  • How to evaluate an application's intermediate steps
  • How to evaluate an LLM application
  • How to fetch performance metrics for an experiment

Properties

Inherited fromBaseRun

Properties

Pattachments: Attachments
—

Attachments for the example

Pdotted_order: string
—

The dotted order for the run.

Pend_time: number
—

The epoch time at which the run ended, if applicable.

P
View source on GitHub
error
: string
—

Error message, captured if the run faces any issues.

Pevents: KVMap[]
—

Events like 'start', 'end' linked to the run.

Pextra: KVMap
—

Any additional metadata or settings for the run.

Pid: string
—

Unique identifier (UUID). Remains constant even if name changes.

Pinputs: KVMap
—

Inputs that were used to initiate the run.

Pname: string
—

Display name (can be updated).

Poutputs: KVMap
—

Outputs produced by the run, if any.

Pparent_run_id: string
—

ID of a parent run, if this run is part of a larger operation.

Preference_example_id: string
—

ID of an example that might be related to this run.

Prun_type: string
—

Specifies the type of run (tool, chain, llm, etc.).

Pserialized: object
—

Serialized state of the run for potential future use.

Pstart_time: number
—

The epoch time at which the run started, if available.

Ptags: string[]
—

Tags for further categorizing or annotating the run.

Ptrace_id: string
—

Unique ID assigned to every run within this nested trace. *

property
app_path: string
property
attachments: Attachments
property
child_run_ids: string[]
property
child_runs: Run[]
property
completion_tokens: number
property
dotted_order: string
property
end_time: string | number
property
error: string
property
events: KVMap[]
property
extra: KVMap
property
feedback_stats: KVMap
property
first_token_time: number
property
id: string
property
in_dataset: boolean
property
inputs: KVMap
property
inputs_s3_urls: S3URL
property
manifest_id: string
property
name: string
property
outputs: KVMap
property
outputs_s3_urls: S3URL
property
parent_run_id: string
property
parent_run_ids: string[]
property
prompt_tokens: number
property
reference_example_id: string
property
run_type: string
property
serialized: object
property
session_id: string
property
start_time: string | number
property
status: string
property
tags: string[]
property
total_tokens: number
property
trace_id: string

The URL path where this run is accessible within the app.

Attachments for the example

IDs of any child runs spawned by this run.

Number of tokens generated in the completion.

The 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

The epoch time at which the run ended, if applicable.

Error message, captured if the run faces any issues.

Events like 'start', 'end' linked to the run.

Any additional metadata or settings for the run.

Time when the first token was processed.

Unique identifier (UUID). Remains constant even if name changes.

Whether the run is included in a dataset.

Inputs that were used to initiate the run.

The input S3 URLs

The manifest ID that correlates with this run.

Display name (can be updated).

Outputs produced by the run, if any.

The output S3 URLs

ID of a parent run, if this run is part of a larger operation.

IDs of parent runs, if multiple exist.

Number of tokens used in the prompt.

ID of an example that might be related to this run.

Specifies the type of run (tool, chain, llm, etc.).

Serialized state of the run for potential future use.

The ID of the project that owns this run.

The epoch time at which the run started, if available.

Provisioning status ("provisioning", "ready", "failed").

Tags for further categorizing or annotating the run.

Unique ID assigned to every run within this nested trace. *