Spring AI 框架入门教程

Spring AI 框架入门教程 & 开源项目推荐

一、Spring AI 框架入门教程

Spring AI 是一个将 AI 能力无缝集成到 Spring 应用的框架，支持大模型集成、向量数据库操作和 RAG 架构实现。

1、 环境准备

JDK 17+ Maven 3.8+ Spring Boot 3.2+

2、 使用Spring Initializr创建项目

3、配置 API Key

• 在application.yml 中添加如下配置

spring:
  ai:
    openai:
      api-key: YOUR_OPENAI_KEY

4、基础使用示例AIController

• 创建AIController控制器类

@RestController
public class AIController {

    private final ChatClient chatClient;

    public AIController(ChatClient chatClient) {
        this.chatClient = chatClient;
    }

    @GetMapping("/ask")
    public String askQuestion(@RequestParam String question) {
        return chatClient.call(question);
    }
}

启动后访问：http://localhost:8080/ask?question=你是谁

5、 核心功能

• ​​Prompt 工程​​

PromptTemplate template = new PromptTemplate("请用{style}风格解释：{topic}");
Prompt prompt = template.create(Map.of("style", "幽默", "topic", "量子力学"));

• 向量数据库集成​​ 在application.yml 中添加如下配置

spring:
  ai:
    vectorstore:
      pgvector:
        enabled: true
        indexType: HNSW

• ​​RAG 架构实现​​

@Bean
VectorStore vectorStore(EmbeddingClient embeddingClient) {
    return new SimpleVectorStore(embeddingClient);
}

6、进阶功能

• 多模态支持（图片/文本混合处理）
• 函数调用（Function Calling）
• 模型微调管理
• 流式响应（Server-Sent Events）
• 官方文档：docs.spring.io/spring-ai/r…
• 中文文档：doc.spring4all.com/spring-ai/r…

二、开源项目推荐：Ruoyi-RAG 企业知识库系统

• 项目地址​​：github.com/zhaoshibao/…

• 核心特性 基于 Spring Boot 3 + Vue 3 的现代化前后端分离架构 内置企业级权限管理（RBAC） ​​RAG 增强检索​​ 多格式文档支持（PDF/Docx/Excel/TXT） 文档自动分块与向量化存储 精准的上下文问答系统 ​​开发者友好​​ 完整的前端可视化知识库管理界面 支持多模型热切换（OpenAI/Ollama）

• 使用场景 企业私有化知识库管理 AI 问答客服系统 商业智能文档分析

• 技术栈 后端 : Spring AI + Spring Boot 3 + Mysql8 前端 :Vue 3 + Element Plus AI模型: OpenAI / Ollama 向量库: Qdrant Vector Store

• 如何贡献？ Star🌟 项目仓库：github.com/zhaoshibao/… 提交 Issues 反馈建议 通过 Pull Request 贡献代码