2.Spring AI 入门指南

吴祖贤
33 阅读2分钟

Spring AI 入门指南

概述

本节提供了如何开始使用Spring AI的入门指导。您应该根据自己的需求，按照以下各个部分的步骤进行操作。

注意： Spring AI支持Spring Boot 3.4.x。当Spring Boot 3.5.x发布时，我们也将支持该版本。

Spring Initializr

请访问 start.spring.io 并选择您希望在新应用程序中使用的AI模型和向量存储。

构件仓库

里程碑版本 - 使用Maven Central

从1.0.0-M6版本开始，发布版本已经在Maven Central中可用。无需修改您的构建文件。

快照版本 - 添加快照仓库

要使用快照版本（以及1.0.0-M6之前的里程碑版本），您需要在构建文件中添加以下快照仓库。

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

Maven
<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>
Gradle
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快照版本时，请注意您的Maven镜像配置。如果您在settings.xml中配置了像这样的镜像：

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

通配符*会将所有仓库请求重定向到您的镜像，从而阻止访问Spring快照仓库。要解决此问题，请修改mirrorOf配置以排除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）声明了Spring AI给定版本使用的所有依赖项的推荐版本。这是一个仅包含BOM的版本，它只包含依赖管理，没有插件声明或对Spring或Spring Boot的直接引用。您可以使用Spring Boot父POM，或使用来自Spring Boot的BOM（spring-boot-dependencies）来管理Spring Boot版本。

将BOM添加到您的项目中：

Maven
<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>
Gradle
dependencies {
  implementation platform("org.springframework.ai:spring-ai-bom:1.0.0-SNAPSHOT")
  // 将以下内容替换为您希望使用的特定模块的启动器依赖项
  implementation 'org.springframework.ai:spring-ai-openai'
}

Gradle用户还可以通过利用Gradle（5.0+）对使用Maven BOM声明依赖约束的原生支持来使用Spring AI BOM。这是通过在Gradle构建脚本的dependencies部分添加'platform'依赖处理程序方法来实现的。

为特定组件添加依赖项

文档中的以下每个部分都显示了需要向项目构建系统添加哪些依赖项：

avatar
文章
阅读
粉丝