Maven 速查
Spring AI 通过 BOM 统一管理版本,通过 Starter 提供开箱即用的 Spring Boot 集成。
1. BOM
在 pom.xml 的 <dependencyManagement> 中引入 BOM,即可统一管理所有 Spring AI 依赖的版本号:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-bom</artifactId>
<version>1.0.3</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
引入 BOM 后,后续所有 org.springframework.ai 依赖无需再写 <version>。
2. 模型 Starter
共 17 个模型 Starter,命名规则 spring-ai-starter-model-<vendor>。
| Starter | 引入的模型库 | 说明 |
|---|---|---|
spring-ai-starter-model-openai | spring-ai-openai | OpenAI(Chat + Embedding + Image + Audio + Moderation) |
spring-ai-starter-model-ollama | spring-ai-ollama | Ollama 本地模型(Chat + Embedding) |
spring-ai-starter-model-anthropic | spring-ai-anthropic | Anthropic Claude 系列 |
spring-ai-starter-model-azure-openai | spring-ai-azure-openai | Azure 托管的 OpenAI 服务 |
spring-ai-starter-model-deepseek | spring-ai-deepseek | DeepSeek 对话模型 |
spring-ai-starter-model-minimax | spring-ai-minimax | MiniMax(Chat + Embedding) |
spring-ai-starter-model-mistral-ai | spring-ai-mistral-ai | Mistral AI(Chat + Embedding + Moderation) |
spring-ai-starter-model-zhipuai | spring-ai-zhipuai | 智谱 AI(Chat + Embedding + Image) |
spring-ai-starter-model-vertex-ai-gemini | spring-ai-vertex-ai-gemini | Google Vertex AI Gemini Chat |
spring-ai-starter-model-vertex-ai-embedding | spring-ai-vertex-ai-embedding | Google Vertex AI Embedding |
spring-ai-starter-model-bedrock | spring-ai-bedrock | AWS Bedrock Embedding(Cohere, Titan) |
spring-ai-starter-model-bedrock-converse | spring-ai-bedrock-converse | AWS Bedrock Converse Chat API |
spring-ai-starter-model-huggingface | spring-ai-huggingface | HuggingFace 推理端点 |
spring-ai-starter-model-oci-genai | spring-ai-oci-genai | Oracle Cloud Infrastructure GenAI |
spring-ai-starter-model-stability-ai | spring-ai-stability-ai | Stability AI Image Generation |
spring-ai-starter-model-postgresml-embedding | spring-ai-postgresml | PostgresML 数据库内 Embedding |
spring-ai-starter-model-transformers | spring-ai-transformers | ONNX 本地 Embedding |
3. 向量数据库 Starter
共 21 个向量数据库 Starter,命名规则 spring-ai-starter-vector-store-<database>。
| Starter | 引入的存储库 | 数据库类型 |
|---|---|---|
spring-ai-starter-vector-store-pgvector | spring-ai-pgvector-store | PostgreSQL 向量扩展 |
spring-ai-starter-vector-store-pinecone | spring-ai-pinecone-store | Pinecone 托管向量库 |
spring-ai-starter-vector-store-qdrant | spring-ai-qdrant-store | Qdrant 向量数据库 |
spring-ai-starter-vector-store-milvus | spring-ai-milvus-store | Milvus 向量数据库 |
spring-ai-starter-vector-store-redis | spring-ai-redis-store | Redis |
spring-ai-starter-vector-store-weaviate | spring-ai-weaviate-store | Weaviate 向量数据库 |
spring-ai-starter-vector-store-chroma | spring-ai-chroma-store | Chroma 向量数据库 |
spring-ai-starter-vector-store-elasticsearch | spring-ai-elasticsearch-store | Elasticsearch |
spring-ai-starter-vector-store-mongodb-atlas | spring-ai-mongodb-atlas-store | MongoDB Atlas |
spring-ai-starter-vector-store-neo4j | spring-ai-neo4j-store | Neo4j 图数据库 |
spring-ai-starter-vector-store-opensearch | spring-ai-opensearch-store | OpenSearch |
spring-ai-starter-vector-store-cassandra | spring-ai-cassandra-store | Apache Cassandra |
spring-ai-starter-vector-store-couchbase | spring-ai-couchbase-store | Couchbase |
spring-ai-starter-vector-store-oracle | spring-ai-oracle-store | Oracle 数据库 |
spring-ai-starter-vector-store-azure | spring-ai-azure-store | Azure AI Search |
spring-ai-starter-vector-store-azure-cosmos-db | spring-ai-azure-cosmos-db-store | Azure Cosmos DB |
spring-ai-starter-vector-store-typesense | spring-ai-typesense-store | Typesense |
spring-ai-starter-vector-store-mariadb | spring-ai-mariadb-store | MariaDB |
spring-ai-starter-vector-store-gemfire | spring-ai-gemfire-store | VMware GemFire |
SAP HANA(spring-ai-hanadb-store)和 Oracle Coherence(spring-ai-coherence-store)通过内聚模块引入,无独立 Starter。
4. MCP Starter
| Starter | 说明 |
|---|---|
spring-ai-starter-mcp-client | MCP 客户端(同步) |
spring-ai-starter-mcp-client-webflux | MCP 客户端(WebFlux 异步) |
spring-ai-starter-mcp-server | MCP 服务端(同步) |
spring-ai-starter-mcp-server-webflux | MCP 服务端(WebFlux) |
spring-ai-starter-mcp-server-webmvc | MCP 服务端(WebMVC) |
5. ChatMemory Starter
| Starter | 说明 |
|---|---|
spring-ai-starter-model-chat-memory | 聊天记忆基础 Starter |
spring-ai-starter-model-chat-memory-repository-jdbc | 基于 JDBC 的记忆持久化 |
spring-ai-starter-model-chat-memory-repository-cassandra | 基于 Cassandra 的记忆持久化 |
spring-ai-starter-model-chat-memory-repository-neo4j | 基于 Neo4j 的记忆持久化 |
6. 典型依赖声明
- 配合 BOM(推荐)
- 不使用 BOM
<!-- pom.xml -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-bom</artifactId>
<version>1.0.3</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<!-- 无需写版本号 -->
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-model-ollama</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-vector-store-pgvector</artifactId>
</dependency>
</dependencies>
<dependencies>
<!-- 需要显式指定版本 -->
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-model-ollama</artifactId>
<version>1.0.3</version>
</dependency>
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-starter-vector-store-pgvector</artifactId>
<version>1.0.3</version>
</dependency>
</dependencies>