文档开始使用
连接模型与企业网关
企业统一接入模型，成员登录后自动获得可用模型、积分额度和运行配置。
澄宇AI工作台不在成员侧配置个人模型密钥。企业管理员在后台接入模型渠道、设置可用模型和积分倍率，成员登录后由客户端自动拉取运行配置。
企业侧如何接入
Section titled “企业侧如何接入”| 步骤 | 操作者 | 说明 |
|---|---|---|
| 1. 配置模型渠道 | 平台运营 | 在平台后台接入模型 Provider、网关渠道和可用模型。 |
| 2. 分配企业模型 | 企业管理员 | 在企业后台勾选该企业可用的模型，设置模型倍率或分组。 |
| 3. 分配成员额度 | 企业管理员 | 给成员或岗位分配每月积分；额度按月重置，也可以发放临时积分包。 |
| 4. 下发运行配置 | 系统 | 成员登录或刷新配置时，客户端获得网关地址、模型列表和积分信息。 |
具体操作见模型、积分与计费。
成员侧看到什么
Section titled “成员侧看到什么”登录后，模型菜单只显示企业已授权的模型。切换模型不会改变企业额度规则；不同模型可能按不同倍率消耗积分。
- 模型选择：在任务输入框上方切换。任务执行中切换模型，只影响后续轮次，不会重写已经产生的上下文。
- 推理强度：部分模型支持调节推理强度。强度越高，复杂任务的质量和耗时通常越高，积分消耗也可能增加。
- 额度提示：输入框附近显示本月积分或剩余额度。额度不足时，客户端会阻止新的模型请求，并提示联系管理员。
- 不可用状态：模型被管理员停用、网关不可达或企业额度用尽时，模型会显示为不可用，而不是静默失败。
不需要个人密钥
Section titled “不需要个人密钥”企业版的模型请求统一经过企业网关。成员不需要：
- 注册 Z.ai、BigModel 或其他模型厂商账号；
- 在设置里填写个人 API Key；
- 把密钥写进
.env、项目配置或对话内容。
如果企业允许在特定场景使用个人密钥，应由管理员明确授权并单独配置；不要把个人密钥用于企业数据。
模型请求、MCP 服务和 Agent 执行的网络工具都会经过客户端的网络配置。企业网络需要代理时：
- 打开 设置 → 常规。
- 填写 HTTP 代理，例如
http://127.0.0.1:7890。 - 如有内网域名，填写代理例外，例如
localhost,127.0.0.1,.corp.example.com。 - 企业安全网关使用自签根证书时，填写 PEM 根证书路径。
- 重启客户端生效。
| 状态 | 含义 | 处理 |
|---|---|---|
| 模型列表为空 | 企业尚未分配模型，或运行配置未刷新 | 联系管理员分配模型；退出重登或刷新配置 |
| 模型显示不可用 | 渠道故障、模型停用或额度不足 | 切换其他已授权模型；联系管理员检查网关和额度 |
| 请求返回 401/403 | 登录态失效或成员被停用 | 重新登录；确认账号状态 |
| 请求超时 | 网络、代理或网关拥塞 | 检查代理与证书；换模型重试；联系管理员查看网关 |
| 积分扣减异常 | 模型倍率或分组配置不符 | 让管理员核对模型倍率与成员分组 |
- 企业网关只接受企业签发的成员令牌，成员身份从会话中读取，不信任请求参数。
- 客户端不保存明文网关令牌，使用系统钥匙串。
- 模型调用日志和用量聚合由企业侧管理；管理员可以在后台查看调用与积分消耗。
- 对话内容可能包含代码、文件和业务数据。发送前确认数据范围，不要把生产密钥、客户隐私或未脱敏数据粘贴进对话。