Spring AI 支持 Spring Boot 3.4.x 与 3.5.x 版本。
Spring 初始化器
前往 start.spring.io，勾选你要在新项目中使用的AI 模型和向量存储依赖。
构件仓库
正式版（Releases）—— 使用 Maven 中央仓库
Spring AI 1.0.0 及以上正式版本已发布至 Maven 中央仓库，无需额外配置仓库，只需确保构建文件中已启用 Maven 中央仓库即可。
Maven 配置
Gradle 配置
<!-- Maven 构建默认已包含中央仓库， 通常无需手动显式配置，此处列出仅作说明 --> <repositories> <repository> <id>central</id> <url>https://repo.maven.apache.org/maven2</url> </repository> </repositories>
快照版（Snapshots）—— 添加快照仓库
若要使用最新开发版（如 1.1.0-SNAPSHOT）或 1.0.0 之前的里程碑旧版本，需在项目构建文件中添加以下快照仓库配置。
在 Maven 或 Gradle 构建文件中添加如下仓库定义：
Maven 配置
<repositories> <repository> <id>spring-snapshots</id> <name>Spring 快照仓库</name> <url>https://repo.spring.io/snapshot</url> <!-- 禁用正式版拉取 --> <releases> <enabled>false</enabled> </releases> </repository> <repository> <name>中央门户快照仓库</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>
注意：使用 Maven 引入 Spring AI 快照版时，需留意
settings.xml 中的镜像配置。
若你配置了如下全局镜像：<mirror> <id>my-mirror</id> <mirrorOf>*</mirrorOf> <url>https://my-company-repository.com/maven</url> </mirror>
通配符
* 会将所有仓库请求转发至企业镜像，导致无法访问 Spring 快照仓库。解决方案：修改镜像配置，排除 Spring 快照仓库：
<mirror> <id>my-mirror</id> <mirrorOf>*,!spring-snapshots,!central-portal-snapshots</mirrorOf> <url>https://my-company-repository.com/maven</url> </mirror>
该配置可让 Maven 直接访问 Spring 快照仓库，其余依赖仍走企业镜像。
依赖版本管理
Spring AI 物料清单（BOM）统一定义了当前版本所有依赖的推荐版本。
此 BOM 仅用于依赖版本管理，不包含插件声明，也不直接关联 Spring 或 Spring Boot。
你可以沿用 Spring Boot 父 POM，或通过 Spring Boot 依赖物料清单（
spring-boot-dependencies）管理 Spring Boot 版本。在项目中引入 Spring AI BOM
Maven 配置
<dependencyManagement> <dependencies> <dependency> <groupId>org.springframework.ai</groupId> <artifactId>spring-ai-bom</artifactId> <version>1.0.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement>
引入各类组件依赖
文档后续各章节会分别说明，需为项目构建工具添加对应依赖，涵盖以下组件：
对话模型（Chat Models）
嵌入模型（Embeddings Models）
图像生成模型（Image Generation Models）
语音转文字模型（Transcription Models）
文本转语音模型（TTS Models）
向量数据库（Vector Databases）
Spring AI 示例项目
如需更多 Spring AI 相关学习资源与示例代码，请查阅官方对应页面。
