企业空间指南
企业空间是 Token Switch 提供的团队协作模式，适用于企业或团队统一管理 AI 资源与调用成本。企业内所有成员共享企业资金池，并通过"预算分配机制"实现精细化成本控制。在企业空间中，平台支持：
- 多层级组织架构（企业 → 部门 → 成员）
- 多角色权限管理（企业管理员 / 部门管理员 / 普通成员）
- 预算逐级分配与消耗控制
- 企业级调用监控与财务管理
1.角色说明
| 角色 | 核心职责 | 关键权限 | 数据范围 |
|---|---|---|---|
| 企业管理员 | 负责企业整体管理与资金控制 | 企业充值、创建部门、分配部门预算、查看并管理企业数据 | 企业全量数据 |
| 部门管理员 | 负责部门、成员、预算管理 | 创建子部门、分配子部门预算、添加成员、设置成员预算、查看并管理部门数据 | 所属部门及子部门数据 |
| 普通成员 | 使用企业分配的资源 | 创建 API Key、调用模型、查看并管理个人数据 | 仅个人数据 |
2.企业管理员使用指南
企业管理员拥有企业空间的最高权限，负责企业结构、预算与资金的统一管理
2.1 创建与进入企业空间
进入控制台后，点击右上角头像，可进行企业相关操作：
- 创建企业：新建一个企业空间
- 切换企业：在多个企业之间切换工作空间
2.2 企业资金管理
- 企业管理员进入【账户余额】页面进行兑换码充值、余额监控
- 平台支持查看完整充值记录，包括充值金额、操作人及时间，便于财务审计
- 所有部门与成员共享企业余额，所有调用费用均从企业账户中扣除
2.3 添加企业成员
- 【成员管理】是企业空间内统一管理成员的入口。企业管理员可先将用户加入企业用户池，再根据组织需要将成员分配至不同部门。
- 添加单个成员：点击【添加成员】可手动添加单个成员，通常需要填写手机号和姓名。姓名用于该成员在当前企业内的展示和识别，建议填写企业内部常用姓名或备注名。
- 批量导入成员：当企业需要一次性添加多个成员时，点击【批量导入】，下载标准导入模板、填写信息后上传文件，系统校验无误后完成导入，单次最多导入 500 条数据。 添加成功后，成员会进入企业成员列表。若成员尚未完成登录或激活，状态可能显示为「待激活」。
- 用户列表：用户池中的成员会展示企业姓名、手机号、用户 ID、所属部门及角色状态等信息，便于企业管理员识别和管理。当存在同名成员时，管理员可结合手机号或用户 ID 进行区分，避免误选成员。
- 快速查询：企业管理员可通过姓名、手机号等信息搜索成员，快速定位目标用户。
2.4 搭建部门架构
进入【部门管理】模块，可进行组织结构配置：
- 创建部门：添加部门名称即可快速创建部门（支持创建多层级部门结构），可选择设置部门默认月预算、部门管理员、导入成员
- 管理层级：支持树状结构展开与查看各层级部门
- 资产概览：查看企业余额与累计消耗、本月分配预算与实际消耗、企业部门/成员/API Key 等资产数据
2.5 部门预算分配
企业空间中的部门预算用于控制部门在自然月内可消耗的金额
- 默认月预算：部门每月默认可使用的预算额度
- 创建部门或编辑预算时，可设置「默认月预算」，留空表示不限制
- 每月 1 日，系统会根据默认月预算自动重置部门当月预算
- 适合设置长期稳定的部门预算规则
- 当前月预算上限：仅本月生效的临时预算额度
- 在编辑预算或「一键配置预算」中，可设置「当前月预算上限」
- 当前月预算上限仅本月生效，优先级高于默认月预算
- 适合临时调额、补额、专项项目预算调整等场景
- 一键配置预算：企业管理员可通过「一键配置预算」快速调整部门当月预算
- 配置时需填写当月部门预算上限，是否同步为默认月预算
- 若勾选「同步为默认月预算」，则该金额将从下月起作为部门默认月预算生效
- 预算消耗规则
- 成员在企业空间中调用模型时，费用会计入其所属部门的当月消耗
- 当部门当月消耗达到当前月预算上限时，该部门下成员将无法继续调用模型
- 若部门预算未设置上限，则该部门不受部门月预算限制，但仍受企业余额、成员预算、API Key 额度等限制
2.6 企业级监控与分析
在企业空间中，管理员可以通过「资源统计」「API Key」和「调用日志」三个模块，对企业内的资源使用情况进行统一监控与管理
（1）查看企业整体使用情况
进入【资源统计】页面，切换至「企业视图」，可查看企业在指定时间范围内的整体使用情况
- 页面顶部会展示当前统计周期内的核心指标，包括消耗金额、请求次数、Token 使用量以及平均 RPM 和 TPM，这些指标用于反映企业当前的调用规模与系统负载情况
- 调用数据分析：包括模型消耗分布、模型调用趋势以及部门消耗排行。通过这些信息，企业管理员可以快速了解不同模型与不同部门的使用情况，从而优化模型选择与预算分配
- API Key 使用情况分析：Key 消耗排行、不同类型 Key 的消耗占比以及请求成功率分布，帮助识别异常调用或资源使用不合理的情况
（2）管理企业 API Key
进入【API Key】页面，并切换至「企业 API Key」视图，可查看企业内所有 API Key
- 页面支持按照部门、成员、Key 名称或 API Key 进行筛选，便于快速定位目标 Key
- 列表展示每个 Key 的基本信息，包括所属部门、创建成员、Key 类型、分组、额度情况、可用模型范围以及当前状态
- 管理员可以对 API Key 进行启用、禁用、编辑或删除操作。当发现 Key 使用异常或存在安全风险时，可以通过禁用或删除操作及时进行控制
（3）查看调用明细（使用日志）
进入【调用日志】页面，默认展示「使用日志」，用于记录企业内所有成员每一次模型调用的详细信息，用于成本追溯与问题排查
- 日志内容包括调用时间、所属部门与成员、API Key、模型名称、Token 消耗、实际花费以及调用状态等
- 支持按时间范围、部门、成员、API Key 或模型进行查询，从而快速定位具体调用记录。
（4）查看任务执行情况（任务日志）
- 在【调用日志】中切换至「任务日志」，可查看企业内所有成员调用的异步任务的执行情况
- 任务日志记录了任务的提交时间、结束时间、执行时长、模型信息以及任务状态等内容，适用于需要跟踪执行过程的场景，例如生成类任务或耗时较长的调用
（5）查看操作记录（审计日志）
在【调用日志】中切换至「审计日志」，可查看企业内的管理操作记录
- 该模块主要用于操作追溯与权限审计，确保关键操作可被记录和查询。
- 日志记录操作时间、操作人、操作类型、操作对象以及具体操作内容，例如创建部门、修改成员信息等
2.7 余额预警机制
系统提供双层预警机制，确保业务不会因余额不足而中断
- 企业级预警：余额不足时提醒企业管理员
- 部门级预警：当预算使用达到阈值时触发提醒
3.部门管理员使用指南
部门管理员负责本部门的组织与成员管理，以及成员使用额度的控制，同时可查看本部门范围内的资源使用情况
3.1 部门结构管理
进入【部门管理】模块，选择当前所属部门后，可进行部门结构配置。
- 创建子部门：在当前部门下新增子部门，支持多层级结构
- 查看部门结构：左侧支持树状结构展开，可查看本部门及下属子部门
- 部门资产概览：可查看当前部门预算分配、实时消耗，以及该部门下的子部门、成员、API Key 数量
3.2 成员管理
在部门详情页中，切换至「直属成员」列表，可对成员进行管理
- 导入成员：点击「导入成员」，即可将成员池中尚无归属部门的成员批量加入当前部门，默认角色为普通成员
- 编辑成员：支持修改成员角色或调整其使用限制
- 移除成员：将成员移出当前部门（成员将无法继续使用该部门资源）
3.3 成员预算控制
部门管理员可对成员的使用额度进行精细化控制，防止资源滥用或异常消耗
- 在成员列表中，可为单个成员设置「日预算」或「月预算」，限制其日度或月度可消耗金额
- 同时支持通过「一键配置预算」，批量为当前部门内所有成员设置统一的预算上限
预算规则：
- 预算类型选择“不限制”，成员实际可用额度仅受「部门月预算」限制
- 预算类型选择“按天”，成员每日实际可用额度受「部门月预算」+「个人日预算」限制
- 预算类型选择“按月”，成员每月实际可用额度受「部门月预算」+「个人月预算」限制
3.4 部门 API Key 管理
进入【API Key】页面，切换至「部门 API Key」视图
- 查看当前部门下所有 API Key
- 支持按成员、Key 名称等条件筛选
- 可查看 Key 的额度、状态、模型权限等信息
- 可对 Key 进行启用、禁用、编辑或删除操作
- 统一规则配置与业务 Key 创建
- 点击「配置模板」，可为当前部门设置 API Key 的默认配置规则。设置完成后，部门内成员新创建 API Key 时，将默认继承该模板配置
- 模板配置内容包括：分组、过期时间 、默认额度（支持设置无限额度） 、 模型访问范围、IP 白名单限制
- 创建业务 API Key
- 不归属于个人成员，而是归属于部门，可用于服务端调用或共享业务场景
- 支持设置月度额度（区别于成员 Key 的个人消耗） ，占用部门月度预算
3.5 部门数据查看
进入【资源统计】页面，切换至「部门视图」，可查看当前部门的整体使用情况。页面展示内容包括：
- 部门总消耗金额、请求次数、Token 使用量等核心指标
- 模型消耗分布与调用趋势
- 部门内 API Key 使用情况
3.6 部门调用日志查看
进入【调用日志】页面，可查看当前部门内成员的调用记录
- 日志支持按时间、成员、API Key、模型等条件筛选，用于排查问题或分析消耗来源
- 使用日志：查看每一次调用的详细信息（成员、模型、费用等）
- 任务日志：查看异步任务执行情况
4.普通成员使用指南
普通成员是企业空间中的使用者，主要负责创建 API Key 并调用模型进行业务开发，其使用方式与个人空间类似，但资源由企业统一提供。
4.1 使用前提
普通成员无需进行充值操作，所有资源由企业统一提供。成员在使用过程中，当以下限制达到上限时，将无法继续调用模型：
- 所属部门的月度预算限制
- 个人单日消耗上限（由部门管理员设置）
4.2 创建与管理 API Key
进入【API Key】页面，默认只展示「我的 API Key」，即可管理个人创建的 Key。
- 点击「创建 API Key」，填写名称并选择分组，即可完成创建
- 可根据需要设置 Key 的过期时间、额度限制、模型范围及 IP 白名单
- 支持对 Key 进行启用、禁用、编辑或删除操作
4.3 查看个人使用情况
- 在【资源统计】页面切换至「我的视图」，查看个人消耗金额、请求次数及 Token 使用情况
- 在【调用日志】中查看个人调用记录，包括模型、花费及调用状态