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
Pythonlangsmith_openapi_clientresourcesonline_evaluatorsAsyncOnlineEvaluatorsResourcespend
Method●Since v0.8

spend

Copy
spend(
  self,
  *,
  period_start: str,
  dataset_id: str | Omit
View source on GitHub
=
omit
,
evaluator_id
:
str
|
Omit
=
omit
,
feedback_key
:
str
|
Omit
=
omit
,
group_by
:
str
|
Omit
=
omit
,
resource_id
:
SequenceNotStr
[
str
]
|
Omit
=
omit
,
session_id
:
str
|
Omit
=
omit
,
type
:
str
|
Omit
=
omit
,
extra_headers
:
Headers
|
None
=
None
,
extra_query
:
Query
|
None
=
None
,
extra_body
:
Body
|
None
=
None
,
timeout
:
float
|
httpx
.
Timeout
|
None
|
NotGiven
=
not_given
)
->
GetOnlineEvaluatorSpendResponse

Parameters

NameTypeDescription
period_start*str

Start of the 7-day window (YYYY-MM-DD).

dataset_idstr | Omit
Default:omit

Filter to a specific dataset (UUID). Mutually exclusive with group_by.

evaluator_idstr | Omit
Default:omit
feedback_keystr | Omit
Default:omit
group_bystr | Omit
Default:omit
resource_idSequenceNotStr[str] | Omit
Default:omit
session_idstr | Omit
Default:omit
typestr | Omit
Default:omit
extra_headersHeaders | None
Default:None
extra_queryQuery | None
Default:None
extra_bodyBody | None
Default:None
timeoutfloat | httpx.Timeout | None | NotGiven
Default:not_given

Returns per-day LLM evaluator spend for the requested 7-day period, grouped by evaluator, resource, or run rule. Exactly one of group_by, evaluator_id, session_id, or dataset_id is required. resource_id, type, and feedback_key may be supplied with group_by to narrow listing aggregations.

Filter to a specific evaluator (UUID). Mutually exclusive with group_by.

Filter grouped results by evaluator feedback key. Only valid with group_by.

Aggregation mode: 'evaluator', 'resource', or 'run_rule'. Mutually exclusive with entity filters.

Filter grouped results to evaluators attached to all supplied project or dataset IDs. Only valid with group_by.

Filter to a specific project (UUID). Mutually exclusive with group_by.

Filter grouped results by evaluator type: 'llm' or 'code'. Only valid with group_by.

Send extra headers

Add additional query parameters to the request

Add additional JSON properties to the request

Override the client-level default timeout for this request, in seconds