LLM+LangChain+web UI的架构解析——预备知识、工具篇

目录

• 一、LLM的低资源模型微调
• 二、向量数据库
• • 1、Milvus(v2.1.4)：云原生自托管向量数据库（Ubuntu下）
  • • 1）安装（Docker Compose方式）：
    • 2）管理工具（仅支持Milvus 2.0 之后的）：
    • 3）python操作：基于pymilvus == 2.1.3
  • 2、Faiss
  • 3、Pinecone：完全托管的云原生向量数据库
  • 4、postgreSQL+pgvector插件
• 三、LangChain+外挂知识库
• • 1、简介
  • 2、安装
  • 3、主要的几大模块：
• 四、AI web工具
• • 1、Gradio==3.28.3
  • 2、Streamlit == 1.25.0
• 五、其他
• • 1、FastChat
  • 2、FastAPI

一、LLM的低资源模型微调

（1）p tuning v2

（2）Lora
这种方法有点类似于矩阵分解，可训练层维度和预训练模型层维度一致为d，先将维度d通过全连接层降维至r，再从r通过全连接层映射回d维度，r<<d，r是矩阵的秩，这样矩阵计算就从d x d变为d x r + r x d，参数量减少很多，下图中对矩阵A使用随机高斯初始化，对矩阵B使用0进行初始化。
推理计算的时候，因为没有改变预训练权重，所以换不同的下游任务时，lora模型保存的权重也是可以相应加载进来的，通过矩阵分解的方法参数量减少了很多。

二、向量数据库

1、Milvus(v2.1.4)：云原生自托管向量数据库（Ubuntu下）

• milvus的GitHub
• 支持元数据存储。

1）安装（Docker Compose方式）：

• 参考博客：https://blog.csdn.net/hello_dear_you/article/details/127841589
• 官网说明：https://milvus.io/docs/v2.1.x/install_standalone-docker.md

【注意】安装的时候，如果第一次安装错了版本，直接重新走下面的步骤的时候很可能启动时，milvus-minio秒退！！

（1）创建目录：

mkdir Milvus

（2）下载YAML文件

wget https://github.com/milvus-io/milvus/releases/download/v2.1.4/milvus-standalone-docker-compose.yml -O docker-compose.yml

（3）在YAML文件所在目录下启动Milvus

sudo docker compose up -d # docker v2，若是v1则使用docker-compose；使用docker compose version查看docker版本

【注意】
① 如果没有docker命令，则安装：

sudo snap install docker

② 这个命令开始执行之后会自动下载Milvus对应的镜像文件，需要等待一段时间。 当镜像下载完成后，相应的容器也会启动。

（4）查看Milvus的启动状态：

sudo docker compose ps

（5）停止Milvus

sudo docker compose down

2）管理工具（仅支持Milvus 2.0 之后的）：

（1） Milvus_cli
（2） Attu可视化管理界面官方安装教程

• attu的GitHub
• 注意 attu 和 milvus 版本之间的对应关系，否则会登录不了，点击connect报400 Bad Request。

① 使用Docker Compose方式进行安装，
step1：通过Docker Compose方式安装完成milvus（即下载完YAML文件）；
step2：编辑下载好的YAML文件，在service语句块添加以下内容：

attu:container_name: attuimage: zilliz/attu:v2.1.5environment:MILVUS_URL: milvus-standalone:19530ports:- "8001:3000"# 我的8000端口一直提示被占用，所以换成了8001端口depends_on:- "standalone"

step3：启动milvus：sudo docker-compose up -d

② 使用docker安装

docker run -p 8001:3000-e MILVUS_URL={your machine IP}:19530 zilliz/attu:v2.1.5

step4：安装完成后，在连网的浏览器输入：http://{ your machine IP }:8001即可进入attu登录界面。
（your machine IP为安装milvus的机器ip；下图为attu的登陆界面，没有放开账号密码认证。）

3）python操作：基于pymilvus == 2.1.3

• 注意Milvus版本和pymilvus版本之间的对应，否则会报错：pymilvus.exceptions.MilvusException:
  两者之间的版本对应：官网

• pymilvus不同版本之间差异很大。
• milvus的字段数据类型（dtype）：仅可以在向量类型字段（（BINARY_VECTOR、FLOAT_VECTOR））上创建索引

• 索引类型（index_type）与向量度量类型（metric_type）：

