Skip to content

2 快速入门

baixin edited this page Mar 23, 2024 · 17 revisions

2.1 登录 MaxKB 系统

打开服务地址:http://目标服务器IP地址:目标端口。   
使用默认的登录信息登录。    
用户名:admin    
默认密码:MaxKB@123.. 

2.2 添加模型

登录 MaxKB 系统 可以先对接一下模型,也可以在创建应用时添加模型。

2.2.1 添加千帆大模型

点击【添加模型】,选择供应商【千帆大模型】,直接进入下一步填写千帆大模型表单。
或者左侧供应商先选择【千帆大模型】,然后点击【添加模型】,则直接进入千帆大模型表单。

qianfan-model

模型名称: MaxKB 中自定义的模型名称。   
模型类型: 大语言模型。    
基础模型: 为供应商的 LLM 模型,选项中列了百度常用的一些大语言模型如:ERNIE-Bot、ERNIE-Bot-4(文心一言)、ERNIE-Bot-turbo、BLOOMZ-7B、  
         Llama-2-7b-chat、Llama-2-13b-chat、Llama-2-70b-chat、Qianfan-Chinese-Llama-2-7B、Qianfan-Chinese-Llama-2-13B 等。   
API Key 和 Secret Key: 千帆大模型中应用的API Key 和 Secret Key(需要先创建应用)

qianfan-app

2.2.2 添加 Ollama 大模型

点击【添加模型】,选择供应商【 Ollama 】,直接进入下一步填写 Ollama 供应商的大模型表单。
或者左侧供应商先选择【 Ollama 】,然后点击【添加模型】,则直接进入 Ollama 表单。    
模型名称: MaxKB 中自定义的模型名称。   
模型类型: 默认为大语言模型。    
基础模型: 为供应商的 LLM 模型,支持自定义输入,但需要与供应商的模型名称保持一致,否则校验失败。   
API 域名和API Key:  为供应商的连接信息(Ollama服务地址/API 版本号 如:http://121.89.218.233:11434/v1)。若没有API Key可以输入任意字符。
点击【添加】后 校验通过则添加成功,便可以在应用的 AI 模型列表选择该模型。
ollama-model

2.2.3 添加 Azure OpenAI 大模型

在模型管理中,点击供应商【 Azure OpenAI 】,直接进入下一步填写Azure OpenAI 的模型表单。    
或者左侧供应商先选择【 Azure OpenAI 】,然后点击【添加模型】,则直接进入 Azure OpenAI 的模型表单。 
Azure-model
模型名称: MaxKB 中自定义的模型名称。   
模型类型: 大语言模型。   
基础模型: 为供应商的 LLM 模型,下拉选项是 Azure OpenAI 常用的一些大语言模型如:gpt-3.5-turbo-0613、gpt-3.5-turbo-0301、gpt-3.5-turbo-16k-0613 等。    
API Key域名、API Key、部署名称: 是Azure OpenAI 的模型部署中提供的,需要填写一致,参考下图:

Azure key

2.3 创建知识库

打开【知识库】页面,点击【创建知识库】,进入创建知识库页面。 
  • 上传文档
输入知识库名称、知识库描述、选择通用型知识库类型。
然后将离线文档通过拖拽方式或选择文件上传方式进行上传。  
上传文档要求:
支持的格式为Markdown、TXT;   
每次最多上传 50 个文件;   
每个文件不超过 10MB。
  
文档规范建议:  
1、规范分段标识:离线文档的分段标识要有一定规范,否则拆分出来的段落会不规整。   
2、段落要完整:一个分段中最好能描述一个完整的功能点或问题。

create_offline_dataset

  • 设置分段规则
当前支持智能分段和高级分段两种分段方式,推荐选择:智能分段。  
支持查看分段预览。 

automatic paragraphing

用户可在分段预览中对不合理的分段进行编辑和删除。
EditSegments
  • 创建完成
点击【创建并导入】后,系统会对文档进行自动分段 -> 存储 -> 向量化处理操作。    
点击【前往文档】进入该知识库的【文档】列表页面。 
doc_list

2.4 创建应用

点击【创建应用】,进入创建应用页面,左侧为应用信息,右侧为调试预览界面。      
应用名称: 用户提问时对话框的标题和名字。    
应用描述: 对应用场景及用途的描述。    
AI模型: 显示【系统设置】-【模型管理】中大语言模型,也可以直接添加模型,请参考【】操作介绍。    
提示词: 系统默认有知识库的问答提示词,用户可以自定义。
多轮对话: 开启时当用户提问携带用户在当前会话中最后3个问题;不开启则仅向大模型提交当前问题。           
关联知识库: 选择已有的知识库进行关联,用户提问时会在关联的知识库中检索分段,引用分段生成提示词发送给大模型进行询问。若未关联知识库或未匹配到分段内容。
参数设置: 可以设置知识库的相似度,引用分段数量和最大引用字符数。      
注意:关联的知识库和应用为同一个用户创建。    
开场白: 用户打开对话时,系统弹出的问候语。支持 Markdown 格式;[-]后的内容为快捷问题,一行一个。    
问题优化: 对用户提出的问题先进行一次 LLM 优化处理,将优化后的问题在知识库中进行向量化检索,开启后能提高检索知识库的准确度,但由于多一次询问大模型会增加回答问题的时长。       
应用信息设置完成后,可以在右侧调试预览中进行提问预览。
add-app
以上 4 步完成后,便可进行问答对话了。

2.5 演示预览

入口一:在应用列表页面,点击【演示】,可进入问答页面。
入口二:点击应用面板,在概览页面点击演示或复制公开访问链接至浏览器进入问答页面进行提问。
QA

2.6 对话日志

在对话日志钟记录了所有用户会话中的问答详情,包括用户对AI 回答的反馈信息。  
维护人员可以通过查看对话日志和用户反馈来修正答案。
log-details