# jx-ai-agent

**Repository Path**: cold-abyss_admin/jx-ai-agent

## Basic Information

- **Project Name**: jx-ai-agent
- **Description**: JX-AI-Agent 是一个多智能体集合平台 
目前支持 恋爱咨询智能问答 即将支持 超级智能体
Spring Boot + Spring AI alibaba 1.1 + pgvector+Rag
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-16
- **Last Updated**: 2026-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# JX-AI-Agent

基于 Spring AI 框架开发的智能对话应用，提供增强的 RAG（检索增强生成）能力和对话记忆功能。

## 项目简介

JX-AI-Agent 是一个智能对话系统，采用 Spring Boot + Spring AI 技术栈构建，集成了阿里云 DashScope 大语言模型服务。核心功能包括：

- **智能对话**：基于大语言模型的自然语言交互
- **RAG 检索增强**：支持向量存储和文档检索，提升回答质量
- **对话记忆**：基于文件的会话历史存储，支持多会话管理
- **云端 RAG**：云端文档检索与问答能力

## 技术栈

- Java 17+
- Spring Boot 3.x
- Spring AI
- 阿里云 DashScope (通义千问)
- Vector Store (向量数据库)
- Kryo (序列化)

## 快速开始

### 环境要求

- JDK 17 或更高版本
- Maven 3.8+
- 阿里云 DashScope API Key

### 配置

在 `src/main/resources/application.yml` 中配置：

```yaml
spring:
  ai:
    dashscope:
      api-key: your-api-key
```

### 构建运行

```bash
# 编译项目
./mvnw clean package -DskipTests

# 启动应用
./mvnw spring-boot:run
```

## 核心功能

### 1. 智能对话 (LoveApp)

`LoveApp` 是核心对话服务类，提供多种对话模式：

- **基本对话**：`doChat(String message, String chatId)` - 简单对话交互
- **报告生成**：`doChatWithReport()` - 返回结构化建议报告
- **RAG 对话**：`doChatWithRag()` - 基于向量检索的增强对话

### 2. 对话记忆

`FileBasedChatMemory` 提供基于文件的会话记忆：

- 支持多会话并发管理
- 使用 Kryo 序列化存储
- 可配置最大消息数

### 3. RAG 检索增强

- **文档加载**：`LoveAppDocumentLoader` - 从 Markdown 文件加载知识库
- **向量存储**：`LoveAppVectorStoreConfig` - 配置向量嵌入存储
- **云端 RAG**：`LoveAppCloudRAGAdvisor` - 云端文档检索能力

### 4. 增强 advisors

- **日志增强**：`JxLoveAppLoggerAdvisor` - 请求响应日志记录
- **重读增强**：`ReReadingAdvisor` - 优化模型输出的Advisor

## 项目结构

```
src/main/java/com/hyc/jxaiagent/
├── JxAiAgentApplication.java    # 启动类
├── advisor/                     # Advisor 增强组件
├── app/                         # 核心业务应用
├── chatmemory/                  # 对话记忆模块
├── controller/                  # 控制器
├── demo/invoke/                 # 调用示例
└── rag/                         # RAG 检索增强
```

## API 端点

| 端点 | 方法 | 描述 |
|------|------|------|
| `/health` | GET | 健康检查 |

## 测试

项目包含单元测试和集成测试：

```bash
# 运行所有测试
./mvnw test

# 运行特定测试类
./mvnw test -Dtest=LoveAppTest
```

## 许可证

本项目仅供学习交流使用。