配置模型路由与回复审阅

在 范围设置 → Agent 设置 里，每个范围有三项配置：

• Engine 与模型：ZAI 用哪种 Engine 工作、用哪个模型（Model）。在每个 Session 开始时确定。
• 模型上游：请求发往哪个服务地址、使用哪份凭证、是否经过网络隧道。每次请求都按当时的配置生效。
• 回复审阅：ZAI 在聊天里发消息前，是否先由审阅模型检查。每条消息都按当时的配置生效。

三项配置各自继承、分别保存：可以只覆盖模型而沿用上层的模型上游，也可以只更换模型上游而不改 Engine 与模型。

谁可以做：组织 Owner 和 Admin 在 组织管理 → 范围设置 为整个组织、Workspace 或 Channel 设置。成员在 我的资源 → 范围设置 里为自己的私信设置，见在控制台管理自己的资源。在频道或群聊里发送 @zai !engine、@zai !model，或在私信里发送这两个命令，修改的是所在范围的同一份配置，见命令速查。

选择范围

范围设置分两个层级：

• 组织管理 → 范围设置：左栏逐层选择。顶层是 整个组织 和各个 Workspace，进入 Workspace 后可以选中这个 Workspace 或其中的 Channel（控制台对频道或群聊的叫法）。
• 我的资源 → 范围设置：固定是本人的 个人范围，不需要选择。

选中范围后，右侧的 Agent 设置 分区就是这三项配置，逐段从上到下排开。

每个范围从近到远按下面的顺序取值，直到找到一层设置过的值：

每一项顶部都有一行 当前生效，写明这个范围实际使用的值和它来自哪一层，并标注 继承 或 此处覆盖；来源名称可以点击，跳到那个范围。

每条私信按它所在的 Workspace 取值。同一位成员在多个 Workspace 都有私信、而这些 Workspace 取到的值不同时，我的资源 里这一项显示 随一对一聊天所在的 Workspace 而定，不给出单一来源，各条私信仍分别使用所在 Workspace 的配置；取到的值都相同时照常显示这个值和来源。成员在 个人范围 上设置后，他的所有私信都使用这个值。

这个取值顺序只用于模型路由：私信不会因此用上组织的连接器、远程设备、插件或其他资源，这些资源仍按各自的授权规则生效，见能力在哪里生效。

设置 Engine 与模型

1. 在左栏选择范围。
2. 在 Engine 与模型 中选择 Engine 卡片：Claude（Claude Code）或 Codex（OpenAI Codex）。显示为灰色的其他卡片不能选择。
3. 在 Model ID 中直接填写模型服务识别的完整名称；或者点 从常用模型中选择，搜索厂商或模型名称后选中，界面会填好对应的 Model ID。搜索词没有匹配时，可以选 用 “<输入>” 作为 Model ID 直接采用输入的内容。填好后仍可以修改。
4. 点 保存 Engine 与模型；没有改动时按钮保持禁用。
5. 在新的消息列里发一条消息验证。

Engine 与模型在每个 Session 开始时确定：新开的消息列使用新配置；已有的消息列在它的 Session 结束前继续使用原来的配置，结束后再在原处继续才换成新配置。Session 何时结束，见ZAI 会记住一个消息列多久。ZAI 回复命令时说的「配置将在新 Session 生效」就是这个意思。

常用模型目录只是快捷填写的入口，模型服务支持的其他名称同样可以直接填写。切换 Engine 不会更换已填写的 Model ID，也不会修改模型上游。Z Tag 只保存并传递模型名称，不检查它是否存在，也不检查它与 Engine 或模型上游是否匹配；名称错误或服务不支持时，请求会由对应的 Engine 或模型服务报错。

在整个组织或 Workspace 上点 恢复继承 时，会先弹出确认框，说明恢复后将使用上一层的哪个 Engine 与模型，或由系统默认决定。有未保存的修改时切换范围或离开页面，会先询问是否放弃修改。

设置回复审阅

ZAI 在聊天里发出一条消息前，审阅模型会读最近的消息和这条草稿，判断它该不该发、写法有没有明显问题，以及有没有用错回复语言。审阅只看写法、语言和该不该发，不判断事实：已经说过的内容、只播报进度的消息和单独一句「收到」不会发出；用户明确要求的格式、篇幅、语言和内容优先，未完成事项、数据口径和限制不会被要求删掉。没有人请求的免确认介入标准更严：只有对眼前的讨论有直接帮助时才发出。

