用途：为基于 Convex 的 LLM 智能体记录每次调用的令牌用量与成本，支持计费、成本监控和效率优化。适合按用户、智能体或团队统计用量，生成发票与成本报告，并对高用量发出告警。
主要能力：在 Agent 配置中设置 usageHandler 回调，获取 userId、threadId、agentName、model、provider、usage（inputTokens、outputTokens、totalTokens）及 providerMetadata；将用量写入数据库。可查询单个用户的总用量、按月按用户汇总、按智能体比较各智能体的令牌与成本。可依据用量数据生成月度发票并设置定时任务自动生成。还可按日检查成本超阈值告警，并构建用户仪表盘展示当月与历史用量。
使用方式：在 convex/agents/myAgent.ts 中为 Agent 添加 usageHandler；在 convex/usage.ts 定义 usage 与 invoices 表及索引，并实现 recordUsage、getUserUsage、getMonthlyUsageByUser、getUsageByAgent、generateInvoices、checkUsageAlerts、getDashboardStats 等 mutation/query/action；可在 convex/crons.ts 配置每月定时生成发票。成本计算示例为每百万输入令牌 0.015 美元、每百万输出令牌 0.060 美元，可自行按提供方定价调整。
适用场景：按令牌消耗向用户计费、监控 API 成本、优化智能体效率、按用户/智能体/团队跟踪用量、生成发票与成本报表、高用量告警、分析成本趋势。
限制：资料未提供官方定价、平台支持范围、性能基准或兼容性说明；示例中的价格与阈值仅为演示，实际需按提供方计费核对；成本计算与发票生成依赖使用者自行维护定价与业务规则。