# 用量与套餐

管理员与审计员在「套餐与用量」查看席位、模型 tokens、存储、已装条目与助理活动，以及当前套餐上限；在「管理分析」查看同期的应用请求与审计活动。更详细的模型账单明细位于「模型与额度」的「账单」页签中。本页面仅供查看，不能在界面中直接修改套餐。

## 谁能用

- **适用角色**：仅「管理员」与「审计员」可以使用。两者在侧栏均能看到入口，页内功能均为只读，权限完全相同。
- **页面权限与分工**：
  | 页面 | 导航名称 | 所在分组 | 侧栏可见角色 | 读写权限 |
  |---|---|---|---|---|
  | `/usage` | 「套餐与用量」 | 「企业设置」 | 管理员、审计员 | 只读 |
  | `/insights` | 「管理分析」 | 「概览」 | 管理员、审计员 | 只读 |
  | `/llm`（「账单」页签） | 「模型与额度」 | 「助手」 | 仅管理员 | 只读明细（详见 [模型与 Agent 设置](/admin/models)） |
- **无权限访问**：若账号角色不具备读取权限，界面显示「没有权限」，并提示「你的账号角色不允许查看这个页面。请联系租户管理员。」。
- **操作与助手代读限制**：本模块没有任何界面写操作。助手不能代读「套餐与用量」和「管理分析」页面的内容。
- **席位规则**：系统服务账号不占用成员席位，界面说明标注「服务账号不占席位。」。

## 怎么打开

你可以通过以下几种方式进入相关页面：

1. **打开「套餐与用量」**：
   - 方式一：在[工作台](/guide/workspace)左侧导航中进入「我的组织」，展开「企业设置」分组，点击「套餐与用量」。
   - 方式二（通过概览待办）：当组织席位达到预警时，[工作台](/guide/workspace)概览待办会显示「席位已用完」或「席位接近上限」，并提示已用席位数与上限。点击待办中的「查看用量」按钮，可直接跳转至「套餐与用量」。
2. **打开「管理分析」**：
   - 在[工作台](/guide/workspace)左侧导航中进入「我的组织」，展开「概览」分组，点击「管理分析」。
3. **打开模型账单明细**：
   - 在[工作台](/guide/workspace)左侧导航中进入「助手」分组，点击「模型与额度」，切换至「账单」页签（详见 [模型与 Agent 设置](/admin/models)）。

> **提示**
>
> [工作台](/guide/workspace)的概览仪表盘会复用部分用量卡片（包含成员席位、模型用量、文件存储与已装条目）。此外，如果在[成员](/admin/members)管理页面邀请新成员时席位已满，系统会提示「席位已满，联系平台运营增加席位」。

## 界面一览

### 「套餐与用量」

![「套餐与用量」](/shots/admin-usage.webp)

图：「套餐与用量」

1. 页头「套餐与用量」：本页不能改套餐
2. 「统计周期」：最近 7 / 30 / 90 天
3. 用量：席位（活跃+待激活）、本月模型、存储、已装条目
4. 「助理活动」：草稿、已应用的变更、采纳率、管理操作

- **页头与统计周期**：页头显示标题「套餐与用量」。顶部提供「统计周期」筛选切换，可选「最近 7 天」「最近 30 天」与「最近 90 天」，默认选中「最近 30 天」。
- **「用量」区域**：说明文字标注「服务账号不占席位。」。包含以下四张用量卡片：
  - **「成员席位」**：已用席位数等于活跃成员数与待激活成员数之和，单位为「个」。若不设上限，提示信息展示活跃与待激活成员数量并标注「席位不限」；若席位已满，提示「席位已用完，无法再邀请成员」；若仍有名额，提示还可邀请的人数。
  - **「本月模型用量」**：统计当月使用的 tokens 数量，单位为 tokens。若模型来源为组织自带密钥，卡片提示「使用自带密钥」。
  - **「文件存储」**：统计当前已用的文件存储容量，换算为 MB 显示，无套餐上限进度条。提示信息显示人类可读的字节大小。
  - **「已装条目」**：统计组织内已启用的应用与内容安装数量，单位为「个」，配额上限来自套餐。提示信息为「应用与内容」。
  - **卡片预警与状态**：若套餐不设对应限额，用量卡不显示进度条；若缺少统计数据，状态显示为「尚未接入」；使用量达到或超过 80%（≥ 80%）时，标记为「接近上限」；使用量达到 100% 时，标记为「已用完」。
