模型设置

后台位置：AI 智能助手 › 模型设置

功能简介

供应商是提供大模型接口的公司，模型是某家供应商下具体的一个模型。本页预置了六家供应商——「DeepSeek」「Moonshot」「Qwen」「Zhipu」「MiniMax」「OpenCode Go」，不能增删；管理员为要用的供应商填写密钥、接口地址、接口格式和可用模型列表并打开开关，然后从已开启供应商的模型里选一个「默认模型」。默认模型是前台 AI 助手对话和 AI 自动填充默认使用的模型，某个 Agent 也可以在「用户与 Agent」里单独指定自己的模型。这些设置全部保存在易客 CRM 智能体的 AI 引擎上（控制面板里叫它「实例」，在「AI 实例设置」页管理），CRM 本身不存密钥，页面也从不回显已保存的密钥。

页面概览

模型设置页面概览，顶部是默认模型下拉，左侧六家供应商列表，右侧是 DeepSeek 的设置面板

  • 「默认模型」栏：一个按供应商分组的下拉、「保存」按钮，以及「当前：供应商/模型」（未设置时显示「未设置」）。
  • 「模型提供商」列表：六家供应商各一行，名称下方可能有「已配置 key」或「已配置 N 把 key」标记，行尾是启用开关；点击某一行，右侧面板切换到它。
  • 设置面板：标题为「某某 设置」，包含「API Key」「API Base URL」「API 格式」「可用模型列表」四项，列表下方是「模型 id（如 deepseek-chat）」「显示名（可选）」两个输入框和「+ 添加模型」按钮，底部是「测试连接」「保存」。标题下方一行小字用来提示该供应商需要密钥，当前版本只显示了首字母（如「需要 D」）。
  • 提示条：保存后显示「✓ 已保存」或「✕ 保存失败，请检查填写内容后重试」；实例不可达时整页只显示「服务不可达：原因」。

操作步骤

配置一家供应商

  1. 在「模型提供商」列表点击要配置的供应商，右侧标题变成「某某 设置」，「API Base URL」「API 格式」「可用模型列表」回填该供应商已保存的值，「API Key」始终为空。
  2. 在「API Key」粘贴从供应商处申请的密钥；有多把密钥时一行一把。修改已有配置而不换密钥时留空即可。
  3. 按需修改「API Base URL」：默认是该供应商对应格式的官方地址；切换「API 格式」时，如果地址仍是另一种格式的默认值，会自动换成新格式的默认地址，自己改过的地址不会被覆盖。
  4. 整理「可用模型列表」：点击某一行把它设为该供应商的当前模型，点击行尾「×」删除，填写「模型 id」（显示名可选）后点击「+ 添加模型」或按回车追加一行；id 只能包含字母、数字和 . - _ /，重复添加时提示「该模型已在列表中。」。
  5. 点击「测试连接」，按钮旁先显示「测试中…」，随后显示「✓ 连接成功」或「✕ 失败原因」。测试用的是面板里当前填写的内容（包括还没保存的密钥）和列表里选中的模型，不会保存任何东西。
  6. 打开列表里该供应商行尾的开关。
  7. 点击「保存」，页面刷新并显示「✓ 已保存」，仍停留在这家供应商上。

保存会把密钥、地址、格式、开关和整份模型列表一起写入实例；列表被清空时保存后恢复为预置模型。保存供应商不会改动「默认模型」。

MiniMax 设置面板，API Key 已填入示例值，列表里选中 MiniMax-M3

选择默认模型

  1. 在「默认模型」下拉里选一个模型，下拉只列出已开启供应商的模型，按供应商分组。
  2. 点击旁边的「保存」，页面刷新，「当前：」显示为「供应商/模型」。

默认模型保存后，新开的 AI 助手对话和之后执行的 AI 自动填充任务立即改用新模型，已经进行中的对话不受影响；不需要到「设置中心」清除缓存，也不需要重新登录。

字段与选项说明

字段 含义 备注
「默认模型」 全局默认使用的模型，形如「供应商/模型 id」 只能选系统内置清单里的模型，见「注意事项」
启用开关 该供应商是否参与使用；关闭后它的模型不再出现在「默认模型」和 Agent 的模型下拉里 开关状态随该供应商的「保存」一起写入
「API Key」 供应商密钥，一行一把 只写入不回显，留空表示保留现有密钥
「API Base URL」 供应商接口地址 留空时保存为当前格式的默认地址
「API 格式」 「Anthropic 兼容」或「OpenAI 兼容」，按供应商接口支持的协议选 六家的预置默认值：「OpenCode Go」为 OpenAI 兼容，其余为 Anthropic 兼容
「可用模型列表」 该供应商可选的模型，每行是显示名和模型 id 选中的一行是「测试连接」使用的模型；最多 100 个
「模型 id」「显示名」 追加模型时填写的接口模型名和列表里显示的名字 显示名留空时用 id
「已配置 key」 列表里的标记，表示该供应商已保存密钥 多把时显示「已配置 N 把 key」

注意事项

  • 「默认模型」只接受系统内置清单里的模型：不在清单里的模型（含系统按最新目录自动带出的和自己用「+ 添加模型」加的）虽然出现在「默认模型」下拉里，选中后保存会提示「✕ 保存失败，请检查填写内容后重试」；这类模型可以在「用户与 Agent」里给单个 Agent 作为自定义模型使用。
  • 配置了多把密钥时，AI 引擎每次请求随机取一把分摊用量，某把密钥认证失败或欠费时会被自动冷却 5 分钟后再试。
  • 关闭一家供应商后，如果「默认模型」原本属于它，「当前：」仍显示旧值但下拉里已找不到，需要重新选一个并保存。
  • 「OpenCode Go」是需要单独订阅并填写密钥的服务，页面说明「国内 5 家 + OpenCode Go（独立订阅，需 key）」指的就是这一点；六家之外的供应商无法添加。
  • 「测试连接」通过 AI 引擎向供应商发起一次真实请求，连接成功与否以供应商的回应为准。
← 返回手册目录