Spring AI Test

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 的容器