2. 平台对象和边界

完整版章节。内容按 2026.10 主线代码与运行环境界面核对；具体入口以当前许可、账号权限和交付环境为准。

返回概览 · 完整版目录 · 下载完整 PDF

本章内容：本章面向租户管理员、安全管理员与平台管理员，说明平台上有哪几类配置对象、它们如何彼此关联、一次调用会依次经过哪些对象；同时说明租户管理后台与平台管理后台各管哪些事、租户之间如何隔离，以及许可模块如何决定功能可用。读完本章，管理员能判断一项需求该在哪个菜单配置、由谁负责、会影响哪些调用，也能解释「为什么我看不到某个菜单」。

2.1 对象关系总览

平台的对象可以按「一次调用的路径」串起来理解：

上游厂商 / 本地推理服务
   │  请求地址 + 账号密钥（由平台托管）
   ▼
模型供应商 ──启用──▶ 上游（供应商侧的具体模型）
   │
   ▼  一个或多个上游提供一个模型（调用名）
模型 ──加入──▶ 模型分组 ──设置──▶ 可用范围（所有用户 / 部门 / 职能组 / 成员 / 工作空间）、配额
   │
   ▼  范围内成员在模型广场创建
API 密钥（绑定一个模型分组，挂靠一个客户端）
   │
   ▼  携带密钥经统一入口发起调用
网关：认证 → 流量规则（路由、拒绝、限额、内容检测）→ 在模型的上游之间分发
   │
   ▼
请求记录（发起人、凭据、模型、Token、耗时、命中规则）

MCP 服务等能力接入对象走同一条网关路径：调用方使用各自的访问凭据，网关同样完成认证、按流量规则处理，并记录调用。区别只在于上游是工具服务而不是模型。

几条需要记住的关系：

• 一把 API 密钥只绑定一个模型分组。密钥能调哪些模型，由该分组包含的模型决定；能不能调，由持有人是否仍在分组的可用范围内决定。所以「授权」有两个动作：把模型放进分组，把人放进分组的可用范围。
• 分组只管授权与额度，不决定去向。调用去往模型的哪个上游由流量规则决定；没有规则接管时，在该模型的全部启用上游之间分发。
• 上游凭据只存在于模型供应商中。调用方持有的是平台签发的 API 密钥，转发时由网关换成平台托管的上游凭据，调用方全程不接触上游密钥。
• 流量规则作用于调用，不属于某个模型或分组。规则按条件（调用方、具体能力、调用类型、MCP 方法、工具名等）匹配经过网关的请求，按顺序评估；规则里写的是条件与动作，不改变对象本身的配置。
• 角色与可用范围解决的是两类问题。角色决定一个人能进哪些管理页面；可用范围决定一个人或一个部门能用哪些模型分组、哪些工具。两者可以叠加，但不能互相替代。

2.2 模型接入对象

上表的七个对象是首次配置时绕不开的最小集合，第 4 章至第 9 章分别展开。

删除对象时的引用关系：模型供应商、模型、模型分组和流量规则之间存在引用。删除模型时，仍有启用的上游或仍在分组中会被阻止（第 6.5 节）；删除模型分组时会检查引用后再确认，确认后不可撤销；被流量规则引用的上游不允许直接停用或删除，需要先在规则中去掉引用。删除模型供应商时，平台会一并删除它名下的全部上游，其所属的模型保留，但没有上游的模型无法再调用。确认框会列出受影响的模型（标明「删除后没有上游」或「仍有其他上游」），以及会阻止删除的引用：被流量规则引用的上游、仍作为某个默认模型用途唯一上游的模型（如内容判断模型），需要先在规则或全局设置中处理。删除前请先确认没有仍在使用的密钥挂在上面。

注意：删除确认框不一定列出全部引用关系（例如某个分组的可用范围与绑定的 API 密钥）。删除前请在「模型」与「模型分组」列表中核对该供应商的上游所属模型是否仍被使用，避免误删后相关模型不可用。删除不可撤销。

2.3 能力接入对象

与管理后台的模型对象并列的是能力接入对象。它们把模型之外的资源（工具、接口）接入平台，并对成员分发。以 MCP 服务为例，一个 MCP 服务至少包含以下几部分：

工具级权限是「能力接入」与「角色」最容易混淆的一点：角色只控制管理后台中能查看和操作的对象，MCP 工具的调用权限在「流量规则」中按「具体能力 + 调用方 + 工具名」配置，不在角色里勾选。规则的动作选择「拒绝本次调用」即可收窄权限，例如只允许某个成员调用查询类工具、拒绝写类工具。

