看懂仪表盘
什么时候用
你需要快速了解的整体运营情况时看仪表盘。仪表盘展示了Token消耗、调用趋势、活跃用户数等核心指标，帮助你：
- 掌握今日/本月的用量
- 观察Token消耗的时间趋势
- 了解用户和Agent的活跃情况
- 快速定位用量突增或异常
普通用户也能看到仪表盘，但只能查看Token趋势、调用趋势和接入地址，看不到管理员专属的总览卡片和KPI网格。
你需要准备
- 管理员账号（查看全部内容需要）
- 平台已产生至少一些调用数据（否则图表为空）
- 如需查看预估费用，需先配置汇率（可选）
操作步骤
第 1 步：进入仪表盘
左侧菜单 -> 首页 / 仪表盘（通常登录后默认进入）。
第 2 步：理解总览卡片（仅管理员可见）
页面顶部的大卡片展示累计Token消耗，同时包含：
- 今日Token
- 本月Token
- 今日调用次数
- 本月调用次数
- 累计调用次数
这些数字会实时滚动，给你最直观的用量体感。
第 3 步：查看KPI小卡片网格（仅管理员可见）
总览卡片下方是一排小卡片，展示：
- 活跃用户：当前活跃的用户数
- 技能总数：内已启用的技能数量
- 智能体总数：已创建的Agent数量
- 预估费用（今日）：按当前汇率估算的今日费用
- 预估费用（本月）：本月累计预估费用
- 预估费用（累计）：历史累计预估费用
鼠标悬停在卡片上没有额外提示，数字本身就是最直接的信息。
第 4 步：切换Token消耗趋势时间范围
在「Token消耗趋势」图表右上角，有三个按钮：
- 近7天
- 近30天
- 近90天
点击即可切换时间范围。图表展示两条线：
- 每日Token总量（实线）
- 单次平均消耗（虚线）
第 5 步：查看调用次数趋势
下方的「调用次数趋势」图表同样支持近7/30/90天切换，展示：
- 每日调用次数（实线）
- 平均每次调用Token（虚线）
第 6 步：查看接入地址（所有用户可见）
页面底部展示OpenAI兼容API和MCP 网关的接入地址，你可以：
- 复制API基址用于客户端配置
- 点击「管理API Key」跳转到API Key管理页面
怎么验证成功了
- 作为管理员，你能看到顶部的累计Token大卡片和下方的KPI小卡片网格
- 作为普通用户，你看不到上述卡片，只能看到趋势图表和接入地址
- 点击「近7天」/「近30天」/「近90天」，图表数据会相应切换
- 点击「管理API Key」，能跳转到API Key管理页面
常见问题
1. 为什么我看不到总览卡片和KPI网格？
你不是管理员。只有管理员角色的用户才能看到这些数据。普通用户只能看到趋势图表和接入地址。
2. 图表显示「暂无趋势数据」或「暂无调用记录」？
说明所选时间范围内没有产生过调用。这是正常的，先去创建一个Agent并聊两句，再回来看。
3. 预估费用是怎么算的？
预估费用基于美元成本乘以当前汇率。汇率可以在设置中配置（如果支持）。费用只是估算，实际账单以财务模块为准。
4. 为什么今日Token和今日调用次数有时候不匹配？
一次调用可能消耗多个Token（取决于输入输出长度），因此Token数通常远大于调用次数。
深入
核心概念：会话、消息、调用记录的关系
一次调用通常会产生三类记录：
- ChatSession（会话）：代表一个连续对话，按租户、用户、客户端会话 ID 做唯一约束
- ChatMessage（消息）：保存用户输入、模型输出、工具消息，以及脱敏/哈希字段
- ai_api_call（调用记录）：每次 API 调用的主记录，包含状态、错误类型、Token、成本、延迟等
审计模式影响展示
消息内容展示受租户审计模式控制：
- no_mask：不脱敏，按原文展示
- mask_on_display：存储原文，展示时脱敏
- mask_on_save：写入时即保存脱敏内容
在日志页面看到的内容可能是脱敏后内容，不一定是原始内容。
安全事件
安全事件记录租户内的敏感操作和内容安全事件，例如：
- 命中敏感内容检测
- 命中禁用内容策略
- 用户角色变更
- API Key 创建/删除
- Agent 克隆
- 技能创建/更新
- 平台管理员查看其他用户数据
- 技能跨租户代部署
权限边界
| 操作 | 谁可以 |
|---|---|
| 查看本租户会话列表 | 租户 admin |
| 查看本租户会话消息 | 租户 admin |
| 查看调用统计 | 租户 admin |
| 查看安全事件 | 租户 admin |
| 查看其他租户日志 | 不允许，平台管理员能力按具体接口控制 |
| 查看 MCP 调用日志 | 租户 admin（仅本租户） |
常见坑
看到的是脱敏内容，不一定是原文 日志页面展示的内容受审计模式影响。如果设置为 mask_on_display 或 mask_on_save，管理员看到的可能是脱敏后的内容。
调用失败不一定有 assistant 消息 请求在安全检查、模型鉴权或限流阶段被拒绝时，可能只会有调用记录，没有完整 assistant 回复。
会话去重依赖客户端会话 ID 同一个（租户 ID、用户 ID、来源客户端、来源会话 ID）会复用同一个会话。如果客户端没有传稳定的来源会话 ID，会话列表可能看起来很分散。
Token 趋势只统计成功调用 统计页面通常基于调用记录聚合。被拒绝的请求可能没有 Token 用量，因此不会显著影响 Token 图表，但会出现在调用状态和安全事件中。
MCP 工具失败不要只看聊天消息 MCP 调用失败需要同时看调用日志，聊天消息中可能只有工具失败摘要。
排错速查
| 症状 | 可能原因 | 排查路径 |
|---|---|---|
| 用户说调用失败 | 模型鉴权、限流、上游错误 | 看调用记录状态和错误类型 |
| 返回内容策略违规 | 命中禁用模式 | 看安全事件类型=policy_violation |
| 内容被脱敏 | 租户审计模式开启 | 检查审计模式、脱敏规则 |
| 客户端被白名单拦截 | 允许的 API 客户端不包含当前客户端 | 看客户端访问日志的 user_agent 和白名单快照 |
| MCP 工具失败 | 工具被拒、上游超时或限流 | 看 MCP 调用日志状态、拒绝原因 |
| 统计数和预期不一致 | 时间范围、失败调用、模型组路由 | 调整参数，查看路由轨迹 |