接入模型网关

检查现有配置

先检查“模型与服务”中的当前服务与模型。如果组织已经下发连接说明，使用该配置完成验证，避免在同一设备添加相互冲突的服务。Lime 当前模型认证以 API Key Provider 和已配置服务为准。

向网关负责人获取信息

• 完整 HTTPS Base URL 和相应 API 协议。
• 允许的模型标识、别名和能力说明。
• 凭据发放、权限、有效期、轮换和撤销方式。
• 组织代理、证书与网络要求。
• 支持的流式响应、工具调用、多模态、上下文与限额。

配置服务和模型目录

在 Lime 的模型与服务设置中选择与网关真实协议一致的服务类型，填写管理员提供的 Base URL，并通过专用凭据入口保存密钥。选择经过验证的模型，检查能力与就绪状态。

网关兼容某种 wire format，不代表它具备该上游的全部能力。自定义模型别名需要匹配的能力信息；不要仅因名称接近就套用内置元数据。

保护认证与请求路由

网关凭据与 Lime Cloud 登录、MCP 和第三方工具授权分别管理。不要复制其他产品的 OAuth 表、双令牌转发或用户账号请求头；当前客户端不通过已退役的 OAuth 凭据池连接模型。

• 网关先验证调用方权限，再选择目标路由。
• 不将网关凭据转发给无关上游，日志中隐藏认证信息与敏感正文。
• 使用独立测试凭据验证权限不足、过期和撤销。
• 必要的自定义请求头仅按当前客户端和网关共同支持的配置使用。

启动并验证连接

• 保存连接后，确认运行进程使用新配置和正确凭据。
• 在新任务中发送最小文本请求，检查成功响应。
• 由网关负责人核对请求时间、身份、模型别名和真实上游路由。
• 继续测试流式结束、下一轮消息、工具调用和任务取消。
• 模型连接通过后，再分别验证 MCP、浏览器等其他数据出口。

请只回复：gateway-ok

一条 gateway-ok 回复证明本次响应完成，不能单独证明所走的模型或网络路由。

按失败层排查

求助时提供版本、系统、服务 ID、模型、失败时间与脱敏错误。不要发送令牌、Cookie、完整凭据文件或敏感提示词。