- **「助理活动」区域**：展示所选周期内助理的辅助活动指标：
  - **「草稿」**：提示信息为「助理与用户起草的变更」。
  - **「已应用的变更」**：提示信息为「经人审阅后写入数据」。
  - **「采纳率」**：计算公式为 已应用的变更 / 草稿 百分比。提示信息显示「已应用 / 草稿」，若周期内没有草稿则提示「还没有草稿」。
  - **「管理操作」**：提示信息为「成员、应用、设置的变更」。
- **左侧「套餐」卡片**：
  - **「组织」**：显示当前组织名称。
  - **「套餐」**：显示当前套餐计划名称。若该计划已停止销售，带有停售徽章「已停售」；若未绑定计划，显示「未分配（按许可）」；若读取失败，显示「暂时读不到」。
  - **「席位上限」**：显示席位配额（如多少个）。若由平台运营单独调整过，会附带「（为你们单独调整）」标识；若无上限限制则显示「不限」。
  - **「可装条目」**：显示安装条目配额（如「最多」多少「个」），未设上限时显示「不限」。
  - **「模型额度」**：以紧凑数字形式显示每月额度，附带「tokens / 月」；未设月预算时显示「不限」。
  - **底部说明**：标注「调整席位或额度，请联系平台运营。」。
- **右侧「其他计量」卡片**：
  - **「审计记录」**：显示所选周期内的审计事件数量（如多少「条」）。
  - **「模型 token」**：显示模型 token 计数，未接入统计时显示徽章「未接入计量」。
  - **「文件存储」**：显示文件存储用量，未接入统计时显示徽章「未接入计量」。

### 「管理分析」

![从用量页对照的「管理分析」](/shots/admin-usage-insights.webp)

图：从用量页对照的「管理分析」

1. 「管理分析」在概览组，与套餐页分开
2. 「常见操作」：向助理提问、起草变更、管理操作等
3. 「应用使用」：失败指返回 5xx

- **页头与统计周期**：页头显示标题「管理分析」，支持切换「最近 7 天」「最近 30 天」与「最近 90 天」。
- **「概览」指标区域**：描述文字标注统计起止日期区间并注明「（UTC）」。包含以下四项核心指标：
  - **「应用请求」**：提示信息显示请求失败占比（保留一位小数并带有 `%`），若所选周期内没有请求则提示「还没有请求」。
  - **「向助理提问」**：统计向助手提问的次数。
  - **「已应用的变更」**：提示信息为「经人审阅后写入数据」。
  - **「管理操作」**：提示信息为「成员、应用、设置的变更」。
- **「每日活动」趋势图**：
  - 柱状图展示每日活跃事件。若选定周期内没有审计事件，显示空状态「这段时间没有活动。」。
  - 鼠标悬停在柱形上时显示浮层：展示具体日期，以及助理提问数、草稿数、管理操作数与其它事件数。
- **「应用使用」列表**：
  - 节说明注明「失败指返回 5xx。」。
  - 若所选周期内没有应用调用，显示空状态「这段时间没有人使用应用」。
  - 表格按请求量从高到低降序排列，包含以下列：
    | 列名 | 说明 |
    |---|---|
    | 「应用」 | 应用名称 |
    | 「请求」 | 周期内发起的请求总次数 |
    | 「失败」 | 失败次数与占比（格式为失败次数及占比百分比），若无失败显示「0」 |
    | 「每日」 | 每日使用频次趋势 |