你会看到：被规则拒绝的工具调用出现在「调用情况」中，结果为失败，并给出原因代码（例如某个自定义的原因标识），而不是笼统的「未归类」。这便于区分「规则拒绝」与「工具本身报错」。

注意：可用范围决定「能不能连上这个服务」，流量规则决定「连上之后能调哪些工具」。两者都配置时，成员看到的服务不变，但被拒绝的工具会返回拒绝结果与原因。

其他能力接入类型（API 服务、外部智能体、技能、插件等）的对象形态与 MCP 服务一致：一个接入对象、一份可用范围、一套凭据、一份调用记录，配置入口在管理后台对应的菜单。各类能力的具体字段以当前界面为准，详见第 11 章、第 12 章。

2.4 流量与安全对象

标签的适用范围目前只有「调用方」与「模型」两类：标签可以标在调用方上，也可以标在模型上，供规则按标签匹配、按标签归集用量。

规则保存前先预览：流量规则保存时会弹出「确认变更」，展示这次改动的字段差异与命中顺序。在预览中确认调用方显示为具体的人、规则名称保留原值后，再执行确认。命中顺序决定了规则的实际效果——排在前面的规则先匹配，命中「结束匹配」的规则后不再评估后续规则。

注意

• 规则里引用的是对象当前的名字与标识。改过对象名称后，回来看一眼已有规则的条件是否需要重选。
• 护栏规则本身只是检测依据，不引用就不会生效；执行点在流量规则的动作里。

2.5 组织与运行对象

组织对象在能力对象之前建好。组织就绪后，能力可以按部门或职能组整体授权，人员变动时只改组织关系，不动能力配置。

配置生效的时间关系（这些会影响「改完为什么不立刻看到效果」的判断）：

2.6 租户与平台两级边界

管理后台分为两级。登录账号的管理范围决定进入哪一级，两级显示的菜单不同。

租户与平台之间是硬边界，不靠菜单隐藏实现：

• 租户管理员在地址栏直接打开平台页面，会被送回「运行总览」。
• 租户管理员调用平台接口，返回 403 PERMISSION_DENIED。
• 平台范围的配置（例如部署配置、更新器状态）只在平台管理后台可见，租户侧看不到，也改不了。

你会看到：租户管理员打开平台页面时，页面约数秒后跳回「运行总览 › 总览」，侧栏不出现平台分组。这是一次完整的拒绝，而不是加载失败。

注意：平台范围内的「部署配置」依赖更新器组件。部署时未安装更新器时，该页面不可用，接口返回 503（updater_unavailable）。这属于平台管理员的维护工作，见第 23 章。

租户隔离

• 按凭据判定租户：网关根据 API 密钥确定调用所属租户，不信任客户端自行携带的租户或用户身份请求头。伪造这类请求头不会改变平台判定的租户与发起人。
• 数据与配置互不可见：租户之间的成员、模型、模型分组、API 密钥、规则、用量与请求记录互不可见；一个租户的密钥不能调用另一个租户的模型。
• 许可按租户生效：许可证由各租户的租户管理员在「全局设置 ›「授权许可」页签」中导入，只影响当前租户；平台控制台不管理许可证。
• 网关节点共享：同一部署下的网关节点接收同一份配置并共用一个入口。产品不提供把某些租户固定到某一组网关节点的分组能力。

适用场景：集团为下属单位分别开通租户，各单位自行维护组织与模型配置，只在平台层统一运维。开通第二个租户由平台管理员在平台管理后台完成，租户侧的界面与本章所述一致。

2.7 许可模块

功能分为基础功能与加购模块。许可证未包含某个加购模块时，对应菜单不显示，相关接口拒绝访问。

查看当前许可：进入「管理后台 › 系统设置 › 全局设置 ›「授权许可」页签」。页面除许可状态外，还给出离线激活的三步流程：

1. 导出授权请求（.json）。
2. 把请求文件发给供应商，换取签名后的许可文件。
3. 导入 .lic 文件完成激活。

这三步是离线完成的：导出与导入都在本地进行，激活不需要平台把部署信息回传给供应商，适用于内网隔离环境。

注意

• 许可与部署绑定。导出的授权请求包含该部署的绑定信息，因此开发、测试、生产各一套部署需要各自的许可文件，不能互相导入。
• 许可与 CPU 架构、操作系统无关，迁移主机不影响许可有效性。
• 菜单看不到时，先核对账号的管理范围与角色，再核对许可模块（见 1.2「菜单可见性」）。

能力说明

---

上一章：1. Zentrix 概览与配置流程 · 下一章：3. 组织与权限