开始

本节提供了如何开始使用 Spring AI 的起点。spring-doc.cadn.net.cn

您应该根据需要按照以下每个部分中的步骤进行作。spring-doc.cadn.net.cn

Spring AI 支持 Spring Boot 3.2.x 和 3.3.x

Spring 初始化

前往 start.spring.io 并选择要在新应用程序中使用的 AI 模型和矢量存储。spring-doc.cadn.net.cn

构件存储库

里程碑 - 使用 Maven Central

从 1.0.0-M6 开始，Maven Central 中提供了版本。 无需更改您的构建文件。spring-doc.cadn.net.cn

快照 - 添加快照存储库

要使用 Snapshot（以及 1.0.0-M6 之前的里程碑）版本，您需要在构建文件中添加以下快照存储库。spring-doc.cadn.net.cn

将以下存储库定义添加到您的 Maven 或 Gradle 构建文件中：spring-doc.cadn.net.cn

<repositories>
  <repository>
    <id>spring-milestones</id>
    <name>Spring Milestones</name>
    <url>https://repo.spring.io/milestone</url>
    <snapshots>
      <enabled>false</enabled>
    </snapshots>
  </repository>
  <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>
repositories {
  mavenCentral()
  maven { url 'https://repo.spring.io/milestone' }
  maven { url 'https://repo.spring.io/snapshot' }
  maven {
    name = 'Central Portal Snapshots'
    url = 'https://central.sonatype.com/repository/maven-snapshots/'
  }
}

依赖关系管理

Spring AI 物料清单 （BOM） 声明了给定版本的 Spring AI 使用的所有依赖项的推荐版本。 从应用程序的构建脚本中使用 BOM 可以避免您自己指定和维护依赖项版本。 相反，您使用的 BOM 版本决定了使用的依赖项版本。 它还确保您默认使用受支持且经过测试的依赖项版本，除非您选择覆盖它们。spring-doc.cadn.net.cn

将 BOM 添加到您的项目中：spring-doc.cadn.net.cn

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-bom</artifactId>
            <version>1.0.0-SNAPSHOT</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
dependencies {
  implementation platform("org.springframework.ai:spring-ai-bom:1.0.0-SNAPSHOT")
  // Replace the following with the starter dependencies of specific modules you wish to use
  implementation 'org.springframework.ai:spring-ai-openai'
}

Gradle 用户还可以通过利用 Gradle （5.0+） 原生支持来使用 Maven BOM 声明依赖项约束，从而使用 Spring AI BOM。 这是通过将“platform”依赖项处理程序方法添加到 Gradle 构建脚本的 dependencies 部分来实现的。 如下面的代码片段所示，这之后可以跟着您希望使用的一个或多个 spring-ai 模块的 Starter Dependencies 的无版本声明，例如 spring-ai-openai。spring-doc.cadn.net.cn

为特定组件添加依赖项

文档中的以下每个部分都显示了您需要添加到项目构建系统中的依赖项。spring-doc.cadn.net.cn

Spring AI 示例

有关与 Spring AI 相关的更多资源和示例，请参阅此页面。spring-doc.cadn.net.cn