算力猫
← 返回教程列表

接入软件

MaxKB

在 MaxKB 里以 OpenAI 供应商添加模型,API 域名填我们的地址。

约 5 分钟适合:自己部署 MaxKB 知识库问答的管理员

开始之前

  • MaxKB 管理员账号
  • 一把 Key 和一个模型名

步骤 1 · STEP 0x01

选 OpenAI 供应商并添加模型

模型 → 供应商 OpenAI
1

供应商

OpenAI
2
添加模型
示意图,以软件当前版本界面为准

进入模型管理,左侧选「全部模型」后选择供应商 OpenAI,点「添加模型」。MaxKB 没有单独的「OpenAI 兼容」供应商,官方文档就是用 OpenAI 供应商 + 反向代理地址来接第三方的。

去创建 Key →

步骤 2 · STEP 0x02

填写模型信息

添加模型
1

模型名称

随便取(MaxKB 内显示用)
2

模型类型

大语言模型
3

基础模型

<模型名>(支持自定义输入)
4

API 域名

https://api.suanlimao.shop/v1
5

API Key

<你的 Key>
6
添加
示意图,以软件当前版本界面为准
  • 「基础模型」下拉里是常用名字,支持自定义输入:直接粘贴从模型广场复制的名字。官方提醒它必须与服务端支持的名字一致,否则无法通过校验。
  • 「API 域名」填 https://api.suanlimao.shop/v1——官方原话:国内代理的 API 域名格式一般是「反向代理地址/v1」。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。

打开模型广场 →

步骤 3 · STEP 0x03

在应用里选用

应用 → AI 模型
1

AI 模型

你添加的模型
2

调试对话

你好
示意图,以软件当前版本界面为准
  • 在应用设置里把 AI 模型切到刚添加的模型,用调试对话试一句。

✓ 怎么确认成功了

  • 添加模型时校验通过;应用对话能回答;控制台「用量」页出现请求。

常见问题

添加时提示无法通过校验?

官方说明:基础模型名与服务端不一致就会校验失败。重新从模型广场复制;再检查 API 域名是否为 https://api.suanlimao.shop/v1、Key 是否完整。

要向量模型做知识库?

同样用 OpenAI 供应商添加,模型类型选「向量模型」,基础模型填模型广场里的向量模型名;模型广场没有就用 MaxKB 内置的本地向量模型。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。