1. 在左栏选择范围。
2. 在 回复审阅 的 此处使用 中选择模式：
   • 发送前审阅：消息发出前审阅；写法有明显问题或与消息列里已有内容重复时，退回 ZAI 改写或不再发送。退回次数有上限，到上限后 ZAI 改写的版本不再审阅，直接发出。
   • 只记录：消息直接发出，结果只做记录，用于观察审阅效果。
   • 关闭：不审阅。
   • 继承：沿用上层范围的模式；各层都没有设置时使用系统默认的模式，以页面上的 当前生效 为准。
3. 点 应用到此范围。

审阅模型使用这个范围当前生效的模型上游：没有绑定自定义上游时使用 Z Tag 提供的审阅模型，绑定了自定义上游时使用这个 Session 正在使用的模型，用量计入同一个范围。Z Tag 没有提供审阅服务或审阅暂时不可用时，无论选哪种模式，消息都照常直接发出。定时任务与事件任务的汇报默认只在有变化或异常时发出：只说明「一切照常」的汇报会被判为不必发；任务里写明每次都要汇报、要发的本来就是提醒或通知，或者是手动运行的结果时，照常发出。ZAI 知道每条消息是否经过审阅、审阅是否出错，想确认时直接问它。

创建和应用模型上游

模型上游 一段分为两部分：上方的 此处使用 决定当前范围用哪个上游，下方的 模型上游 列表是全部上游的目录（名称、地址、凭证方式、网络路径、范围数）。

1. 在 Agent 设置 的 模型上游 一段点列表标题行的 新建上游。
2. 选择服务商卡片，也可以在 搜索模型服务商 里按名称查找。卡片分三组：国内 MaaS 服务商（阿里云百炼、火山方舟、硅基流动、腾讯 TokenHub、百度千帆）、模型网关（New API）和 模型官方服务（智谱、DeepSeek、Kimi、MiniMax、OpenAI、Anthropic）。都不合适时点 其他服务商（自行填写）。服务商预设会填好名称、Base URL 和凭证类型，填写后仍可以修改。
3. 在 协议快填 中选择 OpenAI 或 Anthropic，界面会填好这个服务商对应的地址与认证方式。按这个范围使用的 Engine 选：
   • Claude 需要 Anthropic Messages 兼容接口；
   • Codex 需要 OpenAI Responses 接口。只提供 Chat Completions 的服务不能用于 Codex。
4. 填写 API Key。需要自定义请求头或网络隧道时，展开 高级配置。自定义请求头名称的限制与自定义请求头相同。
5. 点 创建。新上游会自动填入 此处使用 并提示“尚未应用到此范围”；点 应用到此范围 才会对这个范围生效。选择 继承 再应用，则恢复继承：沿用上层范围的模型上游，各层都没有绑定时使用系统默认上游。

Base URL 填到 /v1 之前的部分，Engine 会在后面接上自己的接口路径。上游提供的接口与 Engine 不匹配时，请求由 Engine 报错，Z Tag 不会提前检查。Base URL 默认必须是 https 地址，不能带查询参数；只有在 高级配置 中开启 允许明文 HTTP 后才能填写 http 地址，此时凭证以明文发往这个地址（经过网络隧道时是隧道到目标服务这一段）。没有开启就填写 http 地址时，保存会提示“请检查字段内容后重试”。只在目标明确要求时开启。

New API 需要填写你们自己的服务地址；它的 OpenAI 与 Anthropic 入口共用同一个 Base URL，切换协议不会清空或替换已填写的地址。协议选项只在创建时用来快填，最终保存的是表单里显示的那一份配置。关闭编辑器后，需要重新填写未保存的凭证。

凭证保存后不再显示：详情和后续编辑中都看不到它。编辑时凭证留空会保留原值，填写新值则替换原值。列表每行的菜单提供 编辑 和 删除；删除会从所有引用它的范围移除这个上游，确认框会说明受影响的范围数，并要求输入上游名称后才能提交。

没有自定义绑定时才使用系统默认上游。选中自定义上游后，如果地址不可达、凭证失效或网络隧道离线，请求会失败，不会悄悄改用系统默认上游。

经过网络隧道

模型上游可以在 高级配置 的 网络路径 中直接选择网络隧道，不需要在沙箱配置里再为同一个模型服务创建内网路由。网络隧道只负责把已授权的请求送进目标网络；请求的目标仍然是上游自己填写的协议、主机和端口。

隧道离线、被撤销、成员失去引用权或隧道凭证过期时，Z Tag 会拒绝新的请求，不改走直接连接。使用 HTTPS 时，目标名称和证书仍按 Base URL 中的主机名校验。成员在自己的模型上游里引用组织的网络隧道，需要先获得这条隧道的引用权，见成员授权与审批。