入門

このセクションでは、Spring AI の使用を開始するための出発点を提供します。

必要に応じて、次の各セクションの手順に従う必要があります。

Spring AI は Spring Boot 3.4.x をサポートしています。Spring Boot 3.5.x がリリースされたら、こちらもサポートする予定です。

Spring Initializr

start.spring.io に進み、新しいアプリケーションで使用する AI モデルとベクトルストアを選択します。

アーティファクトリポジトリ

マイルストーン - Maven セントラルを使用する

1.0.0-M6 の時点で、リリースは Maven Central で利用できます。ビルドファイルに変更を加える必要はありません。

スナップショット - スナップショットリポジトリの追加

スナップショット (および 1.0.0-M6 マイルストーン以前) バージョンを使用するには、ビルドファイルに次のスナップショットリポジトリを追加する必要があります。

Maven または Gradle ビルドファイルに次のリポジトリ定義を追加します。

  • Maven

  • Gradle

<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>
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/'
  }
}

NOTE : Maven を 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（spring-boot-dependencies）の BOM を使用して Spring Boot のバージョンを管理できます。

プロジェクトに BOM を追加します。

  • Maven

  • Gradle

<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 も使用できます。これは、Gradle ビルドスクリプトの依存関係セクションに「プラットフォーム」依存関係ハンドラーメソッドを追加することで実装されます。

特定のコンポーネントの依存関係を追加する

ドキュメントの次の各セクションでは、プロジェクトビルドシステムに追加する必要がある依存関係を示します。

Spring AI サンプル

Spring AI に関連するその他のリソースとサンプルについては、このページ [GitHub] (英語) を参照してください。