Yu-AI-Agent 项目AI 恋爱大师智能体 · 学习笔记本项目是AI 超级智能体项目的 Java 前后端部分学习自 鱼皮 · 编程导航 的 AI 开发实战课程及开源代码仓库。基于Spring Boot 3 Java 21 Spring AI构建了 AI 恋爱大师应用与 ReAct 模式自主规划智能体 YuManus。 项目预览首页 · AI 智能体选择AI 恋爱大师AI 超级智能体 项目结构yu-ai-agent/ # 项目根目录 ├── yu-ai-agent-frontend/ # Vue3 前端模块 │ ├── src/ # 前端源码目录 │ ├── package.json # 前端依赖配置 │ ├── vite.config.js # Vite 构建配置 │ └── nginx.conf # Nginx 部署配置 └── yu-ai-agent-backend/ # Java 后端项目模块 ├── pom.xml # 父 POM管理多模块 ├── Dockerfile # Docker 构建文件 ├── data/ # README 示例截图 ├── yu-ai-agent-admin/ # 核心应用模块 │ └── src/main/ │ ├── java/com/yuaiagent/ │ │ ├── advisor/ # 自定义 Advisor日志、Re-Reading │ │ ├── agent/ # AI 智能体BaseAgent → ReActAgent → YuManus │ │ ├── chatmemory/ # 文件持久化对话记忆Kryo 序列化 │ │ ├── config/ # 全局配置CORS、Tool 注册、RAG │ │ ├── constant/ # 常量定义 │ │ ├── controller/ # REST API 控制器AI 对话、健康检查 │ │ ├── rag/ # RAG 全链路文档加载/切割/检索/查询增强 │ │ ├── service/ # 业务服务恋爱大师、超级智能体 │ │ └── tools/ # 7 种内置工具 │ └── resources/ │ ├── application.yml # 应用配置 │ ├── application-druid.yml # Druid 数据源配置 │ ├── document/ # RAG 知识库文档恋爱问答 - 单身/恋爱/已婚篇 │ └── mcp-servers.json # MCP 服务端连接配置 └── yu-image-search-mcp-server/ # MCP 图片搜索服务模块 └── src/main/ ├── java/.../tools/ImageSearchTool.java └── resources/ # SSE / STDIO 双模式配置✨ 核心功能1. AI 恋爱大师 (LoveAppService)多轮对话基于 Spring AIChatClient 自定义Advisor实现连贯会话。对话记忆持久化使用FileBasedChatMemory Kryo 序列化将会话状态落盘。RAG 知识库加载恋爱领域 Markdown 文档单身篇/恋爱篇/已婚篇经文档切割 → PGVector 向量存储 → 查询增强实现精准知识问答。结构化输出支持生成恋爱报告等结构化 JSON 输出。工具调用 MCP可调用内置工具和外部 MCP 服务辅助回答。2. AI 超级智能体 YuManus (SuperAgentService)ReAct 架构BaseAgent → ToolCallAgent → ReActAgent → YuManus四层继承体系实现思考 → 行动 → 观察闭环。自主规划根据用户需求自主推理并调用多种工具直至完成目标。SSE 流式输出通过 SSE 实时推送智能体推理过程和结果。3. 内置工具集工具说明WebSearchTool联网搜索SearchAPIWebScrapingTool网页抓取JsoupFileOperationTool文件读写操作ResourceDownloadTool资源下载TerminalOperationTool终端命令执行PDFGenerationToolPDF 文档生成iTextTerminateTool终止智能体执行4. MCP 图片搜索服务 (yu-image-search-mcp-server)独立模块支持SSE和STDIO两种通信模式。提供从特定网站搜索图片的能力可被主应用或其他 MCP 客户端调用。️ 技术栈分类技术框架Spring Boot 3.5 Java 21AI 框架Spring AI 1.0 Spring AI Alibaba LangChain4j大模型阿里云百炼 DashScopeqwen-plus/ Ollama 本地模型向量数据库PGVectorPostgreSQL 扩展数据源Druid 连接池API 文档Knife4j (Swagger)工具库Hutool、Jsoup、iText、Kryo协议MCPModel Context Protocol部署Docker / Serverless 快速开始1. 环境要求JDK 21Maven 3.9PostgreSQL PGVector 扩展如使用 RAG/向量存储特性2. 配置 API Key编辑yu-ai-agent-admin/src/main/resources/application.yml替换以下配置spring:ai:dashscope:api-key:替换为您的API_KEY# 阿里云百炼 DashScopesearch-api:api-key:替换为您的API_KEY# SearchAPI 联网搜索3. 构建 运行# 编译打包mvn clean package-DskipTests# 启动主应用java-jaryu-ai-agent-admin/target/yu-ai-agent-admin-0.0.1-SNAPSHOT.jar# (可选) 启动 MCP 图片搜索服务java-jaryu-image-search-mcp-server/target/yu-image-search-mcp-server-0.0.1-SNAPSHOT.jar4. Docker 部署dockerbuild-tyu-ai-agent.dockerrun-p8123:8123 yu-ai-agent5. 接口文档启动后访问 Knife4j 接口文档http://localhost:8123/api/doc.html 学习大纲本项目覆盖以下核心知识点对应原课程 9 期内容AI 大模型接入— API / SDK / Spring AI / Ollama 本地部署Prompt 工程— 提示词优化技巧与模板Spring AI 核心特性— ChatClient、Advisor、ChatMemory、结构化输出RAG 知识库— 文档 ETL → 向量存储 → 检索增强 → 全链路调优向量数据库— PGVector 集成与配置Tool Calling— 工具定义、注册与自动调用MCP 协议— 服务开发、SSE/STDIO 通信、安全实践AI Agent— ReAct 模式、自主规划智能体开发AI 服务化— SSE 接口、Serverless 部署 声明学习用途本仓库仅用于个人学习与笔记整理无任何商业用途。非官方代码本项目与鱼皮 / 编程导航官方无直接关联仅参考其公开课程内容进行实践。欢迎扩展你可以在此基础上继续扩展自己的 AI Agent 实战项目与实验。仓库代码先赞后看养成习惯^ _ ^ ❤️ ❤️ ❤️码字不易大家的支持就是我的坚持下去的动力。点赞后不要忘了关注我哦