2. 平台对象和边界

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

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

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

2.1 对象关系总览

Zenova 的对象可以按「一次调用的路径」串起来理解。员工在对话中使用智能体，和业务系统用 API 密钥直接调用模型，走的是同一条网关路径，只是入口不同：

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

MCP 服务、API 服务等能力接入对象走同一条网关路径：智能体调用工具、外部客户端连接 MCP 服务时，网关同样完成认证、按流量规则处理，并记录调用。区别只在于上游是工具服务而不是模型。

几条需要记住的关系：

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

2.2 模型接入对象

上表是首次配置时绕不开的最小集合，第 4 章至第 7 章、第 19 章、第 20 章分别展开。

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

注意：删除确认框不一定列出全部引用关系（例如某个分组的可用范围与绑定的 API 密钥）。删除前请在「模型分组」列表与工作空间「智能体」页签中核对，避免误删后相关模型与智能体不可用。删除不可撤销。

2.3 能力接入对象

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

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

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

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

其他能力接入类型的对象形态与 MCP 服务一致：一个接入对象、一份可用范围、一套凭据、一份调用记录，配置入口在「管理后台 › 能力」下对应的菜单。

2.4 员工侧与智能体对象

以下对象只在 Zenova 中存在，承载员工的日常协作。

智能体与网关的关系：智能体本身不持有模型供应商的密钥。它选择的是模型，每次调用都以发起对话的员工身份经过网关，因此：

• 员工不在任何包含该模型的分组的可用范围内，智能体的模型调用会被拒绝；
• 模型分组的配额、流量规则、敏感数据检测与内容检测对智能体的调用同样生效；
• 智能体的调用出现在「运行总览 › 请求」中，与员工的 API 调用并列，可按发起人筛选。

工作空间与可用范围的关系：工作空间不单独维护模型清单。管理员在模型分组的「可用范围」中把分组授权给某个工作空间后，该分组出现在工作空间详情的「模型分组」页签，工作空间内的智能体可以选用分组内的模型。

2.5 流量与安全对象

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

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

注意

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

2.6 组织与运行对象

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

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

租户与平台两级边界

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

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

• 租户管理员在地址栏直接打开平台页面，会被送回「运行总览」。
• 租户管理员调用平台接口，返回 403 PERMISSION_DENIED。
• 平台范围的配置（例如部署配置、更新器状态）只在平台管理后台可见，租户侧看不到，也改不了。
• 平台账号不属于任何租户，登录工作台后只有「首页」（账号资料、偏好设置、账户安全、访问密钥），不显示能力中心、洞察与智能体。

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

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

租户隔离

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

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

2.7 许可模块

功能分为基础功能与高级模块。许可证未包含某个模块时，对应菜单与工作台入口不显示，相关接口拒绝访问。「授权许可」页签列出的高级模块为：模型护栏、动态路由、全链路审计、用量与成本。

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

1. 「导出授权请求（.json）」：导出请求文件，内含租户与部署的绑定信息。
2. 「发送给供应商」：把请求文件发给供应商，换取签名后的许可。
3. 「导入 .lic 文件」：校验通过立即生效。

这三步是离线完成的：导出与导入都在本地进行，激活不需要平台把部署信息回传给供应商，适用于内网隔离环境。页面同时说明许可不设到期时间，导入或移除许可后各模块状态即时更新。

注意

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

能力说明

---

上一章：1. Zenova 概览与配置流程 · 下一章：3. 组织、权限与工作空间