- **「常见操作」列表**：
  - 若周期内没有操作记录，显示空状态「还没有操作。」。
  - 最多展示 10 条高频操作。已知动作类型包括：「向助理提问」「定时任务运行」「起草变更」「应用变更」「放弃草稿」「上传文件」「删除文件」；管理类操作显示为「管理操作 · …」（带有具体的动作后缀）；其他操作显示原始名称。

### 关联页面：「模型与额度」中的「账单」

详细的模型账单明细不在本页面内嵌展示，需前往「助手」→「模型与额度」→「账单」（详见 [模型与 Agent 设置](/admin/models)）：
- **月份筛选**：支持选择最近 12 个月内的任一月份。
- **月度合计**：展示所选月份合计、「请求」总数与 `Tokens` 消耗总数，附带提示「自带密钥不计费」。
- **导出操作**：提供「下载 CSV（按模型）」与「按人」下载按钮。
- **「按模型」表格**：包含列「模型」「来源」（显示「自带」或「平台」）「请求」「输入 tokens」「输出 tokens」「当前单价（每百万）」「金额」。若当月无调用，显示「这个月没有调用」。
- **「按人」表格**：包含列「人」（非具体成员时显示「平台（无人）」）「角色」「请求」、`Tokens`、「金额」。
- **金额规则**：金额小于或等于 0 时显示为「—」；不足 0.01 美元时显示为「< 0.01 USD」。

## 常用操作

### 查看套餐与用量

![套餐上限与其他计量](/shots/admin-usage-plan.webp)

图：套餐上限与其他计量

1. 「套餐」：计划名、席位上限、可装条目、模型额度
2. 「其他计量」：审计记录、模型 token、文件存储
3. 席位上限：不限或「为你们单独调整」

1. 在[工作台](/guide/workspace)左侧进入「我的组织」，点击「企业设置」分组下的「套餐与用量」。
2. 在右上角点击「统计周期」，按需切换「最近 7 天」「最近 30 天」或「最近 90 天」（默认为「最近 30 天」）。
3. 检查「用量」卡片数据：
   - 查看「成员席位」卡片，确认活跃与待激活成员总数及剩余可邀请名额。
   - 查看「本月模型用量」卡片，确认当月 token 消耗，若配置了自带密钥会显示「使用自带密钥」提示。
   - 查看「文件存储」卡片，确认已用存储 MB 大小。
   - 查看「已装条目」卡片，确认已启用的应用与内容数量。
4. 查看卡片预警状态，确认是否存在「接近上限」或「已用完」的情况。
5. 查看「助理活动」区域，了解草稿数、已应用的变更数、采纳率以及管理操作数。
6. 查看左侧「套餐」卡片中的套餐版本、席位上限、可装条目与模型额度，并查看右侧「其他计量」中的审计记录条数。
7. 若需要调整席位或配额，界面底栏提示「调整席位或额度，请联系平台运营。」，需联系平台运营协助处理。

### 查看管理分析

1. 在[工作台](/guide/workspace)左侧进入「我的组织」，点击「概览」分组下的「管理分析」。
2. 切换统计周期为「最近 7 天」「最近 30 天」或「最近 90 天」。
3. 在「概览」区域查看应用请求总数（及失败占比）、向助理提问次数、已应用的变更数与管理操作数。
4. 在「每日活动」区域查看每日事件柱状图，可将鼠标悬停在特定柱形上查看各项事件明细。
5. 在「应用使用」表格中，按请求量降序查看各应用的使用频次与 5xx 失败率。
6. 在「常见操作」列表中，查看排名前 10 的高频操作。

### 导出模型账单明细

