用量看板 ★
一句话：token 用了多少、钱花在哪、配额够不够——一页看清：顶部配额告警条，中部四个维度的汇总，底部逐条调用明细。
功能在哪
- 菜单路径：AI → AI 助手 → 用量看板
- 地址栏路由：
/ai/agent/usage - 主要权限：
agent:usage:query（底部「最近的调用明细」块另需agent:usage:detail）
界面认识
| 区域 | 作用 | 常用操作 |
|---|---|---|
| 配额告警条 | 「我的月配额」「本租户月配额」两行：已用 x / y token（占比%）+ 已用金额 / 上限 | 只读 |
| 下钻维度 | 按场景 / 按用户 / 按模型 / 按日期 四个单选 + 时间范围（开始 / 结束） | 切换维度；「重置」清空时间范围 |
| 统计卡 | 调用次数 / 输入 token / 输出 token / 合计 token | 只读 |
| 汇总表 | 维度列 + 调用次数 / 输入 token / 输出 token / 合计 token / 占比（进度条）/ 费用（元） | 只读 |
| 最近的调用明细 | 时间 / 场景 / 模型 / token / 来源（厂商回传 | 估算）/ 耗时(ms) / 状态 / 输入原文 | 只读 |
「估算」与「厂商回传」是 token 来源的两种口径
模型厂商在响应里回传真实 token 数的记「厂商回传」；意图识别、对话后建议这类厂商不回传 token 的链路，由平台按规则估算，记「估算」。两者在明细「来源」列打标签区分，汇总时一并计入。
明细块是独立权限
「最近的调用明细」会把用户提问原文列出来，因此单独受 agent:usage:detail 控制：只有查询权限的角色看得到汇总、看不到这块明细。
常用操作
换维度下钻
四个单选即切即算：排查「谁在用」切按用户，排查「哪类任务贵」切按场景，排查「哪个模型在烧」切按模型，看趋势切按日期。占比列的进度条按合计 token 计算。
框时间范围
「时间范围」填开始 / 结束时间后全页（统计卡 + 汇总表 + 明细）一起收窄；「重置」恢复全量。
看配额余量
顶部告警条同时给「我的月配额」与「本租户月配额」两行：token 与金额双口径、带占比。配额本身在助手配置里维护。
视角对照
| 视角 | 看到什么 |
|---|---|
租户管理员 docadmin | 全租户汇总 + 调用明细（含 agent:usage:detail） |
业务角色（如 salesman01） | 角色授 agent:usage:query 时可进：「我的月配额」只反映自己那份；汇总与明细是否可见取决于角色权限 |
进阶
- 场景字典：
CHAT对话主链路、INTENT意图识别、SUGGESTION对话后建议、TOOL_LOOP工具循环、PLAN_DSL规划工作流 DSL、VALIDATE_RETRY校验失败自修正——同一次提问通常会在多个场景各记一行； - 费用（元）按当次调用的价格快照计算（模型平台价目），明细里 ERROR 行也计入已发生的耗时与 token；
- 耗时(ms) 60000 且状态 ERROR 的行是超时调用（60s 上限），排查模型可用性去模型配置的测试弹窗；
- 配额告警线触达后通知租户联系人、每周期只发一次；达到上限只拒绝新的提问、不中断进行中的对话（见助手配置信息条）。
常见问题
Q：为什么有的行来源是「估算」？ A：意图识别、建议等链路厂商不回传 token，平台按规则估算并打标（见信息提示）。
Q：为什么 ERROR 行也占 token 和费用？ A：调用已实际发生、厂商已计费或部分计费，台账如实记录；超时行耗时记 60000ms。
Q：看不到「最近的调用明细」块？ A：角色缺 agent:usage:detail 权限；汇总块只需要 agent:usage:query。
Q：占比加起来为什么不一定正好 100%？ A：各维度行占比四舍五入到一位小数展示，尾差属正常。
Q：配额在哪改？ A：本页只读；配额的新增 / 编辑 / 删除在助手配置的「用量配额」块。