入門

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

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

Spring AI は Spring Boot 3.4.x と 3.5.x をサポートします。

Spring Initializr

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

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

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

Spring AI 1.0.0 以降のバージョンは Maven Central で利用可能です。追加のリポジトリ設定は必要ありません。ビルドファイルで Maven Central が有効になっていることを確認してください。

<!-- Maven Central is included by default in Maven builds.
     You usually don’t need to configure it explicitly,
     but it's shown here for clarity. -->
<repositories>
    <repository>
        <id>central</id>
        <url>https://repo.maven.apache.org/maven2</url>
    </repository>
</repositories>
repositories {
    mavenCentral()
}

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

最新の開発バージョン (例: 1.1.0-SNAPSHOT) または 1.0.0 より前のマイルストーンバージョンを使用するには、ビルドファイルに次のスナップショットリポジトリを追加する必要があります。

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</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>
dependencies {
  implementation platform("org.springframework.ai:spring-ai-bom:1.0.0")
  // Replace the following with the specific module dependencies (e.g., spring-ai-openai) or starter modules (e.g., spring-ai-starter-model-openai) that 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] (英語) を参照してください。