1. 在[工作台](/guide/workspace)左侧进入「助手」分组，点击「模型与额度」。
2. 切换至「账单」页签。
3. 在月份下拉菜单中选择对应月份（可选最近 12 个月）。
4. 核对「按模型」或「按人」表格中的请求次数、输入/输出 tokens 与费用金额。
5. 点击顶部的「下载 CSV（按模型）」按钮，导出按模型汇总的账单文件。
6. 点击顶部的「按人」按钮，导出按成员汇总的账单文件。

## 状态说明

### 用量与限额状态

| 状态标记 | 触发条件 | 界面影响 |
|---|---|---|
| 「接近上限」 | 某项指标的已用量达到或超过配额的 80%（≥ 80%） | 卡片显示预警提示，提醒管理员及时扩充配额 |
| 「已用完」 | 某项指标的已用量达到配额的 100% | 达到配额上限。若席位已用完，无法再邀请新成员，待办与成员页均会弹出满员提醒；若可装条目已用完，无法继续安装新应用或内容 |
| 「尚未接入」 | 缺少该项指标的统计数据 | 卡片不显示具体用量数值 |
| 「未接入计量」 | 「其他计量」卡片中的指标未接入统计系统 | 指标旁显示该徽章 |
| 无进度条 | 套餐中对应指标不设限额（配额为 0 或未设上限） | 仅显示已用数值，不显示进度条 |

### 套餐与配额标识

| 标识/文案 | 含义 |
|---|---|
| 「已停售」 | 当前组织所绑定的套餐计划已下架停售，已有功能不受影响 |
| 「未分配（按许可）」 | 组织当前未绑定商业套餐计划，按底层部署许可生效 |
| 「暂时读不到」 | 系统暂时无法读取组织套餐信息 |
| 「（为你们单独调整）」 | 平台运营为当前组织单独调整了席位上限配额 |
| 「不限」 | 席位上限、可装条目或模型额度未设限额 |

## 让助手帮你做

- **代读限制**：「套餐与用量」和「管理分析」均为纯只读界面，助手**不能**代读本页面数据。
- **修改限制**：助手**不能**代你修改组织套餐或席位上限。
- **助手支持的相关操作**：助手支持执行模型策略相关的配置操作（操作会落到「模型与额度」页面，必须由管理员本人确认）：
  - 「修改模型与额度」
  - 「设置模型来源（自带密钥）」
  - 「设置成员的模型使用」

你可以这样对助手说：

> 把组织每月额度调到 100 万 tokens。

> 看一下我们这个月模型用了多少——你读不了用量页，请让我打开「模型与额度」。

## 设置

- **本页面无可改设置**：组织套餐类型、席位上限、可装条目上限均由平台运营与系统许可决定，组织管理员无法在此自助修改。
- **模型月额度配置**：模型月预算额度需在「模型与额度」的「策略」中配置。若策略中月预算为 0 或留空，用量页中的「模型额度」即显示为「不限」。
- **统计周期切换**：页面统计周期支持在「最近 7 天」「最近 30 天」与「最近 90 天」之间切换，该设置仅在前端临时生效，默认为「最近 30 天」。

## 注意事项

- **席位计算与邀请限制**：
  - 成员席位已用数严格等于活跃成员数与待激活成员数之和。
  - 系统服务账号不计入席位（界面说明标注「服务账号不占席位。」）。
  - [工作台](/guide/workspace)概览仪表盘、[成员](/admin/members)管理页与用量页采用完全相同的席位计算规则。
  - 席位已用完时，管理员无法继续邀请新成员加入组织。成员管理页会提示「席位已满，联系平台运营增加席位」；概览待办会提示「席位已用完，无法再邀请成员」并引导「查看用量」。
  - 平台运营可为组织单独调整席位上限，调整后卡片会显示「（为你们单独调整）」。
- **已装条目配额**：
  - 「已装条目」统计当前组织内处于已启用状态的应用与内容安装总数，界面提示「应用与内容」。
  - 上限由套餐决定。达到上限后将无法安装新条目。若配额为 0 则表示不设上限。