（1）创建conda环境Milvus，并安装pymilvus

pip install pymilvus

【注意】操作时使用docker-compose ps -a查看milvus运行状态，确保milvus容器处在开启状态。

2、Faiss

• FAISS的GitHub
• C++编写的向量索引工具，是针对稠密向量进行相似性搜索和聚类的一个高效类库；有python接口，有CPU版和GPU版，可以直接pip安装。
• 不支持元数据存储

pip install faiss-cpu==1.7.3# 或者conda环境中安装conda install faiss-cpu -c pytorch # cpu 版本conda install faiss-gpu cudatoolkit=8.0 -c pytorch # GPU 版本 For CUDA8 

3、Pinecone：完全托管的云原生向量数据库

python中使用：

# langchain中的模块from langchain.vectorstores import Pinecone

4、postgreSQL+pgvector插件

GitHub网址：https://github.com/pgvector/pgvector
详细内容参见博客：https://blog.csdn.net/lucky_chaichai/article/details/118575261

三、LangChain+外挂知识库

1、简介

• langchain中文网：https://www.langchain.com.cn/
• LangChain是一个链接面向用户程序和LLM之间的一个中间层，用以集成LLM和自有知识库的数据。
• LangChain，可以通过将其它计算资源和自有的知识库结合，通过输入自己的知识库来“定制化”自己的大语言模型，防止“AI幻觉”；
• 使用langchain将外挂知识库与LLM结合的策略是：
  在向量数据库中索引 question 的相似向量（度量准则包括余弦距离、欧式距离等），找到top_n条向量对应的关联文本作为context，根据预设的模板拼接得到最终的prompt，如：

已知信息：{context}
根据上述已知信息，简洁和专业的来回答用户的问题。如果无法从中得到答案，请说 “根据已知信息无法回答该问题” 或 “没有提供足够的相关信息”，不允许在答案中添加编造成分，答案请使用中文。
问题是：{question}

外挂知识库+LLM的一般过程：

2、安装

pip install langchain

3、主要的几大模块：

LLM API模块：langchain.llms
文本分块器：langchain.text_splitter（text_splitter中常用分类器介绍）
向量模型加载、向量化模块：langchain.embeddings
向量存储、索引模块：from langchain.vectorstores import Milvus, FAISS, Pinecone, Chroma
文件操作模块：langchain.docstore、angchain.document_loaders
langchain.agents

四、AI web工具

1、Gradio==3.28.3

• Gradio的GitHub：https://github.com/gradio-app/gradio
• Gradio支持Markdown文本显示规则，‘\n’换行不起作用，需要替换为‘
’；
• 目前感觉这个真的仅适合做小demo（可能我还不是太精通吧）；
• 组件的value是什么数据类型，则在触发事件的函数 fn 中就直接看作该类型进行操作。

gr.Interface()、gr.Blocks()两种方式搭建UI界面：

2、Streamlit == 1.25.0

• 在做LLM聊天web UI方面，streamlit要比Gradio复杂的多，功能也更加强大，需要自己对各种组件进行风格渲染（没有现成的chatbot这种组件）。
• 与Gradio相比，需要一点前端基础知识。
• 不同于Gradio，定义的组件对象和使用st.session_state.[组件key]获取的值一样……
• 运行方式：在py文件路径下，执行命令streamlit run webui_st.py

简单的聊天对话框示例：

