模型与服务

连接模型服务，确认实际请求可用，再设置默认模型和按难度切换。连接可达、模型出现在列表中、任务能够完成，是三个需要分别验证的结果。

先选择连接方式

打开设置 > AI 服务，按你已有的账号或接口选择服务。

使用本地模型服务器时，如果它提供兼容接口，可以按自定义接口配置。先确认服务器已经启动，且 EvoX 所在设备能够访问它。

一个提供方可以有多个连接实例。为日常账号、测试接口等实例起不同名称，修改前核对当前实例，避免覆盖另一套配置。

建立第一个可用连接

1. 在 AI 服务中打开目标服务或连接实例。
2. 按该服务入口完成登录，或填写专用凭证字段。
3. 使用自定义接口时，按下面的说明填写基础地址和兼容格式，再执行“测试并保存”。
4. 查看连接状态和可用模型列表。列表过期或读取失败时，先刷新并处理错误。
5. 回到会话选择模型；有多个账号时，同时核对连接实例。
6. 发送一条简短请求，确认真实回复正常。

可以使用：

用三句话解释项目规则、记忆和技能分别解决什么问题。

得到正常回复后，再验证工作需要的其他能力。普通文字请求成功，不代表图片输入、工具调用或长任务都已经可用。

配置自定义接口

填写地址与兼容格式

基础地址填写服务方提供的 API 基础地址，不是官网首页，也不是模型的展示页面。是否需要包含 /v1 等路径，要依据该服务的接入说明；不要凭其他服务的例子增删路径。

在自定义接口的高级配置中选择协议：

OpenAI 格式另有 Responses 与 Chat Completions 的选择。接口只支持 Chat Completions 时，不要因为模型较新就开启 Responses；选择依据是服务实际支持的协议，不是模型名称。

**配置示例：**假设服务方给出了基础地址 https://api.example.com/v1、OpenAI Chat Completions 兼容说明，以及模型 ID example-chat。填写该基础地址和 API Key，选择 OpenAI 格式并关闭 Responses，测试并保存后检查模型列表。这里的地址和模型 ID 仅为示例，应替换为你的服务方提供的值。

确认可用模型

连接保存后检查模型列表。若自定义服务没有列出模型，但服务方确认某个模型 ID 可用，可以使用手动添加入口，填写准确的模型 ID。

模型 ID 与展示名称可能不同；从服务说明或控制台复制 ID，不要把昵称填进去。手动添加只是把该 ID 加入可选列表，不会为账号开通模型权限。模型已列出，也不保证实际调用一定成功。

高级配置中的上下文窗口与图片输入选项应与服务能力一致。增大声明值或开启图片输入，不会让不支持的服务获得这些能力。需要处理图片时，再做一次图片输入测试；需要工具时，再做一次范围明确的工具任务。

设置默认模型

进入设置 > 模型策略，先设一个日常可用的默认模型。默认模型是新会话的基础选择；在会话里切换模型也会更新保存的全局默认，因此它并不只是当前会话的一次性选择。

默认模型与按难度切换的默认档位不同：前者选具体模型与账号，后者选路由档位。

飞书、微信等消息渠道另有默认模型设置。使用这些渠道时，检查消息渠道的选择，并从对应渠道发一条简短请求，不能只凭桌面会话成功判断渠道配置完成。旧版本提示需要更新时，先处理更新要求。

按任务难度分配模型

只使用一个模型时，可以先保持按难度切换关闭。需要兼顾成本、速度和复杂任务能力时，再启用它。

1. 先确认准备分配的模型都能实际回复。
2. 开启按难度切换，为低成本、均衡、高性能三个档位指定模型。
3. 选择默认档位。
4. 为长对话摘要选择一个档位；摘要时使用该档位对应的模型。
5. 设置自动保存；检查保存与配置错误提示，再用下一个新会话验证，路由变更在新会话生效。

档位本身不会改变服务商价格，也不会自动购买更高等级的服务。启用后，默认档位、摘要档位与各档位模型才会出现在路由配置中。

如果模型指定项显示由组织管理，按面板说明处理；本机无法用另一连接绕过组织设置。

配置联网搜索

进入 AI 服务 > 联网搜索。这里选择的是检索通道，与模型连接和 MCP 连接分别管理。

选中通道，保存所需凭证，再发起一次需要检索的请求，例如：

搜索最近一周与这个主题有关的公开资料，列出来源链接和发布日期。

检查是否实际发生检索，以及结果是否包含可核对的来源。只有看起来像链接的回答，不能证明搜索已成功；通道显示未就绪时，先处理凭证或连接问题。

查看用量与费用

打开用量页选择时间范围，检查调用情况；编码模式中的 /cost 也可进入。价格配置用于估算费用，统计金额不能替代服务商账单。

模型 API、订阅账号和联网搜索可能有各自的计费方式。分别检查对应服务的额度与账单，不要把某一页的估算视作所有外部服务的总费用。

排查连接与模型问题

遇到持续连接问题，见网络与连接排查；工具执行的授权问题见权限与审批。