Open Agents用量统计：如何查看Token消耗与成本-平芜编程栈

Open Agents用量统计：如何查看Token消耗与成本

【免费下载链接】open-agentsAn open source template for building cloud agents.项目地址: https://gitcode.com/GitHub_Trending/op/open-agents

Open Agents 是一款开源的云端 AI Agent 构建模板，内置了完整的用量统计功能。本文带你快速上手：在设置页查看 Token 消耗明细、估算 API 成本、对比不同模型的用量占比，还能看懂缓存命中率等效率指标，帮新手轻松掌握 Agent 的"开销账本"。💰

为什么需要用量统计

使用云端 Agent 时，每次对话都会消耗 Token。如果不加监控，成本很容易悄悄膨胀。Open Agents 把用量数据自动记录到数据库，并在设置页以图表形式呈现，让你一眼看清：

总 Token 数：输入 + 输出的合计消耗
估算成本：基于 models.dev 的模型价格自动折算美元金额
消息数与工具调用数：衡量 Agent 实际工作量
模型分布：哪个模型"吃"掉了最多 Token

💡 成本估算只覆盖有公开定价的模型，页面会标注"基于 XX% 已知定价的 Token 估算"，避免误导。

打开用量统计页面：三步到位

1️⃣ 登录你的 Open Agents 实例，进入设置中心。

2️⃣ 访问个人主页：用量面板位于/settings/profile路由下。独立的/settings/usage路径会自动跳转到这里（见 page.tsx）。

3️⃣ 找到 "Usage" 卡片，所有统计指标就在其中。

整个面板的核心代码在 usage-section.tsx，数据来自/api/usage接口（见 route.ts），它一次性返回三块内容：按天汇总的用量历史、效率洞察、以及域名排行榜数据。

读懂四大核心指标

打开 Usage 卡片，顶部是四个统计块（StatBlock）：

指标	含义	使用场景
Total tokens	选中时间范围内的总 Token 消耗	掌握整体开销
Estimated cost	按模型单价折算的美元成本	预算控制
Messages	消息总条数	评估使用频率
Tool calls	工具调用总次数	判断 Agent 工作量

下方还有一张贡献图（Contribution Chart），类似代码贡献热力图，展示过去 39 周每天的 Token 消耗和活动量。📊

快速筛选日期：点击图表即可过滤

贡献图支持交互筛选：

点击某一天：只看这一天的用量
点击日期范围：查看区间内的汇总
点 "Clear filter" 按钮：恢复完整时间视图

筛选时，前端会带上from和to两个日期参数（格式YYYY-MM-DD）重新请求/api/usage，参数解析逻辑在 query-range.ts 中，非法日期会直接返回 400 错误。

主 Agent 与子 Agent 消耗对比

面板中的Agent split饼图把 Token 分成两份：

Main agent：直接和你对话的主 Agent
Subagents：主 Agent 派生的子任务 Agent（如探索代码库的 Explorer）

这个拆分很有价值——如果你发现子 Agent 占比过高，说明任务被大量拆解，可以适当精简提示词来省 Token。

查看各模型用量分布

Usage by model饼图展示每个模型消耗的 Token 占比（最多显示前 5 个模型，其余合并为 "Other"）。📈

这样你能快速判断：

最贵的模型是不是被用在了琐碎任务上
是否可以用更便宜的模型处理简单请求

模型列表来自/api/models接口，成本计算在estimateModelUsageCost中完成。

进阶：Insights 效率洞察

在基础用量之外，Open Agents 还提供一组近 30 天的Insights指标（实现见 usage-insights-section.tsx，计算逻辑在 compute-insights.ts）：

Tracked PRs / Merge rate：Agent 参与的 PR 数量与合并率，衡量"干活"成效
Avg tokens / turn：平均每轮对话消耗的 Token，是衡量对话效率的核心
Largest turn：单轮最大 Token 消耗，帮你发现异常会话
Tool calls / turn：平均每轮工具调用次数
Cache hit ratio：缓存输入 Token 占总输入的比例，缓存命中越高，实际计费越低 ⚡

这些字段的完整定义可以在 types.ts 中查阅。

域名排行榜：看看同域名下的消耗排名

Open Agents 还支持按邮箱域名生成用量排行榜（Leaderboard）。访问/settings/leaderboard可查看同域用户按 Token 总量排名的情况；接口 rank/route.ts 返回你在当日的排名和域名总人数。个人排行数据查询逻辑位于 usage-domain-leaderboard.ts。