LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
  • Overview
  • Client
  • AsyncClient
  • Run Helpers
  • Run Trees
  • Evaluation
  • Schemas
  • Utilities
  • Wrappers
  • Anonymizer
  • Testing
  • Expect API
  • Middleware
  • Pytest Plugin
  • Deployment SDK
⌘I

LangChain Assistant

Ask a question to get started

Enter to send•Shift+Enter new line

Menu

OverviewClientAsyncClientRun HelpersRun TreesEvaluationSchemasUtilitiesWrappersAnonymizerTestingExpect APIMiddlewarePytest PluginDeployment SDK
Language
Theme
PythonlangsmithclientClientaevaluate_run
Method●Since v0.2Deprecated

aevaluate_run

Copy
aevaluate_run(
  self,
  run: Union[V2Run, ls_schemas.Run, ls_schemas.RunBase, str, uuid.
View source on GitHub
UUID
]
,
evaluator
:
ls_evaluator
.
RunEvaluator
,
*
,
project_id
:
Optional
[
ID_TYPE
]
=
None
,
start_time
:
Optional
[
datetime
.
datetime
]
=
None
,
source_info
:
Optional
[
dict
[
str
,
Any
]
]
=
None
,
reference_example
:
Optional
[
Union
[
ls_schemas
.
Example
,
str
,
dict
,
uuid
.
UUID
]
]
=
None
,
load_child_runs
:
bool
=
False
)
->
ls_evaluator
.
EvaluationResult

Parameters

NameTypeDescription
run*Union[V2Run, Run, RunBase, str, UUID]

The run to evaluate. Passing schemas.Run (the legacy read-side datamodel) is deprecated; pass the v2 Run datamodel (from client.runs.retrieve) instead.

evaluator*RunEvaluator

The evaluator to use.

project_idOptional[Union[UUID, str]]
Default:None
start_timeOptional[datetime]
Default:None
source_infoOptional[Dict[str, Any]]
Default:None
reference_exampleOptional[Union[Example, str, dict, UUID]]
Default:None
load_child_runsbool, default=False
Default:False

Evaluate a run asynchronously.

.. admonition:: Deprecated

There is no replacement. Run the evaluator yourself and log the
result with :meth:`langsmith.Client.create_feedback`.
Will be removed after Jan 31, 2027.

The ID of the project (session) that owns the run. Omitting it is deprecated and will raise in a future release.

The run's start time, passed to runs.retrieve when resolving run from an ID. Required when resolving a run from an ID on SmithDB-only backends (no ClickHouse query support).

Additional information about the source of the evaluation to log as feedback metadata.

The example to use as a reference for the evaluation. If not provided, the run's reference example will be used.

Whether to load child runs when resolving the run ID. Deprecated: see read_run.