import timeimport streamlit as stclass MsgType:'''目前仅支持文本类型的输入输出，为以后多模态模型预留图像、视频、音频支持。'''TEXT = 1IMAGE = 2VIDEO = 3AUDIO = 4class ST_CONFIG:user_bg_color = '#77ff77'user_icon = 'https://tse2-mm.cn.bing.net/th/id/OIP-C.LTTKrxNWDr_k74wz6jKqBgHaHa" />= '#ccccee'robot_icon = 'https://ts1.cn.mm.bing.net/th/id/R-C.5302e2cc6f5c7c4933ebb3394e0c41bc?rik=z4u%2b7efba5Mgxw&riu=http%3a%2f%2fcomic-cons.xyz%2fwp-content%2fuploads%2fStar-Wars-avatar-icon-C3PO.png&ehk=kBBvCvpJMHPVpdfpw1GaH%2brbOaIoHjY5Ua9PKcIs%2bAc%3d&risl=&pid=ImgRaw&r=0'default_mode = '知识库问答'defalut_kb = ''def robot_say(msg, kb=''):st.session_state['history'].append({'is_user': False, 'type': MsgType.TEXT, 'content': msg, 'kb': kb})def user_say(msg):st.session_state['history'].append({'is_user': True, 'type': MsgType.TEXT, 'content': msg})def format_md(msg, is_user=False, bg_color='', margin='10%'):'''将文本消息格式化为markdown文本, 指定user 和 robot消息背景色、左右位置等Parameters----------msg: 文本内容bg_color: 指定markdown文本的背景颜色'''if is_user:bg_color = bg_color or ST_CONFIG.user_bg_colortext = f'''{bg_color};margin-left:{margin};word-break:break-all;float:right;padding:2%;border-radius:2%;">{msg}'''else:bg_color = bg_color or ST_CONFIG.robot_bg_colortext = f'''{bg_color};margin-right:{margin};word-break:break-all;padding:2%;border-radius:2%;">{msg}'''return textdef message(msg,is_user=False,msg_type=MsgType.TEXT,icon='',bg_color='',margin='10%',kb='',):'''渲染单条消息（包括双方头像、聊天文本）。目前仅支持文本返回第2列对象'''# 定义界面中的列，若参数为一个整数n，则意为插入n个等尺寸列；若为列表[1, 10, 1]则意为插入3列，数值为各列之间的倍数（数值为小数，则指占界面百分比）# 该函数中，列cols[0]为robot头像，cols[2]为user头像，cols[1]为聊天消息（markdown文本）cols = st.columns([1, 10, 1]) empty = cols[1].empty() # 将第2列初始化为空if is_user:icon = icon or ST_CONFIG.user_iconbg_color = bg_color or ST_CONFIG.user_bg_colorcols[2].image(icon, width=40) # 第3列展示user头像if msg_type == MsgType.TEXT:text = format_md(msg, is_user, bg_color, margin)empty.markdown(text, unsafe_allow_html=True) # 将第2列填充user的Markdown文本else:raise RuntimeError('only support text message now.')else:icon = icon or ST_CONFIG.robot_iconbg_color = bg_color or ST_CONFIG.robot_bg_colorcols[0].image(icon, width=40) # 第1列展示robot头像if kb:cols[0].write(f'({kb})') # 用于向Web应用程序添加任何内容？？if msg_type == MsgType.TEXT:text = format_md(msg, is_user, bg_color, margin)empty.markdown(text, unsafe_allow_html=True) # 将第2列填充robot的Markdown文本else:raise RuntimeError('only support text message now.')return emptydef output_messages(user_bg_color='',robot_bg_color='',user_icon='',robot_icon='',):with chat_box.container(): # 为st添加一个多元素容器（chat_box为前面定义的st的占位符）last_response = Nonefor msg in st.session_state['history']:bg_color = user_bg_color if msg['is_user'] else robot_bg_coloricon = user_icon if msg['is_user'] else robot_iconempty = message(msg['content'],is_user=msg['is_user'],icon=icon,msg_type=msg['type'],bg_color=bg_color,kb=msg.get('kb', ''))if not msg['is_user']:last_response = emptyreturn last_responseif __name__ == "__main__":webui_title = """langchain-ChatGLM WebUI"""robot_say_ininfo = ('您好：\n\n''欢迎使用本机器人聊天界面（初版），基于streamlit我还在努力中哦~~') # 注意这个写法，只有一对引号的话第二行会为其他背景色LLM_MODEL = 'baichuan-130b'EMBEDDING_MODEL = 'ernie-3.0-base-zh'modes = ['LLM 对话', '知识库问答', 'Bing搜索问答', '知识库测试']st.set_page_config(webui_title, layout='wide') # webui_title是浏览器选项卡中显示的页面标题# session_state在st rerun过程中定义、存储共享变量，可以存储任何对象；只可能在应用初始化时被整体重置。而rerun不会重置session state。# 调用其中变量的方法：st.session_state.[变量的key]st.session_state.setdefault('history', []) # history为变量的key，[]为初始值# 定义“等待提示”，注意每次对界面操作都会加载一次！！！？with st.spinner(f'正在加载模型({LLM_MODEL} + {EMBEDDING_MODEL})，请耐心等候...'):time.sleep(2)# 定义侧边栏with st.sidebar:robot_say(robot_say_ininfo)def on_mode_change():m = st.session_state.moderobot_say(f'已切换到"{m}"模式')index = 0mode = st.selectbox('对话模式', modes, index,on_change=on_mode_change, key='mode') # on_change为复选框操作出发的变化函数print('mode:', mode) # 打印的结果即为mode里面的值（字符串）chat_box = st.empty() # 为st应用添加一个占位符# 创建表单容器，clear_on_submit=True表示在用户按下提交按钮后，表单内的所有小部件都将重置为其默认值with st.form('my_form', clear_on_submit=True):cols = st.columns([8, 1])question = cols[0].text_input('temp', key='input_question', label_visibility='collapsed') # 第1列为文本输入框print('question:', question) # 打印结果即为文本框中输入的文本def on_send():q = st.session_state.input_questionuser_say(q)print("st.session_state['history']:", st.session_state['history'])last_response = output_messages()# last_response.markdown(# format_md(st.session_state['history'][-1]['content'], False),# unsafe_allow_html=True# )submit = cols[1].form_submit_button('发送', on_click=on_send) # 第2列为按钮，on_click为点击按钮出发的操作函数output_messages() # 不执行这个函数页面会不展示聊天历史

