Testcontainers

Spring AI 提供了 Spring Boot 自动配置，用于建立与通过 Testcontainers 运行的模型服务或向量存储的连接。要启用它，请将以下依赖项添加到项目的 Maven pom.xml 文件中：

<dependency>
   <groupId>org.springframework.ai</groupId>
   <artifactId>spring-ai-spring-boot-testcontainers</artifactId>
</dependency>

或添加到 Gradle build.gradle 构建文件中。

dependencies {
    implementation 'org.springframework.ai:spring-ai-spring-boot-testcontainers'
}

依赖管理

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")
  // 替换为你需要使用的具体模块的 starter 依赖
  implementation 'org.springframework.ai:spring-ai-openai'
}

Gradle 用户也可通过 Gradle（5.0+）原生支持的 Maven BOM 依赖约束方式使用 Spring AI BOM。只需在 Gradle 构建脚本的 dependencies 部分添加 ‘platform’ 依赖处理方法即可。

服务连接

spring-ai-spring-boot-testcontainers 模块中提供了以下服务连接工厂：

连接详情	匹配条件
`AwsOpenSearchConnectionDetails`	类型为 `LocalStackContainer` 的容器
`ChromaConnectionDetails`	类型为 `ChromaDBContainer` 的容器
`MilvusServiceClientConnectionDetails`	类型为 `MilvusContainer` 的容器
`MongoConnectionDetails`	类型为 `MongoDBAtlasLocalContainer` 的容器
`OllamaConnectionDetails`	类型为 `OllamaContainer` 的容器
`OpenSearchConnectionDetails`	类型为 `OpensearchContainer` 的容器
`QdrantConnectionDetails`	类型为 `QdrantContainer` 的容器
`TypesenseConnectionDetails`	类型为 `TypesenseContainer` 的容器
`WeaviateConnectionDetails`	类型为 `WeaviateContainer` 的容器