用户手册
附录 B. 常用任务索引
完整版章节。内容按 2026.10 主线代码核对；具体入口以当前许可、账号权限和交付环境为准。
按使用顺序列出常用任务及对应章节。标注「平台管理员」的任务只在平台范围的管理控制台中操作。
开通与组织
| 常用任务 | 参考章节 |
|---|---|
| 了解产品范围、许可模块与推荐配置顺序 | 第 1 章 · Zentrix 概览与配置流程 |
| 核对菜单的可见条件 | 1.2 首页与导航 |
| 了解各配置对象及其入口 | 第 2 章 · 平台对象和边界 |
| 导入许可证并核对已开通的模块 | 23.9 授权许可、通知横幅、品牌与 SMTP 配置 |
| 建立部门并添加成员 | 3.1 新建部门、3.2 添加成员 |
| 处理成员离职与恢复入职 | 3.3 维护成员与已离职成员 |
| 为系统管理员、安全管理员、审计员等角色指定成员 | 3.4 角色管理 |
| 建立跨部门的职能组 | 3.5 职能组 |
| 接入钉钉、飞书、企业微信、企业 IAM、LDAP 或目录推送 | 3.6 SSO 配置 |
| 设置会话时长、登录方式、密码策略与 令牌有效期 | 3.7 账号与会话安全 |
| 开启两步验证与通行密钥 | 3.8 个人账户安全：两步验证与通行密钥 |
接入模型与开放模型服务
| 常用任务 | 参考章节 |
|---|---|
| 新建模型供应商并获取可用模型 | 4.1 新建并验证供应商 |
| 排查供应商连接失败 | 4.2 可用性探查与连接排查 |
| 调整超时、重试与健康检查参数 | 4.4 编辑供应商与运行参数 |
| 添加上游账号 | 4.5 账号与上游余额 |
| 声明模型的能力用途 | 4.6 模型能力用途与元数据 |
| 核验上游是否提供所声明的模型 | 4.7 上游真实性核验 |
| 测试上游的并发容量与延迟 | 4.8 性能测试 |
| 设置模型售价与阶梯计价 | 5.1 设置模型售价、5.2 阶梯计价 |
| 参照目录价定价或批量填充售价 | 5.3 参照目录模型定价、5.4 按目录价批量填充 |
| 维护模型广场中的模型分类 | 5.5 模型分类 |
| 新建模型服务 | 6.1 新建模型服务 |
| 试跑模型服务并查看失败归因 | 6.5 试跑与失败归因 |
| 为内容安全、敏感信息识别、意图识别等功能指定默认模型 | 6.9 全局设置：默认模型与美元汇率 |
| 设置模型服务的可用范围与有效期 | 7.1 选择授权范围并设置有效期 |
| 设置对象级与服务级配额 | 7.2 配额字段说明、7.3 服务级配额 |
| 为单个 API 密钥设置额度 | 7.5 单个 API 密钥的额度 |
| 处理额度用尽导致的拒绝 | 7.6 配额拒绝排查 |
成员使用与业务系统接入
| 常用任务 | 参考章节 |
|---|---|
| 浏览模型广场并在线试用 | 8.1 浏览模型广场、8.2 在线试用 |
| 获取 API 密钥并发起首次调用 | 8.3 获取 API 密钥并发起首次调用 |
| 撤销本人的 API 密钥 | 8.4 管理本人的 API 密钥 |
| 查看本人用量与调用日志 | 8.5 查看本人用量与调用日志 |
| 为业务系统准备 API 密钥 | 9.2 API 密钥的创建与管理 |
| 轮换、禁用或删除 API 密钥 | 6.7 API 密钥管理、9.3 轮换、禁用和应急处理 |
| 设置能力授权的生效与到期时间 | 9.4 分发能力和设置生效时间 |
| 选择调用认证方式，启用身份源令牌调用 | 9.5 认证方式支持边界 |
| 按调用方计数与限额 | 9.7 调用身份、计数与配额 |
| 定位鉴权失败 | 9.8 鉴权故障定位 |
| 查找 Base URL、鉴权头与接口清单 | 10.1 Base URL 与鉴权、10.2 接口清单 |
| 用 Claude Code、Codex 或 Gemini CLI 调用任意对话模型 | 10.3 协议自动转换 |
| 处理流式输出、重试与心跳 | 10.4 流式输出、重试与心跳 |
| 调用嵌入、重排序、图像、语音与批量判断接口 | 10.5 嵌入与重排序、10.6 图像与语音、10.7 批量判断 |
| 按错误码处理调用失败 | 10.8 错误格式与错误码 |
| 指定会话归属，续接 Responses 对话 | 10.9 会话识别 |
接入工具与外部能力
| 常用任务 | 参考章节 |
|---|---|
| 接入远程 MCP 或把 HTTP 接口生成为 MCP 工具 | 11.1 创建 MCP 服务 |
| 配置 MCP 鉴权与请求头 | 11.2 配置鉴权与请求头 |
| 发布并分发 MCP 服务 | 11.3 发布与分发 |
| 验证 MCP 连接并排查不可用 | 11.4 MCP 连接验证与排查 |
| 限制单个工具的调用 | 11.5 设置工具调用权限 |
| 查看 MCP 调用情况、管理访问令牌 | 11.6 查看调用情况与可用性、11.7 管理访问令牌 与分类 |
| 成员获取 MCP 接入配置 | 11.8 成员在能力中心获取 MCP 接入配置 |
| 在 MCP 客户端中管理网关 | 11.9 通过 MCP 管理网关 |
| 以 API 服务方式开放上游接口 | 11.10 API 服务 |
| 接入、审批外部智能体 | 12.1 接入外部智能体 |
| 配置外部智能体上游凭据与调用方 Token | 12.2 配置上游凭据与调用方 Token |
| 分发外部智能体或发布为 MCP 工具 | 12.3 分发外部智能体与发布为 MCP 工具 |
| 查询外部智能体任务 | 12.4 监控外部智能体与查询任务 |
| 导入、检查并分发技能 | 12.5 导入与分发技能 |
| 导入或导出插件 | 12.6 导入与导出插件 |
| 从 Nacos 同步外部智能体与 MCP Server | 12.7 同步外部注册中心 |
护栏与内容检测
| 常用任务 | 参考章节 |
|---|---|
| 查看内置敏感数据规则 | 13.1 敏感数据页签与内置规则 |
| 新增、导入或导出自定义敏感数据规则 | 13.2 新增、导入与导出自定义规则 |
| 试运行敏感数据检测 | 13.3 试运行 |
| 在流量规则中启用敏感数据检测并设置处置 | 13.4 在流量规则中启用检测与命中处置 |
| 核对脱敏结果与原文证据 | 13.5 脱敏结果与审计 |
| 维护词库、问答与内部系统白名单 | 14.1 维护词库、问答与内部系统白名单 |
| 在流量规则中添加内容检测 | 14.2 在流量规则中添加内容检测 |
| 识别规避写法，检测危险工具调用 | 14.3 规避写法识别与工具调用防护 |
| 设置检测失效处理、拒答话术与流式检测 | 14.4 失效处理、拒答话术与流式输出 |
| 验证内容检测并配置命中通知 | 14.5 上线验证与命中通知 |
| 开启 SSRF 出站防护与 Web 应用防护（平台管理员） | 14.6 SSRF 出站防护与 Web 应用防护 |
路由与流量保护
| 常用任务 | 参考章节 |
|---|---|
| 理解规则的入口、类型与生效顺序 | 15.1 入口与生效顺序 |
| 创建模型路由或增强规则，配置匹配条件 | 15.2 创建规则与配置条件 |
| 用「验证规则」和真实调用验证规则 | 15.3 验证规则与真实调用 |
| 配置全局限额、并发限制与临时豁免 | 15.4 配置全局限额 |
| 配置处置动作、改写与异常处理 | 15.5 处置动作与异常处理 |
| 配置并验证熔断 | 15.6 配置并验证熔断 |
| 配置流量分配与故障转移 | 15.7 流量分配与故障转移 |
| 维护规则、处理校验失败与保存冲突 | 15.8 维护、校验与故障定位 |
| 按意图分流 | 15.9 意图集 |
| 配置语义缓存 | 15.10 语义缓存 |
| 转换请求和响应 | 16.1 请求和响应变换 |
| 安装、绑定和升级网关扩展 | 16.2 安装、配置和绑定网关扩展 |
| 配置插件的请求屏蔽、防重放与并发上限 | 16.3 配置插件网关策略 |
| 获取开放 API 文档 | 16.4 获取开放 API 文档 |
| 完成集成上线检查 | 16.5 集成上线检查 |
用量与成本
| 常用任务 | 参考章节 |
|---|---|
| 管理员查看全租户用量与费用 | 17.2 管理员查看用量与成本 |
| 核对 Token 消耗及其归属 | 18.1 分析 Token 和调用量 |
| 核对调用量、成功率与调用主体 | 18.1 核对调用量、成功率与调用主体 |
| 分析 Token 消耗趋势 | 18.1 分析 Token 消耗趋势 |
| 识别高消耗接入凭据 | 18.2 识别高消耗接入凭据 |
| 分析成本预算与费用尖刺 | 18.3 成本预算和尖刺 |
| 分析可靠性与耗时 | 18.4 分析可靠性与耗时 |
| 分析接入凭据的耗时和调用明细 | 18.4 分析接入凭据的耗时和调用明细 |
| 切换统计范围并导出汇报 | 18.5 切换统计范围与导出 |
| 处理负载与容量异常 | 18.6 处理负载与容量异常 |
观测与排障
| 常用任务 | 参考章节 |
|---|---|
| 按问题选择观测入口 | 19.1 选择入口 |
| 了解观测数据的来源、依赖与安全控制 | 19.2 数据来源与依赖、19.4 数据安全 |
| 把租户指标接入 Prometheus | 19.3 Prometheus 指标抓取 |
| 查询单次网关请求 | 20.1 查询网关请求 |
| 阅读请求详情中的路由、改写与上游尝试 | 20.2 阅读请求详情 |
| 对比客户端请求与上游请求 | 20.2 对比客户端请求与上游请求 |
| 按会话查看多轮调用 | 20.3 查看对话与会话详情 |
| 处理会话诊断问题 | 20.4 处理会话诊断问题 |
| 开启会话评审，查看成员与最佳实践 | 20.4 使用总览、成员、任务场景与最佳实践 |
| 查看路由策略命中 | 20.5 查看路由策略命中 |
| 追踪请求中的治理动作 | 20.5 追踪请求中的治理动作 |
| 查看平台运行状态与出口网络（平台管理员） | 20.6 平台运行状态与出口网络 |
| 按现象确定根因定位顺序 | 20.7 根因定位顺序、第 21 章 · 问题诊断与处理 |
| 定位失败调用 | 21.1 网关请求：定位失败调用 |
| 定位引起问题的配置变更 | 21.2 操作审计：定位配置变更 |
| 追溯 AI 调用与合规决策 | 21.2 追溯 AI 调用与合规决策 |
告警、导出与审计
| 常用任务 | 参考章节 |
|---|---|
| 创建并验证钉钉、飞书、企业微信、Webhook 或邮件渠道 | 22.1 创建通知渠道 |
| 启用内置告警规则，新建网关策略告警 | 22.2 配置告警规则 |
| 配置质量告警与护栏命中通知 | 22.2 配置质量告警与护栏命中通知 |
| 确认、静默、指派或解决告警事件 | 22.3 处置告警事件 |
| 处理通知投递失败 | 22.4 处理投递故障 |
| 了解调用记录与内容的留存 | 22.5 调用记录与内容的留存 |
| 导出调用与用量数据，配置定时导出 | 22.6 导出调用与用量数据 |
| 查询操作审计、校验完整性并导出证据 | 22.7 查询操作审计并导出证据 |
| 处理平台告警，配置平台通知出口（平台管理员） | 22.8 平台管理员的告警目录与通知出口 |
平台运行与维护（平台管理员）
| 常用任务 | 参考章节 |
|---|---|
| 升级平台，启用或停用可选能力 | 23.1 执行系统升级 |
| 备份平台数据 | 23.2 备份平台数据 |
| 恢复备份并演练 | 23.3 恢复和演练 |
| 日常巡检与查看服务日志 | 23.4 日常巡检与服务日志 |
| 调整过载阈值与数据库连接上限 | 23.5 运行参数边界 |
| 修改部署配置、入口端口与绑定网卡 | 23.6 维护部署配置与入口监听 |
| 添加并维护远端网关节点 | 23.7 管理网关节点 |
| 创建租户，设置租户配额 | 23.8 管理租户 |
| 发布通知横幅，设置品牌与 SMTP | 23.9 授权许可、通知横幅、品牌与 SMTP 配置 |
| 变更公开访问地址与入口证书 | 24.8 变更访问地址与入口证书 |
日常维护与变更
| 常用任务 | 参考章节 |
|---|---|
| 维护管理角色、平台账号与登录会话 | 24.1 维护管理角色、平台账号与登录会话 |
| 同步组织、维护部门并管理成员会话 | 24.1 同步组织、维护部门并管理成员会话 |
| 维护模型供应商 | 24.2 维护模型供应商 |
| 维护模型服务 | 24.3 维护模型服务 |
| 维护 MCP 服务 | 24.4 维护 MCP 服务 |
| 维护外部智能体服务 | 24.5 维护外部智能体服务 |
| 核对配置变更 | 24.6 核对配置变更 |
| 接入新的模型与外部能力 | 24.7 接入新的模型与外部能力 |
上线与交接
| 常用任务 | 参考章节 |
|---|---|
| 按试点范围分阶段上线 | 第 25 章 · 分阶段上线 |
| 完成上线前检查 | 26.1 完成上线前检查 |
| 查看平台负载并处理容量问题 | 26.2 查看平台负载并处理容量问题 |
| 配置和检查平台安全控制 | 26.3 配置和检查平台安全控制 |
| 完成平台管理交接 | 26.4 完成平台管理交接 |
| 提交支持请求 | 26.5 提交支持请求、第 27 章 · 联系支持所需信息 |