- **模型用量与自带密钥**：
  - 「本月模型用量」卡片统计当月消耗的 token 总数。
  - 自带密钥的消耗也会统计进本月模型用量卡（提示「使用自带密钥」）。
  - 在「账单」明细中，自带密钥明确标注「自带密钥不计费」，不会产生平台费用。模型预算来自「模型与额度」策略，而非计费套餐强制限制。
  - 用量页不展示按成员或按模型的明细表格，如需查看请前往「模型与额度」的「账单」页签。
- **文件存储容量**：
  - 文件存储数据与「我的组织」→「数据」→「存储」页的「已存文件」同源，最多支持统计 5 万个对象。详见[数据、存储与导出](/admin/data)。
  - 文件存储仅展示当前已用容量（换算为 MB 显示），没有套餐上限进度条。若计量失败则显示「未接入计量」。
- **管理分析与审计统计**：
  - 助理活动、管理操作以及审计记录均来源于当前组织的审计日志，统计窗口为所选天数（最多统计 90 天）。
  - 应用请求量与 5xx 失败数由网关按组织独立汇总，不同组织间数据完全隔离。
  - 「应用使用」列表中的失败**仅指 HTTP 5xx 错误**（界面说明注明「失败指返回 5xx。」）。
  - 「常见操作」列表最多展示 10 条高频操作记录，应用使用列表固定按请求量从高到低降序排列。
- **许可到期与宽限期**：
  - 组织控制台不支持自助修改套餐。
  - 许可到期后进入只读宽限期（默认 30 天）。在宽限期内，修改数据的公网接口会被系统拒绝（登录除外）。
  - 许可完全过期后，托管应用将停止运行，但组织数据仍可读取并支持导出。

## 目前不支持

- 在组织控制台内自助修改套餐、自助增加席位或设置付费门禁（需联系平台运营协助处理）。
- 由套餐直接强制限制文件存储上限或强制限制模型额度（模型额度仅由模型策略控制，非计费模块强制）。
- 由助手代读「套餐与用量」和「管理分析」页面，或通过助手在本页面执行写操作。
- 在「套餐与用量」页面内直接内嵌模型账单明细表（需前往「模型与额度」查看）。
- 实时用量数据回传。

## 常见问题

#### 席位用满了应该如何增加？可以在后台自己加席吗？
本页面不能直接修改套餐或增加席位。当席位满额时，成员管理页将无法继续邀请新成员，悬停提示「席位已满，联系平台运营增加席位」；概览待办会提示「席位已用完」并引导「查看用量」。如需增加席位或升级套餐，请联系平台运营协助调整。

#### 为什么在「套餐与用量」中看不到每个成员或每个模型的详细用量明细？
「套餐与用量」页面仅提供组织维度的总览数据（席位、本月模型 tokens、存储 MB、已装条目与助理活动概况）。如果需要查看按成员、按模型的请求次数、Token 消耗以及账单金额明细，请前往「助手」分组下的「模型与额度」页，切换至「账单」页签查看或导出 CSV。

#### 为什么「文件存储」卡片没有显示上限进度条？
系统当前套餐未对文件存储设置硬性上限进度条，卡片仅展示当前已用容量（换算为 MB 显示，提示中提供具体字节大小）。

#### 使用组织自带的模型密钥，会扣减用量和额度吗？
若组织配置了自带密钥，「套餐与用量」的「本月模型用量」卡片仍会统计实际消耗的 token 数并提示「使用自带密钥」；但在「模型与额度」的「账单」中明确标注「自带密钥不计费」，不会产生平台模型费用。

#### 「管理分析」中的应用「失败」都包含哪些情况？
「管理分析」界面明确说明「失败指返回 5xx。」。只有服务端出错的请求才会被计入失败次数，因权限或参数等原因被拒绝的请求不计入此项统计。