Spring AI Getting Started

原文：https://docs.spring.io/spring-ai/reference/getting-started.html

Spring AI

入门指南

本节为您提供开始使用Spring AI的起点。

您应根据需求，按照以下各节中的步骤进行操作。

Spring AI 2.0.x 支持 Spring Boot 4.0.x 和 4.1.x。

Spring Initializr

前往 start.spring.io，选择您要在新应用程序中使用的AI模型和向量存储。

工件仓库

正式版 - 使用 Maven Central

Spring AI 的工件可在 Maven Central 获取。无需额外配置仓库。只需确保您的构建文件中已启用 Maven Central 即可。

Maven

Gradle

xml 复制代码

<!-- Maven Central 默认包含在 Maven 构建中。
     通常无需显式配置，此处仅为清晰起见而展示。 -->
<repositories>
    <repository>
        <id>central</id>
        <url>https://repo.maven.apache.org/maven2</url>
    </repository>
</repositories>

快照版 - 添加快照仓库

要使用最新的开发版本（例如 2.0.0-SNAPSHOT），您需要在构建文件中添加以下快照仓库。

将以下仓库定义添加到您的 Maven 或 Gradle 构建文件中：

Maven

Gradle

xml 复制代码

<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>

注意： 在使用 Spring AI 快照版时，请注意您的 Maven 镜像配置。如果您在 settings.xml 中配置了类似这样的镜像：

xml 复制代码

<mirror>
    <id>my-mirror</id>
    <mirrorOf>*</mirrorOf>
    <url>https://my-company-repository.com/maven</url>
</mirror>

通配符 * 会将所有仓库请求重定向到您的镜像，从而阻止访问 Spring 快照仓库。要解决此问题，请修改 mirrorOf 配置以排除 Spring 仓库：

xml 复制代码

<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）声明了 Spring AI 特定版本所使用的所有依赖项的推荐版本。这是一个仅包含 BOM 的版本，只包含依赖管理，没有插件声明或对 Spring 或 Spring Boot 的直接引用。您可以使用 Spring Boot 父 POM，或使用 Spring Boot 的 BOM（spring-boot-dependencies）来管理 Spring Boot 版本。

将 BOM 添加到您的项目中：

Maven

Gradle

xml 复制代码

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-bom</artifactId>
            <version>2.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

为特定组件添加依赖

文档中以下各节将说明您需要为项目构建系统添加哪些依赖项。

聊天模型
嵌入模型
图像生成模型
转录模型
文本转语音（TTS）模型
向量数据库

Spring AI 示例

请参阅此页面以获取与 Spring AI 相关的更多资源和示例。