From d4e69073ec699a9a292582b0ec4273c3a975f0d6 Mon Sep 17 00:00:00 2001 From: root <953994191@qq.com> Date: Thu, 30 Apr 2026 23:06:49 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0README=E6=80=BB?= =?UTF-8?q?=E8=A7=88=EF=BC=8C=E5=8A=A0=E5=85=A5=E8=81=94=E7=BD=91=E6=90=9C?= =?UTF-8?q?=E7=B4=A2=E5=92=8C=E5=8F=AF=E8=A7=86=E5=8C=96=E5=9B=BE=E8=A1=A8?= =?UTF-8?q?=E5=8A=9F=E8=83=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 21b6bf6..02b35f3 100644 --- a/README.md +++ b/README.md @@ -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