当前位置：首页 > java >正文

1. Spring AI概述

java 2025/7/20 12:19:22

一、前言

Spring AI 是由 Spring 团队推出的开源项目，旨在为 Java 开发者提供简洁、一致的 Spring 风格开发体验，用于构建基于生成式人工智能（GenAI）和大型语言模型（LLM）的应用程序。它通过标准化抽象层简化了 AI 能力的集成，降低开发门槛。

本专栏根据Spring AI官方文档和优秀的开源项目，并结合实际的业务思考，一方面是自己学习过程的记录和梳理，另一方面也希望能帮助读者以最小阻力快速地掌握Spring AI的核心开发能力！

二、Spring AI到底能干什么

提供跨 AI 供应商（如 OpenAI、Anthropic、Hugging Face 等）的一致性 API ；
支持多种 LLM 模型（文本、向量、语音、图像、多模态模型等）；
提示工程内置模板和动态提示管理，支持结构化灵活转化，如转JAVA对象POJO；
向量存储集成，支持 Pinecone、Redis、Elasticsearch 等向量数据库，实现检索增强生成（RAG）；
模型上下文协议（MCP），动态扩展 AI 工具（如 Web 搜索、数据库操作等）；
.......

总之Spring AI 能完成几乎所有大语言模型落地场景的需求，并且大大降低开发难度！

三、环境要求

3.1 版本说明

Spring boot : 3.4.5
Java : 17
Spring AI 1.0.0 GA (生产稳定版本)

3.2 Spring AI生产版本

截至到目前2025年7月，Spring AI目前最新的生产版本是 1.0.0 GA，该版本功能完善，支持同步/流式调用、多模型切换、工具调用等企业级特性，是生产环境首选，ChatClient （高级封装）成为官方推荐的核心 API ！

3.3 Spring AI快照版本

截至到目前2025年7月，Spring AI目前最新的快照版本是 1.0.0-SNAPSHOT，快照版本仅发布在 Spring 官方快照仓库中，开发者必须显式配置该仓库地址，否则项目将无法解析 spring-ai-bom 或相关 Starter 依赖（如 spring-ai-openai-spring-boot-starter）

<!--配置Spring AI 的快照仓库-->
<repositories><repository><id>spring-snapshots</id><name>Spring Snapshots</name><url>https://repo.spring.io/snapshot</url><releases><enabled>false</enabled></releases></repository><repository><name>Central Portal Snapshots</name><id>central-portal-snapshots</id><url>https://central.sonatype.com/repository/maven-snapshots/</url><releases><enabled>false</enabled></releases><snapshots><enabled>true</enabled></snapshots></repository>
</repositories>

PS : 注意如果我们maven配置了仓库（如阿里云公共仓库），会覆盖所有仓库，导致 Maven 只从阿里云仓库下载依赖，而阿里云仓库中没有 Spring AI 的快照版本。需要在 settings.xml 的 <mirrors> 中排除 spring-snapshots 和 central-portal-snapshots, 比如：

<mirror><id>aliyunmaven</id><name>阿里云公共仓库</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>*,!spring-snapshots,!central-portal-snapshots</mirrorOf>
</mirror>

3.4 依赖管理

spring-ai-bom 是 Spring AI 项目的 Bill of Materials (BOM，物料清单)。它的核心作用是集中管理 Spring AI 相关依赖项的版本。即内部定义了Spring AI模块（例如 spring-ai-openai, spring-ai-azure-openai等）以及它们所依赖的第三方库的推荐兼容版本，当你声明 Spring AI 模块依赖时（如 spring-ai-openai），不再需要手动指定版本号 <version>。BOM 会自动为你提供该版本号。

  <!--Spring AI模块的依赖版本管理--><dependencyManagement><dependencies><dependency><groupId>org.springframework.ai</groupId><artifactId>spring-ai-bom</artifactId><!--正式生产版本：1.0.0 GA（2025年5月20日发布）是首个稳定且支持生产环境的版本，ChatClient 成为官方推荐的核心 API--><version>1.0.0</version> <!-- GA 版本 --><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement>