连接故障排查
Agent 提示模型连接失败，应该按什么顺序排查？
按 Agent 配置、模型连接、凭据权限和上游服务逐层定位失败原因。
由 路墨 Lumoswitch 产品团队维护
简要回答
先确认实际使用的配置文件和模型 ID，再检查 Key、服务商状态、限额和调用记录。
第一步检查哪些客户端设置？
确认 Agent 已重开，并且运行的是你刚配置的安装项和用户目录；再核对当前模型 ID、协议和连接路径。项目配置或环境变量可能覆盖用户级设置。若使用本机 LiteLLM，确认 Lumoswitch 正在运行；在线连接则确认账号状态正常。
接下来如何检查凭据和服务商？
确认对应 Key 仍有效，所选模型已获供应商授权，端点和协议匹配；本机连接还要检查本机服务运行状态。查看供应商侧余额、速率限制和服务状态。不要通过把密钥贴到终端命令、截图或聊天来测试。
怎样给支持团队提供线索？
记录失败时间、Agent、模型 ID、连接类型、脱敏后的错误码和客户端版本。平台调用可以查看对应请求状态、模型、用量或路由记录；外部 Agent 的本机历史日志和 Lumoswitch 平台账单不是同一数据源。提交支持请求前移除 Key、提示词正文和个人信息。