# oliver-ai-agent

**Repository Path**: wen-jinzhao/oliver-ai-agent

## Basic Information

- **Project Name**: oliver-ai-agent
- **Description**: 这个一个使用Spring AI 开发的 Java AI 应用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 3
- **Created**: 2025-05-01
- **Last Updated**: 2025-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: SpringAI, SpringBoot3, RAG, AI

## README




# Oliver AI Agent

## 项目简介

Oliver AI Agent 是一个基于 Spring AI 框架构建的智能助手平台，提供两个专业化的 AI 助手服务：AI 恋爱大师和 AI 超级智能体。 

该项目集成了阿里云百炼平台的大语言模型能力，支持 RAG（检索增强生成）、工具集成、向量数据库等先进的 AI 技术，为用户提供智能化的对话体验。 

## 核心功能

### 🤖 双AI助手服务

**AI 恋爱大师**
- 智能情感咨询助手，为您解答情感困惑
- 智能情感洞察
- 专属恋爱锦囊  
- 秒级互动体验

**AI 超级智能体**
- 全能AI助手，解答您的各类问题
- 多步推理·深度思考
- 智能工具·高效分析
- 复杂难题·一键解决 

### 🔧 强大的工具集成

系统集成了多种实用工具，包括：
- 文件操作工具
- 网络搜索工具
- 网页抓取工具
- 资源下载工具
- 终端操作工具
- PDF生成工具 

### 📚 RAG检索增强生成

支持本地和云端双重RAG策略：
- 本地向量数据库（SimpleVectorStore + PostgreSQL）
- 阿里云百炼知识库服务
- Markdown文档智能解析
- 元数据增强和过滤检索 

## 技术栈

### 后端技术
- **框架**: Spring Boot 3.4.4 + Java 21 
- **AI框架**: Spring AI + 阿里云百炼平台 
- **数据库**: MySQL + PostgreSQL(向量数据库) 
- **ORM**: MyBatis-Plus 
- **工具库**: Hutool、Lombok 
- **API文档**: Knife4J 

### 前端技术
- **框架**: Vue.js + Vite 
- **构建工具**: Vite
- **用户界面**: 响应式设计，支持移动端
- **开发工具**：Cursor

## 快速开始

### 环境要求
- Java 21+ [12](#0-11) 
- MySQL 8.0+
- Node.js 16+ (前端开发)
- Maven 3.6+

### 安装部署

1. **克隆项目**
```bash
git clone https://github.com/Oliver0119/oliver-ai-agent.git
cd oliver-ai-agent
```

2. **配置数据库**
   - 创建 MySQL 数据库 `ai_agent`
   - 配置数据库连接信息 

3. **配置阿里云API密钥**
   - 在配置文件中设置阿里云DashScope API密钥
   - 配置搜索API密钥 

4. **启动后端服务**
```bash
mvn spring-boot:run
```

5. **启动前端服务**
```bash
cd oliver-ai-agent-frontend
npm install
npm run dev
```

### 访问地址
- 前端界面: http://localhost:5173
- 后端API: http://localhost:8123/api
- API文档: http://localhost:8123/api/swagger-ui.html 

## 应用架构

项目采用前后端分离架构：
- **后端**: 基于Spring Boot的RESTful API服务
- **前端**: Vue.js单页应用
- **AI引擎**: Spring AI + 阿里云百炼平台
- **数据存储**: MySQL业务数据 + PostgreSQL向量数据

## 主要模块

### Agent模块
智能体核心逻辑，包含：
- 基础Agent抽象类
- 恋爱大师实现
- 超级智能体实现

### RAG模块  
检索增强生成功能：
- 向量数据库配置
- 文档加载器
- 知识库检索

### Tools模块
工具集成框架：
- 工具注册中心
- 各类实用工具实现
- MCP客户端支持 

## 贡献指南

欢迎提交 Issue 和 Pull Request 来帮助改进项目。

## 许可证

本项目采用开源许可证，详情请查看 LICENSE 文件。

## 联系方式

- 项目地址: https://github.com/Oliver0119/oliver-ai-agent
- Gitee镜像: https://gitee.com/wen-jinzhao/oliver-ai-agent 

---

**Notes**

此README基于项目的实际代码结构和配置生成，涵盖了项目的核心功能、技术栈、部署方式等关键信息。项目使用了现代化的技术栈，包括Spring AI框架、阿里云百炼平台、Vue.js前端等，提供了完整的AI助手解决方案。通过RAG技术和工具集成，能够为用户提供智能化的对话体验。