按时间范围汇总当前应用的 Token 用量数据，包含总量、输入/输出/缓存/推理 Token 拆分、请求次数、失败次数和总耗时。时间区间为左闭右开（包含开始时间，不包含结束时间），单次查询跨度不超过90天。可通过 principalId 筛选指定身份主体的用量，通过 agentId 筛选指定智能体的用量，两者均可选且可组合使用。页面登录用户只能查询自身用量：不传 principalId 时自动按本人筛选，传入他人 principalId 返回 403。数据范围自动限定为当前应用，无法查询其他应用的数据。

按模型维度聚合当前应用的 Token 消耗，按总消耗降序分页返回，每项包含总量、输入、缓存命中、输出 Token、请求次数、缓存命中率和消耗占比。时间区间为左闭右开（包含开始时间，不包含结束时间），单次查询跨度不超过90天。可通过 principalId 筛选指定身份主体的消耗，通过 agentId 筛选指定智能体的消耗，两者均可选且可组合使用。页面登录用户只能查询自身用量：不传 principalId 时自动按本人筛选，传入他人 principalId 返回 403。消耗占比的分母为当前筛选范围内全部模型的总消耗，因此逐页累加后占比之和为100%。数据范围自动限定为当前应用，无法查询其他应用的数据。

按智能体维度聚合当前应用的 Token 消耗，按总消耗降序分页返回，每项包含智能体ID与名称、总量、输入、缓存命中、输出 Token、请求次数、缓存命中率和消耗占比。时间区间为左闭右开（包含开始时间，不包含结束时间），单次查询跨度不超过90天。可通过 principalId 筛选指定身份主体在各智能体上的消耗，用于查看「某个用户的用量花在了哪些智能体上」。页面登录用户只能查询自身用量：不传 principalId 时自动按本人筛选，传入他人 principalId 返回 403。只统计有智能体上下文的消耗（不经智能体产生的消耗不计入），消耗占比的分母为当前筛选范围内全部智能体的总消耗，因此逐页累加后占比之和为100%。智能体已删除时 agentName 为空但消耗仍计入。数据范围自动限定为当前应用，无法查询其他应用的数据。