首次运行结果：

操作效果：

五、其他

1、FastChat

• fastchat的GitHub
• fastchat是一个基于聊天机器人方式对LLM快速训练、部署、评估的开放平台： 将LLM下载到本地后，可以通过fastchat中的 CLI 、Web 两种方式加载 / 调用 / 启动LLM，快速与LLM进行对话：
  • CLI方式（命令行交互界面）：
    python -m fastchat.serve.cli –model-path [a LLM local folder or a Hugging Face repo name]
    – -device cpu：使用CPU运行；
    – -num-gpus 2：指定使用的GPU数量；
    – -max-gpu-memory 8GiB：指定每个GPU使用的最大内存8G。
  • Web方式（web UI交互界面）：
    需要三个主要组件：web servers（与用户的接口）、model workers（组织模型）、a controller（协调前两者）
    （1）命令行启动：
    ① python -m fastchat.serve.controller
    ② python -m fastchat.serve.model_worker –model-path [a LLM local folder or a Hugging Face repo name]
    ③ python -m fastchat.serve.[gradio_web_server / openai_api_server ]
    openai_api_server：启动RESTful API server，为其支持的LLM提供OpenAI-compatible APIs（即通过该命令启动后，可以使用 openai 的方式与model_worker 对应的LLM进行对话）；后续也可以接入Langchain（内在逻辑？？）。
    – -host [ localhost ] –port [ 8000 ]：启动RESTful API server时，需要指定host、port
    （2）基于fastchat模块：
    from fastchat.serve.controller import Controller, app
    from fastchat.serve.model_worker import (AWQConfig, GptqConfig, ModelWorker, app, worker_id)
    from fastchat.serve.openai_api_server import (CORSMiddleware, app, app_settings)
    CLI的结果：（81个CPU，一个问题要等2分钟差不多……）
    
    web方式启动后，后续基于python的操作：
    可以基于openai模块（如下例），也可以基于langchain中的 LLMChain 和 from langchain.chat_models import ChatOpenAI

import openaiopenai.api_key = "EMPTY"openai.api_base = "http://localhost:8000/v1"def test_chat_completion_stream(model = "chatglm2-6b"):# 流式的测试，参考：https://github.com/lm-sys/FastChat/blob/main/tests/test_openai_api.pymessages = [{"role": "user","content": "Hello! What is your name" />} ]res = openai.ChatCompletion.create(model=model, messages=messages, stream=True)for chunk in res:content = chunk["choices"][0]["delta"].get("content", "")print(content, end="", flush=True)print()def text_chat_completion(model = "chatglm2-6b"):# create a chat completioncompletion = openai.ChatCompletion.create( model=model, messages=[{"role": "user", "content": "Hello! What is your name?"}] )# print the completionprint(completion.choices[0].message.content)

【注意】（Ubuntu）在输入问题的时候删除错别字重新输入后，回车会报错：UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe3 in position 15: invalid continuation byte

1）安装

pip install fschat

2、FastAPI

• FastAPI的GitHub
• FastAPI 是一个高性能 Web 框架，用于构建 API

1）安装

pip install fastapipip install uvicorn

其他参考：
从LangChain+LLM的本地知识库问答到LLM与知识图谱、数据库的结合