# 知识库

**Repository Path**: fm060/knowledge-base

## Basic Information

- **Project Name**: 知识库
- **Description**: AI Agent 知识库项目记录
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-25
- **Last Updated**: 2026-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RAG知识库多智能体Agent项目
> V0 ~ V9 迭代版本记录

## 版本迭代简述
- **V0**：基础大模型调用
- **V1**：增加工具调用
- **V2**：RAG 本地知识库
- **V3**：结构化输出、状态管理
- **V4**：优化 prompt、错误处理
- **V5**：多 Agent 分工（主控、检索、工具、总结）
- **V6**：向量库优化，文档切片 PDF 支持
- **V7**：完整多 Agent 版本（main.py）
- **V8**：FastAPI + HTML 前端问答页面
- **V9**：增加程序内部多轮对话循环；后续优化：替换火山云端 Embedding，Gradio 网页 UI
- **V10**：Agent 自我反思重试，工具调用失败自动重试

## 后续可扩展方向
- **V11**：Gradio 网页支持上传 PDF 文件，网页端直接入库
- **V12**：增加会话列表，多会话管理,压缩历史对话
- **V13**：增加 OCR 识别扫描 PDF
- **V14**：使用线上向量库

## 发现问题
- **q1**：增量PDF文件识别处理（新增接口 POST /knowledge/refresh），它会自动识别哪些是新文件/改过的文件/删掉的文件，只做必要的增量计算。）
- **q2**：检测文件内容不准确 （distance+阀值+同源合并+轻量重排+top_k可调）

## 项目文件结构
agent_project/
- ├─ main.py # V9 核心多智能体逻辑
- ├─ gradio_app.py # Gradio 网页聊天入口
- ├─ rag.py # RAG 知识库 (PDF/TXT/MD，火山云端 embedding + chromadb)
- ├─ config.py # API 密钥配置
- ├─ tools.py # 工具定义、工具描述
- ├─ knowledge/ # 存放知识库文档 (txt/md/pdf)
- ├─ chroma_db/ # chromadb 向量数据库 (自动生成)
- ├─ conversation_memory.json # 短期对话记忆 (自动生成)
- ├─ long_term_memory.json # 长期记忆 (自动生成)