LightVela

模型切换

摘要

在当前 Bot 的「管理 → 模型」中,可从已配置模型选择一个主模型,并将其他模型设为备用或仅保留配置。切换主模型后,应核对页面标记、检测模型状态,再通过网页对话确认回复;切换模型不会清除 Bot 的记忆。

开始前

  1. 登录 LightVela,在管理台选择目标 Bot。
  2. 打开「管理 → 模型」,确认目标模型已添加、凭证有效且有可用额度;未配置时先按配置模型添加。
  3. 准备一条简短测试消息。

切换主模型

  1. 展开目标模型所属的已配置服务商。
  2. 在目标模型行点击 设为主模型。
  3. 等待操作完成,核对该模型显示为主模型;已经是主模型时,按钮显示 已是主模型。
  4. 按需点击 检测模型状态,再到当前 Bot 的网页对话发送测试消息。

若服务商下还未添加目标模型,可在该服务商展开区域选择其他模型并保存,再设为主模型。不要只在下拉中选中模型就认为已经保存。

与定时任务的关联

切换时若出现「定时任务更新提示」,先核对受影响任务,再选择「同步更新定时任务」「仅切换对话模型」或「取消切换」。仅切换对话模型不会同时改动这些任务的模型绑定;切换后应检查任务使用的模型与后续执行结果。无法确认绑定的任务不会被本次同步修改。

备用模型与仅添加

添加模型时可选择「设为主模型」「设为备用模型」或「仅添加」。已配置的模型行也可设置备用或 取消备用。主模型不能同时设为备用模型。

一个 Bot 可配置多个备用模型。配置为备用不等于每条消息同时调用这些模型;实际执行结果以对话和运行状态为准。

确认结果

先核对模型页上的主模型标记,再发送简短测试消息,例如「请用一句话回答:连接测试成功」。确认回复正常;不要仅依靠模型自报的名称判断实际生效配置。

切换失败怎么办

现象处理
列表没有目标模型先添加模型;支持在线获取时刷新可用模型列表,再保存
主模型按钮不可用检查是否已是主模型,或是否仍有配置操作进行中
检测返回 401核对服务商、Key、协议和端点是否匹配
保存状态不明确刷新后核对主模型及备用标记,再决定是否重试
对话仍无回复核对当前 Bot、额度及连接状态,再到诊断中心排查

需要恢复原先的主模型时,在原模型行再次点击 设为主模型 并验证。若要删除模型,请先阅读确认提示;删除服务商下最后一个模型时会同时移除该服务商配置。

最后更新于 2026-10-19