还在用脚本一次性跑完 RAG 流程？太 Low 了！本教程带你将数据处理与 AI 应用彻底解耦。你将学会：1) 建立一个独立的“数据中心”，随时增删改查你的知识。2) 让 RAG 应用加载指定知识库。
Github: https://github.com/langchain-ai/langchain
嘿，各位 AI 架构师和探索者！
你们是否成功用 LangChain 搭建了你的第一个 RAG 应用？很棒！但你可能很快就发现了一些“现实”问题：
数据更新太麻烦：每次有新文档，难道都要重新运行整个程序，重建一次向量数据库吗？ 数据和应用耦合：数据处理和模型调用的代码混在一起，维护起来像一团乱麻。 无法追溯原文：我怎么知道向量数据库里的某个向量，对应的是哪篇文档的哪句话？想删掉都找不到！ 多用户怎么办：如果想给不同客户/部门用，如何确保他们只能看到自己的知识，互不干扰？
如果你遇到了以上任何一个问题，那么恭喜你，你正在从“玩具项目”向“真正可用的产品”迈进！
今天，这篇进阶指南将彻底解决你的烦恼。我们将重新设计 RAG 架构，实现 数据处理 与 AI 应用 的优雅分离，并赋予你的知识库完整的 生命周期管理（CRUD） 能力。
架构升级 - 从“一体机”到“插拔式”
告别把所有代码都写在一起的“一体机”模式吧！一个成熟的 RAG 系统应该分为两个核心部分：
知识注入与管理端 (The Data Hub) ：这是一个独立的模块，专门负责接收文档、处理数据、更新向量数据库。你可以定期运行它，也可以在需要时手动触发。 RAG 应用端 (The AI App) ：这是面向用户的部分。它只负责加载一个已经建好的知识库，并执行检索和生成任务。
这样做的好处是显而易见的：解耦、可维护、可扩展。
构建你的“知识管理中心”
这里的核心思想是：我们不仅需要一个向量数据库 (如 FAISS)，还需要一个元数据存储来帮助我们管理原文。
我们将使用 FAISS 存储向量用于快速检索，同时用一个简单的 JSON 文件或 SQLite 数据库 作为“账本”，记录每个数据块的原文、来源和唯一ID。
安装基础依赖：
pip install langchain langchain_community pypdf langchain-DeepSeek faiss-cpu sentence_transformers
第一步：存储知识并建立“账本”
这个脚本的目标是：接收新文档，将其存入 FAISS，并更新我们的“账本”。
import os
import json
import uuid
from langchain_community.document_loaders import PyPDFLoader
from langchain.text_splitter import RecursiveCharacterTextSplitter
from langchain_openai import OpenAIEmbeddings
from langchain_community.vectorstores import FAISS
# --- 配置区 ---
FAISS_DB_PATH = "faiss_index_prod" # 指定 FAISS 索引的存储路径
METADATA_STORE_PATH = "metadata_store.json" # “账本”路径
NEW_DOCUMENT_PATH = "最新的产品功能介绍.pdf" # 要添加的新文档
# --- 初始化模型 ---
embeddings_model = OpenAIEmbeddings()
# --- 加载或创建元数据存储 ---
if os.path.exists(METADATA_STORE_PATH):
with open(METADATA_STORE_PATH, 'r') as f:
metadata_store = json.load(f)
else:
metadata_store = {}
# --- 加载并处理新文档 ---
loader = PyPDFLoader(NEW_DOCUMENT_PATH)
documents = loader.load()
text_splitter = RecursiveCharacterTextSplitter(chunk_size=500, chunk_overlap=50)
docs = text_splitter.split_documents(documents)
# --- 为新文档块生成唯一ID并存入元数据 ---
texts_to_embed = []
ids_to_add = []
for doc in docs:
# 1. 生成唯一ID
doc_id = str(uuid.uuid4())
ids_to_add.append(doc_id)
# 2. 将原文和来源存入“账本”
metadata_store[doc_id] = {
"content": doc.page_content,
"source": doc.metadata.get('source', 'Unknown')
}
texts_to_embed.append(doc.page_content)
# --- 加载现有FAISS索引或创建新索引 ---
if os.path.exists(FAISS_DB_PATH):
vector_db = FAISS.load_local(FAISS_DB_PATH, embeddings_model, allow_dangerous_deserialization=True)
# 将新文档向量化后添加进去
vector_db.add_texts(texts=texts_to_embed, ids=ids_to_add)
else:
# 首次创建
vector_db = FAISS.from_texts(texts=texts_to_embed, embedding=embeddings_model, ids=ids_to_add)
# --- 保存更新后的索引和元数据 ---
vector_db.save_local(FAISS_DB_PATH)
with open(METADATA_STORE_PATH, 'w') as f:
json.dump(metadata_store, f, indent=4)
print(f"成功添加 {len(docs)} 个数据块到知识库！")
现在，你有了一个可以反复运行的脚本。每次有新文档，只需修改 NEW_DOCUMENT_PATH 并运行即可！
第二步：实现对知识的“查”与“删”
有了“账本” (metadata_store.json)，管理就变得轻而易举。
查看原文 (Read): 你可以直接打开 metadata_store.json 文件，搜索关键词，找到对应的原文内容和它的 doc_id。
删除原文 (Delete):
在“账本”中找到你想要删除内容的 doc_id。 使用 FAISS 提供的 delete 方法删除向量。
import json
from langchain_community.document_loaders import PyPDFLoader
from langchain_community.embeddings import HuggingFaceEmbeddings
from langchain.text_splitter import RecursiveCharacterTextSplitter
from langchain_community.vectorstores import FAISS
# --- 删除指定知识的示例 ---
FAISS_DB_PATH = "faiss_index_prod"
METADATA_STORE_PATH = "metadata_store.json"
ID_TO_DELETE = "efe975e5-77fb-4f3a-a447-7a36cb97606b" # 从你的账本中找到的那个需要删除的ID
# --- 初始化模型 ---
embeddings_model = HuggingFaceEmbeddings(model_name="../weight/all-MiniLM-L6-v2")
# 加载数据库和元数据
vector_db = FAISS.load_local(FAISS_DB_PATH, embeddings_model, allow_dangerous_deserialization=True)
with open(METADATA_STORE_PATH, 'r') as f:
metadata_store = json.load(f)
# 1. 从 FAISS 中删除向量
success = vector_db.delete([ID_TO_DELETE])
print(f"向量删除是否成功: {success}")
# 2. 从“账本”中删除记录
if ID_TO_DELETE in metadata_store:
del metadata_store[ID_TO_DELETE]
# 3. 保存变更
vector_db.save_local(FAISS_DB_PATH)
with open(METADATA_STORE_PATH, 'w') as f:
json.dump(metadata_store, f, indent=4)
print(f"ID为 {ID_TO_DELETE} 的知识已彻底删除！")
至此，你拥有了一个功能完备、可动态维护的知识管理中心！
构建“AI 应用端”
应用端的任务就变得非常纯粹和简单了：加载指定知识库，然后提供问答服务。
from langchain_openai import ChatOpenAI, OpenAIEmbeddings
from langchain_community.vectorstores import FAISS
from langchain.prompts import ChatPromptTemplate
from langchain.schema.runnable import RunnablePassthrough
from langchain.schema.output_parser import StrOutputParser
# --- 配置区 ---
FAISS_DB_PATH = "faiss_index_prod" # 指定要加载的知识库！
# --- 加载预先构建好的知识库 ---
embeddings_model = OpenAIEmbeddings()
vector_db = FAISS.load_local(FAISS_DB_PATH, embeddings_model, allow_dangerous_deserialization=True)
retriever = vector_db.as_retriever()
# --- 构建 RAG 链 (这部分和之前一样) ---
template = """
请基于以下检索到的内容来回答问题。如果内容不足以回答，就说你不知道。
内容: {context}
问题: {question}
回答:
"""
prompt = ChatPromptTemplate.from_template(template)
llm = ChatOpenAI(model_name="gpt-4o")
rag_chain = (
{"context": retriever, "question": RunnablePassthrough()}
| prompt
| llm
| StrOutputParser()
)
# --- 开始提问！---
query = "检测服务的状态有那些？"
response = rag_chain.invoke(query)
print(response)
运行结果如下
问题：检测服务的状态有那些？
回答：检测服务的状态有：检测，就绪，⾃检，故障，关闭五种状态。
看！应用端的代码多么清爽！它完全不关心数据是怎么来的，只负责加载和使用。
总结
今天，我们完成了一次巨大的架构升级！你现在拥有的，不再是一个脆弱的 Demo，而是一个具备以下特性的、强大的 RAG 系统框架：
架构解耦：数据处理与 AI 应用分离，易于维护和协作。 动态管理：可以随时向知识库中增添、查询和删除知识。 可追溯性：通过“账本”轻松找到向量对应的原文。 多租户支持：懂得如何为不同用户提供隔离的知识服务。
这才是 RAG 在真实世界中的正确打开方式。基于这个框架，你可以继续扩展，比如接入更多的文档类型、优化切分策略、或是更换更强大的向量数据库。
通往 AI 产品化的大门已经为你敞开，快去构建你的专属知识帝国吧！
