模型服务与默认模型

本文要完成什么

把一个模型服务接入 Nexus，选定可用模型，再完成一次包含文件操作的任务。整个过程分为保存服务、添加模型、分配用途和验证任务四步。每一步都有自己的检查结果，前一步成功不等于后面全部可用。

如果管理员已经提供共享模型，先在模型列表中检查可用项。能选择模型但不能编辑服务时，向管理员确认配置，不必再创建同名服务。

Nexus 登录账号与模型服务账号分开管理。网页聊天订阅也不等于已经取得 API 凭据。不要把登录密码、网页地址或模型的宣传名称填入上述字段。

Web 版由服务器调用模型。若模型只在你电脑的回环地址监听，服务器无法用自己的 localhost 访问它。先明确服务运行在哪台机器，再决定地址。

进入 设置 → 供应商，选择对应服务。预设已经提供固定端点时，沿用预设地址；使用自建网关或兼容服务时，按服务文档填写自定义配置。

按接口格式选择，不按模型品牌猜测。一个网关可能同时提供多种协议，每种协议的基础地址或模型列表路径也可能不同。

示例中的地址仅用于说明字段对应关系，不能直接调用。

显示名称    团队测试网关
接口协议    Chat Completions
基础地址    https://models.example.com/v1
模型 ID     由这个网关实际提供的模型名称

保存后重新打开服务，核对地址、协议和启用状态。令牌不回显是正常的。只修改显示名称时，不需要把旧令牌重新填一遍。

服务提供模型发现接口时，可以同步模型列表。没有列出目标模型时，先确认该账号是否有权限使用，再用 添加模型 填写准确的 Model ID。手动添加窗口可选择添加后是否启用。

同步列表与手动添加解决的是“有哪些模型”。在列表中看到条目，仍需进行模型调用测试。若列表接口失败而服务支持手动指定模型，可以先按提供方给出的 ID 添加，再验证调用，不要反复修改聊天地址来修复模型发现接口。

模型设置中可以调整能力标记、上下文长度、最大输出长度和服务参数。

自动识别结果不正确时才覆盖能力，数值依据提供方说明。填写更大的上下文值不会增加服务真实容量。服务参数没有特殊要求时保留空对象，不照搬其他提供方的参数。

在 设置 → 常规 中配置默认对话、生图、视觉理解和后台任务模型。先让对话模型工作，再配置需要的其他用途。

普通 Agent 可以指定自己的模型，会话也可能有明确选择。更改全局默认后，检查实际会话显示的模型，在下一轮验证。不要用正在执行的一轮判断新配置是否生效。

在当前工作区创建 model-check.md，写入一行“模型与工具验证通过”。
再读取该文件，回复实际读到的内容和文件位置。

若任务等待审批，按卡片核对文件名后允许本次。打开生成文件，确认存在且内容正确。服务测试和任务都可能产生模型费用。

先看服务被哪些 Agent 使用，再检查默认模型和定时任务。替换服务时，先验证新服务，再迁移使用者。删除条目不能解决旧任务里的错误模型选择。

出现保存结果待确认时，先刷新读取状态。保存成功但测试失败，通常不意味着配置自动回滚。按模型排错确定失败阶段后，每次只改一个因素。