用户手册
2. 平台对象和边界
完整版章节。内容按 2026.10 主线代码核对；具体入口以当前许可、账号权限和交付环境为准。
Zentrix 的配置对象分为组织、能力接入、流量与安全、运行与审计四类，全部在管理控制台中维护；成员和业务系统按可用范围使用其中已发布的能力。下表只列出 Zentrix 中可见的对象，「入口」列为管理控制台中的菜单。
组织与权限
| 对象 | 用途 | 入口 | 配置建议 |
|---|---|---|---|
| 租户 | 一套独立的组织、数据与权限范围 | 平台范围「租户管理」 | 每个企业或独立组织一个租户；租户之间的数据和授权互不共享 |
| 部门 | 成员在正式组织架构中的归属，可设负责人和上级部门 | 「成员与部门」 | 按真实汇报关系建立；接入通讯录同步后由来源系统维护 |
| 职能组 | 跨部门的成员集合，用于分发模型服务等资源 | 「职能组」 | 按职责或项目建立，不替代部门树 |
| 成员 | 可以登录并使用平台的个人账号 | 「成员与部门」 | 离职人员移入「已离职成员」，其 API 密钥与登录凭据随即失效 |
| 角色 | 六个内置角色，决定成员能进入哪些管理菜单 | 「角色管理」 | 系统管理员、安全管理员、审计员由不同人员担任 |
| 身份源 | 钉钉、飞书、企业微信、企业 IAM、LDAP 与目录推送 | 「SSO 配置」 | 先完成测试登录或连接自检，再启用 |
| 安全策略 | 会话时长、在线人数、登录方式、密码策略与外部访问令牌 有效期 | 「账号与会话安全 → 安全策略」 | 上线前确定，变更后在会话列表中确认影响 |
能力接入
| 对象 | 用途 | 入口 | 配置建议 |
|---|---|---|---|
| 模型供应商 | 平台连接外部或自建模型端点的方式，含凭据、接口格式、模型价格与分类 | 「模型供应商」 | 每个供应商单独维护凭据；验证通过后再被模型服务引用 |
| 模型服务 | 向成员和业务系统提供的一组有序模型，含可用范围、配额与限流保护 | 「模型服务」 | 按用途命名，例如“通用对话”“代码助手” |
| API 密钥 | 调用模型服务的凭据，每个 Key 绑定一个模型服务 | 成员在能力中心「首页 → API 密钥」或模型详情中创建；管理员在「模型服务 → API 密钥管理」检索与处置 | 按应用或用途分别创建，不在多人之间共享 |
| MCP 服务 | 以 MCP 协议对外提供的工具服务，含工具清单、凭据与可用范围，工具级访问控制通过路由策略配置 | 「MCP 服务」 | 每个服务单独维护连接与授权，临时授权设置有效期 |
| API 服务 | 以 HTTP 反向代理方式对外提供的上游接口，统一鉴权与分发，不转换为 MCP 工具 | 「API 服务」 | 适用于按上游原接口调用的应用 |
| 外部智能体 | 通过 Agent Card 接入的外部智能体，含上游凭据、调用 Token 与可见范围 | 「外部智能体」 | 接入前先测试连通；任务执行情况在「任务中心」查看 |
| 技能 | 从代码仓库地址或压缩包导入、按范围分发的技能包 | 「技能」 | 导入后按范围分发，在能力中心「技能广场」核对 |
| 插件 | 由技能和远程 MCP 组成的插件包 | 「插件」 | 导出的插件包不含凭据 |
| 外部注册中心 | 从 Nacos 同步外部智能体与 MCP Server 的来源 | 「外部注册中心」 | 同步得到的条目仍需单独分发 |
| 知识库 | 企业知识源与检索资产 | 「知识库管理」 | 仅在许可证包含知识库能力且部署已安装时可见 |
流量与安全
| 对象 | 用途 | 入口 | 许可模块 |
|---|---|---|---|
| 规则 | 按条件匹配请求，执行放行、拒绝、转发、改写或内容检测，按优先级依次评估 | 「流量规则 → 规则清单」 | 动态路由 |
| 全局限额 | 按条件限制请求次数、并发，配置熔断、上游超时与临时豁免 | 「流量规则 → 全局限额」 | 动态路由 |
| 意图集 | 供规则按任务类型、难度或业务场景分流的意图定义，分内置意图与自定义意图集 | 「流量规则 → 意图集」 | 动态路由 |
| 语义缓存 | 相似请求直接返回缓存结果，按租户和模型隔离 | 「流量规则 → 缓存」 | 动态路由 |
| 敏感数据规则 | 识别个人信息与密钥，设置命中动作 | 「护栏 → 敏感数据」 | 模型护栏 |
| 词库 | 黑名单、白名单词条 | 「护栏 → 词库」 | 模型护栏 |
| 问答 | 问题足够相似时直接返回预设答案 | 「护栏 → 问答」 | 模型护栏 |
| 内部系统白名单 | 危险工具调用检测中放行的内部系统 | 「护栏 → 内部系统白名单」 | 模型护栏 |
| 恶意来源库 | 外部威胁情报来源及其命中动作 | 「威胁情报」 | 基础功能 |
| 网关扩展 | 在网关请求处理过程中执行的 WASM 插件，可按模型、路由或调用方绑定 | 「网关扩展」 | 基础功能 |
规则中的内容检测会引用护栏中维护的敏感数据规则、词库和问答。只开通动态路由时，可以配置路由、限额和缓存；需要维护这些检测依据时，还需要模型护栏模块。
运行与审计
| 对象 | 用途 | 入口 |
|---|---|---|
| 通知渠道 | 钉钉、飞书、企业微信、Webhook 和邮件等告警投递目标 | 「告警规则 → 通知渠道」 |
| 告警规则 | 按调用质量、策略命中和费用设置的阈值告警 | 「告警规则 → 告警规则」 |
| 会话诊断问题 | 从会话数据中识别出的问题、原因与证据，可标记处理状态 | 「会话诊断」 |
| 操作审计记录 | 谁在何时修改了配置、触发了动作或访问了资源 | 「操作审计」（全链路审计） |
| 导出任务 | 一次性或定时导出的调用与用量数据 | 「报表导出」 |
| 通知横幅 | 显示在页面顶部的公告 | 「通知横幅」 |
平台范围的对象（网关节点、公开访问地址、入口证书、备份与恢复、系统更新等）只由平台管理员维护，入口见 1.2 首页与导航。