Usage

Usage dataclass

Source code in agents/usage.py

@dataclass
class Usage:
    requests: int = 0
    """向 LLM API 发起的总请求数。"""

    input_tokens: int = 0
    """所有请求中发送的输入 tokens 总数。"""

    input_tokens_details: InputTokensDetails = field(
        default_factory=lambda: InputTokensDetails(cached_tokens=0)
    )
    """关于输入 tokens 的详细信息，匹配 responses API 的用量详情。"""
    output_tokens: int = 0
    """所有请求中接收的输出 tokens 总数。"""

    output_tokens_details: OutputTokensDetails = field(
        default_factory=lambda: OutputTokensDetails(reasoning_tokens=0)
    )
    """关于输出 tokens 的详细信息，匹配 responses API 的用量详情。"""

    total_tokens: int = 0
    """所有请求中发送和接收的 tokens 总数。"""

    def add(self, other: "Usage") -> None:
        self.requests += other.requests if other.requests else 0
        self.input_tokens += other.input_tokens if other.input_tokens else 0
        self.output_tokens += other.output_tokens if other.output_tokens else 0
        self.total_tokens += other.total_tokens if other.total_tokens else 0
        self.input_tokens_details = InputTokensDetails(
            cached_tokens=self.input_tokens_details.cached_tokens
            + other.input_tokens_details.cached_tokens
        )

        self.output_tokens_details = OutputTokensDetails(
            reasoning_tokens=self.output_tokens_details.reasoning_tokens
            + other.output_tokens_details.reasoning_tokens
        )

requests class-attribute instance-attribute

requests: int = 0

向 LLM API 发起的总请求数。

input_tokens class-attribute instance-attribute

input_tokens: int = 0

所有请求中发送的输入 tokens 总数。

input_tokens_details class-attribute instance-attribute

input_tokens_details: InputTokensDetails = field(default_factory=lambda: InputTokensDetails(cached_tokens=0))

关于输入 tokens 的详细信息，匹配 responses API 的用量详情。

output_tokens class-attribute instance-attribute

output_tokens: int = 0

所有请求中接收的输出 tokens 总数。

output_tokens_details class-attribute instance-attribute

output_tokens_details: OutputTokensDetails = field(default_factory=lambda: OutputTokensDetails(reasoning_tokens=0))

关于输出 tokens 的详细信息，匹配 responses API 的用量详情。

total_tokens class-attribute instance-attribute

total_tokens: int = 0

所有请求中发送和接收的 tokens 总数。