需完成模型配置、知识库构建与应用绑定三步操作：一、确认deepseek v4模型已通过ollama加载并验证响应；二、在maxkb中配置ollama模型连接，注意docker网络地址设置；三、创建知识库上传文档，新建应用绑定模型与知识库并启用rag。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在本地部署MaxKB系统，但希望接入DeepSeek V4模型以构建企业级知识库问答能力，则需完成模型配置、知识库构建与应用绑定三步操作。以下是具体实施步骤：
一、确认DeepSeek V4模型已通过Ollama加载
MaxKB依赖Ollama作为本地模型服务中间件，必须确保DeepSeek V4模型已正确拉取并处于运行状态。Ollama官方尚未正式发布名为“DeepSeek V4”的公开模型标签，当前可用的DeepSeek系列主流版本为deepseek-r1:7b、deepseek-r1:14b及deepseek-coder:33b-instruct等。若您所指“V4”为内部定制量化版或微调分支，请确认其在Ollama中注册的模型名称与实际list输出严格一致。
1、在终端执行ollama list命令，检查输出中是否存在目标模型条目，例如：deepseek-r1:14b
2、若未列出，执行拉取命令：ollama pull deepseek-r1:14b
3、验证模型可响应：ollama run deepseek-r1:14b "你好"，观察是否返回合理文本响应
二、在MaxKB中添加DeepSeek模型连接
MaxKB需通过HTTP接口调用Ollama服务，因Docker容器网络隔离，默认localhost不可达，必须使用主机网络地址或桥接配置实现跨容器通信。
1、登录MaxKB后台（http://服务器IP:8080），使用默认账号admin与密码MaxKB@123..
2、进入【模型管理】→【添加模型】，选择供应商为Ollama
3、填写模型配置项：
模型名称：与ollama list中显示的名称完全一致，例如deepseek-r1:14b
基础模型：同上，保持一致
API域名：填写http://host.docker.internal:11434（适用于Mac/Windows Docker Desktop）或http://172.17.0.1:11434（Linux宿主机Docker默认网关）
API Key：留空或填入任意非空字符串（Ollama默认无需认证）
4、点击【测试连接】，确认返回“连接成功”提示
三、创建专属企业知识库并上传文档
知识库是RAG流程的数据基础，MaxKB支持多格式解析与向量化索引，上传内容将自动切片并嵌入至向量数据库中，供后续语义检索使用。
1、进入【知识库】→【新建知识库】，输入名称如客户服务SOP_V2026，选择分段策略为“按标题”或“固定长度”
2、点击【上传文件】，支持PDF、DOCX、XLSX、TXT、MD等格式；单次最多上传50个文件，总大小不超过2GB
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
3、上传后等待状态变为“已完成”，此时右侧显示“已处理文档数”与“向量总数”
4、可点击某文档右侧【预览】按钮，确认关键业务术语（如“退换货时效”“SLA响应等级”）已被正确识别并切片
四、构建基于DeepSeek V4的应用并启用RAG
应用是用户交互入口，需绑定模型与知识库，并开启检索增强机制，使DeepSeek生成答案时能实时引用知识库片段。
1、进入【应用】→【新建应用】，填写名称如客服智能助手-生产环境
2、在【模型】下拉框中选择已配置的deepseek-r1:14b模型
3、在【知识库】区域勾选前述创建的客户服务SOP_V2026，并开启【启用RAG】开关
4、设置RAG参数：
检索数量：建议设为3（返回最相关3个知识片段）
相似度阈值：设为0.45（低于此值的片段不参与生成）
上下文长度：设为4096（匹配DeepSeek V4典型上下文窗口）
5、点击【保存】后，进入该应用详情页，点击【演示】进行实时问答测试
五、验证问答准确性与权限控制
企业级系统需保障回答合规、来源可溯、访问可控。MaxKB提供细粒度日志与权限策略，用于审计与隔离敏感知识。
1、在【应用】→【演示】界面输入典型问题，例如：“客户投诉响应超时如何补偿？”
2、查看返回答案末尾是否附带引用标记，如[客户服务SOP_V2026#P12]，点击可跳转至原始文档对应位置
3、进入【系统设置】→【权限管理】，为不同部门创建角色（如“客服专员”“技术支持主管”），并分配对应知识库的读取权限
4、切换用户身份重新登录，确认仅能访问被授权的知识库内容，且无法查看其他部门的FAQ文档
