模型服务与默认模型

准备模型服务账号

模型服务（Provider）接收模型请求并返回结果。你需要该服务的访问地址、API Key，以及账号允许使用的模型 ID。Nexus 的登录账号与模型服务的计费账号独立，服务端管理员也可能已经配置可用的公共 Provider。

添加并测试

1. 打开 设置 → 供应商，选择服务或添加配置。
2. 按页面字段填写协议、服务地址和凭据。兼容接口应按服务文档选择协议。
3. 保存后点击 测试服务，检查连接结果。
4. 使用 添加模型 填写服务支持的模型 ID，并启用模型。
5. 对模型执行测试，再把它分配给默认用途或 Agent。

测试可能产生模型调用和相应费用。服务连接和模型调用分别测试；模型调用还受账号权限、额度和模型能力影响。

分配默认模型

桌面版实图。模型名称和开关反映采集环境，不代表安装默认值。

在 设置 → 常规 中配置各用途。没有使用相应功能时，可以先只配置对话模型。

用途	生效场景
默认对话模型	未显式选择模型的 Agent，以及 Nexus 主智能体
默认生图模型	图片生成未指定模型服务时
视觉理解模型	主模型无法看图且任务需要视觉细节时
后台任务模型	标题、摘要等基础任务优先使用

专职 Agent 可以指定自己的模型，也可以跟随默认值。默认模型更改后，在下一轮任务中验证；正在执行的请求可能仍使用原模型。

服务地址与模型 ID

按照服务提供方的接口说明填写地址，避免重复添加 /v1 或把完整聊天接口路径当作基础地址。模型 ID 应与服务端实际名称一致，展示名称相似不代表可互换。

如果服务支持普通文本但不支持工具调用，连接测试通过后仍可能无法执行 Agent 任务。选模型时同时核对工具、图像与所选运行引擎的兼容性。

失败时按顺序检查

现象	先检查
401 或认证失败	Key 是否正确、过期或属于其他服务
403 或模型不可用	账号授权、模型范围和组织限制
404	Base URL、接口协议与模型 ID
429	服务额度、限流和并发请求
超时或连接失败	运行机器的网络、代理、DNS 和服务状态
工具任务失败	模型能力、协议与运行引擎支持情况

这些是诊断方向，具体原因以该服务的错误正文为准。Web 版应检查服务器的出站网络；你电脑能打开服务网站不代表服务器可以调用 API。

保存结果不确定

页面提示已保存但测试失败时，配置不会因为测试失败自动回退。提示结果待确认时，先加载最新状态，再决定是否修改；核对已有条目后再修改。后续配置见运行与偏好。