接入软件
MaxKB
在 MaxKB 里以 OpenAI 供应商添加模型,API 域名填我们的地址。
约 5 分钟适合:自己部署 MaxKB 知识库问答的管理员
开始之前
- MaxKB 管理员账号
- 一把 Key 和一个模型名
步骤 1 · STEP 0x01
选 OpenAI 供应商并添加模型
模型 → 供应商 OpenAI
1
供应商
OpenAI
2
添加模型
进入模型管理,左侧选「全部模型」后选择供应商 OpenAI,点「添加模型」。MaxKB 没有单独的「OpenAI 兼容」供应商,官方文档就是用 OpenAI 供应商 + 反向代理地址来接第三方的。
步骤 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)。