# spring-ai-sample

**Repository Path**: guanxuc/spring-ai-sample

## Basic Information

- **Project Name**: spring-ai-sample
- **Description**: spring ai 最佳实践
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-18
- **Last Updated**: 2025-11-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

该项目是一个基于Spring框架的AI聊天客户端和服务端实现，包含多种功能模块。以下是项目的简要说明：

### 项目结构

- **spring-ai-chatclient**: 提供AI聊天功能的客户端实现，包括聊天、流式响应、记忆管理、评估等功能。
- **spring-ai-mcpserver**: 提供MCP服务器功能，包含工具注册和服务配置。
- **spring-ai-multimodel**: 支持多模型的AI聊天控制器，可以切换不同的AI模型进行交互。

### 主要功能

- **ChatClient**: 提供REST API用于与AI模型交互，支持普通聊天、流式聊天、记忆管理、RAG（检索增强生成）等功能。
- **Evaluator**: 提供评估功能，包括相关性评估和事实核查。
- **VectorStore**: 提供向量存储功能，支持添加、搜索、删除向量数据。
- **MCP Server**: 提供MCP服务器功能，支持工具注册和服务配置。
- **MultiModel**: 支持多模型的AI聊天控制器，可以切换不同的AI模型进行交互。

### 使用技术

- Spring Boot
- Spring WebFlux (用于流式响应)
- JPA/Hibernate
- MySQL (用于存储聊天记录和向量数据)
- Redis (用于缓存)
- AI SDKs (如Qwen, DeepSeek等)

### 启动方式

1. 确保已安装Java 17+ 和 Maven。
2. 配置数据库连接信息（MySQL）和Redis连接信息。
3. 执行以下命令启动项目：

```bash
mvn clean install
mvn spring-boot:run
```

### API文档

API文档可通过访问 `/swagger-ui.html` 查看。

### 许可证

该项目遵循 MIT 许可证。