docs: 更新README总览,加入联网搜索和可视化图表功能
All checks were successful
构建并部署 AI Agent 服务 / deploy (push) Successful in 5m42s

This commit is contained in:
2026-04-30 23:06:49 +08:00
parent a362459d1f
commit d4e69073ec

View File

@@ -1,6 +1,6 @@
# AI Agent - 智能助手系统
一个基于 LangGraph + FastAPI 的智能对话助手支持多模型切换、RAG 知识库检索、文件处理和网页抓取等功能。
一个基于 LangGraph + FastAPI 的智能对话助手支持多模型切换、RAG 知识库检索、联网搜索、可视化图表、以及多个专业子图模块(通讯录、词典、资讯分析)等功能。
---
@@ -25,6 +25,8 @@
- 💬 **智能对话**:支持多轮对话,自动记忆上下文
- 🔍 **知识库检索RAG**:基于向量数据库的智能问答
- 🌐 **联网搜索**:免费使用 DuckDuckGo 搜索,无需 API Key支持引用溯源
- 📊 **可视化图表**:支持 Mermaid 图表和 matplotlib 图表生成
- 🔄 **多模型切换**:前端可选择不同大语言模型
- 📇 **通讯录管理**:子图模块,联系人 CRUD、邮件处理
- 📖 **智能词典**:子图模块,翻译、生词本、专业术语提取
@@ -41,6 +43,7 @@
-**模块化设计**:清晰的代码分层,易于扩展和维护
-**模型服务层**:统一的 Embedding、Rerank、Chat 服务接口,支持自动降级
-**子图系统**:模块化的子图架构,共享公共工具(意图理解、人工审核、格式化输出)
-**公共工具库**:联网搜索、可视化图表等通用工具,所有子图和主图均可使用
-**React 模式**Reasoning → Acting → Observing 循环LLM 先思考再行动,支持多次工具调用
---
@@ -61,7 +64,7 @@
| **Embedding** | 向量嵌入 | llama.cpp server | latest | 本地 embedding 服务,支持多种模型 |
| **Agent 框架** | 工作流编排 | LangGraph + LangChain | latest | 状态机驱动的智能体工作流 |
| **子图系统** | 模块化子图 | subgraphs/ | - | 通讯录、词典、资讯分析等子图 |
| | 核心工具 | core/ | - | 状态基类、意图理解、格式化输出、人工审核 |
| | 核心工具 | core/ | - | 状态基类、意图理解、格式化输出、人工审核、**联网搜索**、**可视化图表** |
| **主图系统** | 主流程 | main_graph/ | - | 主图节点、工具、构建器 |
| **向量数据库** | 向量检索 | Qdrant | v1.12+ | 高性能向量相似度检索(远程服务器) |
| **后端框架** | API 服务 | FastAPI + Uvicorn | v0.115+ | RESTful API + WebSocket + SSE 流式输出 |
@@ -115,6 +118,8 @@ graph TB
Core --> HumanReview[人工审核]
Core --> Formatter[格式化输出]
Core --> StateBase[状态基类]
Core --> WebSearch[⭐ 联网搜索 DuckDuckGo]
Core --> Visualization[⭐ 可视化图表 Mermaid]
Contact -->|数据库| ContactDB[PostgreSQL联系人]
Dictionary -->|数据库| DictionaryDB[PostgreSQL生词本]
@@ -357,7 +362,9 @@ Agent1/
│ │ │ ├── intent.py # 意图理解React 模式)
│ │ │ ├── intent_classifier.py # 意图分类器
│ │ │ ├── formatter.py # 格式化输出工具
│ │ │ ── human_review.py # 人工审核节点
│ │ │ ── human_review.py # 人工审核节点
│ │ │ ├── web_search.py # ⭐ 联网搜索工具DuckDuckGo
│ │ │ └── visualization.py # ⭐ 可视化图表工具Mermaid + matplotlib
│ │ │
│ │ ├── agent/ # ⭐ Agent 服务层
│ │ │ ├── __init__.py