AgentUsage() creates a normalized usage record. AgentResult$usage and
run usage/stop events are scoped to that run, while Agent$usage()
describes the complete in-memory conversation at the time it is called.
Usage
AgentUsage(
requests = 0L,
tool_calls = 0L,
input_tokens = 0,
output_tokens = 0,
cached_tokens = 0,
cost_usd = 0
)Arguments
- requests
Number of model requests attributed to the run.
- tool_calls
Number of requested tool calls, including calls rejected before execution.
- input_tokens
Provider-reported input tokens.
- output_tokens
Provider-reported output tokens.
- cached_tokens
Provider-reported cached input tokens. These are reported separately and are not added again to
total_tokens.- cost_usd
Provider-reported estimated cost in US dollars.