常见问题#

本页汇总 MaxKB 技术交流群中用户咨询频率较高的常见问题及处理方式，内容持续更新。

#1 知识库与模型

#1.1 标题内容检索不出来怎么办？

问题：知识库文档分块后，用与标题完全一致的内容做命中测试检索不出来，必须生成关联问题才能命中，有办法不生成关联问题也能命中吗？

处理方式：

可先检查命中测试的相似度参数是否设置过高，适当调低相似度后重新检索；若仍无法命中，可为分段添加关联问题，或更换效果更好的向量模型。

#1.2 如何关闭模型的思考模式？

问题：MaxKB 里怎么关闭模型的思考模式？

处理方式：

在模型的【模型参数设置】中可添加参数，关闭模型本身的思考模式。

#1.3 llama.cpp 重排模型添加提示 URL 无效怎么办？

问题：用 llama.cpp 部署的重排模型，在 MaxKB 添加时提示 URL 无效，是什么原因？

处理方式：

Ollama 和 llama.cpp 的重排模型校验接口不一样，因此选择 Ollama 供应商不一定可以通过校验。添加时供应商选择 vLLM 进行校验即可。

#2 系统集成与权限

#2.1 WorkBuddy 与 MaxKB 如何关联？

问题：WorkBuddy 的登录账号需要通过 MaxKB 创建吗？两个账号的权限是怎么关联的？

处理方式：

WorkBuddy 账号与 MaxKB 账号相互独立，通过 MaxKB 的个人 API Key 对接。安装 Skills 后，在技能中配置 MaxKB 的个人 API Key，WorkBuddy 即基于该 MaxKB 个人账号的权限访问对应知识库；首次使用时 AI 会向你索要登录所需的凭证（即 MaxKB 的个人认证信息）。

#2.2 MaxKB 对接WorkBuddy 的 Skills 在哪里下载？

问题：MaxKB Skills 技能包从哪里获取？下载后 WorkBuddy 不识别怎么办？

处理方式：

MaxKB Skills 可在论坛帖子（https://bbs.fit2cloud.com/t/topic/19883）中获取下载链接。下载后把安装包直接拖入 WorkBuddy 的输入框，让 WorkBuddy 自行安装即可。