MaxKB：基于 LLM 的开源知识库问答系统详解

environment:
  - DB_HOST=postgres
  - DB_PORT=5432
  - DB_USER=postgres
  - DB_PASSWORD=your_password
  - REDIS_HOST=redis
  - REDIS_PORT=6379
  # 模型配置示例
  - OPENAI_API_KEY=sk-xxxxx
  - MODEL_PROVIDER=openai

步骤三：初始化数据库

首次启动时，Docker Compose 会自动执行数据库迁移脚本，初始化 PostgreSQL 和 pgvector 扩展。

docker exec -it maxkb-db psql -U postgres -c "CREATE EXTENSION vector;"

步骤四：访问系统

启动完成后，访问 http://localhost:3000 即可进入 MaxKB 管理后台。默认管理员账号通常为 admin，初始密码请查看官方文档或日志输出。

知识库管理

创建知识库

1. 登录管理后台，进入'知识库'模块。
2. 点击'新建知识库'，输入名称和描述。
3. 选择数据源类型：本地文件上传、URL 抓取、API 导入等。

文档解析

MaxKB 支持多种文档格式的解析，包括 PDF、Word、Markdown、TXT 等。系统会自动对文档进行分块（Chunking），并生成对应的向量索引存入 pgvector。

# 伪代码示例：文档分块逻辑
from langchain.text_splitter import RecursiveCharacterTextSplitter

splitter = RecursiveCharacterTextSplitter(
    chunk_size=1000,
    chunk_overlap=200
)
texts = splitter.split_text(document_content)

问答测试

在知识库详情页，可以使用内置的测试窗口输入问题，验证检索效果。系统会返回引用来源和回答内容，方便调试 Prompt 和检索参数。

集成与 API

MaxKB 提供了标准的 RESTful API，便于与其他系统集成。

获取会话 ID

curl -X POST http://localhost/api/v1/chat-messages \
-H "Content-Type: application/json" \
-d '{"question": "你好", "conversation_id": null}'

流式输出

支持 SSE（Server-Sent Events）流式输出，提升用户体验。

const eventSource = new EventSource('/api/v1/chat-messages/stream');
eventSource.onmessage = (event) => {
  console.log(JSON.parse(event.data));
};

应用场景

MaxKB 适合各种场景，包括但不限于：

1. 企业内部知识库：员工查询公司制度、技术文档、操作手册。
2. 客户支持系统：自动回复常见客户问题，减轻人工客服压力。
3. 网站 AI 助手：嵌入官网，为用户提供 7x24 小时的智能咨询服务。
4. 教育辅助工具：帮助学生解答课程相关问题，整理学习资料。

结语

MaxKB 是一款简单高效的 AI 知识库系统，凭借其灵活的架构和对多种模型的支持，成为企业和个人搭建 AI 应用的理想选择。它不仅提高了工作效率，还能为用户提供更加智能和便捷的体验。随着大模型技术的不断演进，MaxKB 将持续优化其功能，为用户提供更优质的服务。

如果你正在寻找一款易于部署且功能强大的 AI 知识库系统，MaxKB 值得深入研究和尝试。