跳到主要内容
版本:1.1.6

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.1.6</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>

引入 BOM 后,后续所有 org.springframework.ai 依赖无需再写 <version>

2. 模型 Starter

共 19 个模型 Starter,命名规则 spring-ai-starter-model-<vendor>

Starter引入的模型库说明
spring-ai-starter-model-openaispring-ai-openaiOpenAI(Chat + Embedding + Image + Audio + Moderation)
spring-ai-starter-model-ollamaspring-ai-ollamaOllama 本地模型(Chat + Embedding)
spring-ai-starter-model-anthropicspring-ai-anthropicAnthropic Claude 系列
spring-ai-starter-model-azure-openaispring-ai-azure-openaiAzure 托管的 OpenAI 服务
spring-ai-starter-model-deepseekspring-ai-deepseekDeepSeek 对话模型
spring-ai-starter-model-minimaxspring-ai-minimaxMiniMax(Chat + Embedding)
spring-ai-starter-model-mistral-aispring-ai-mistral-aiMistral AI(Chat + Embedding + Moderation)
spring-ai-starter-model-zhipuaispring-ai-zhipuai智谱 AI(Chat + Embedding + Image)
spring-ai-starter-model-vertex-ai-geminispring-ai-vertex-ai-geminiGoogle Vertex AI Gemini Chat
spring-ai-starter-model-vertex-ai-embeddingspring-ai-vertex-ai-embeddingGoogle Vertex AI Embedding
spring-ai-starter-model-bedrockspring-ai-bedrockAWS Bedrock Embedding(Cohere, Titan)
spring-ai-starter-model-bedrock-conversespring-ai-bedrock-converseAWS Bedrock Converse Chat API
spring-ai-starter-model-huggingfacespring-ai-huggingfaceHuggingFace 推理端点
spring-ai-starter-model-oci-genaispring-ai-oci-genaiOracle Cloud Infrastructure GenAI
spring-ai-starter-model-stability-aispring-ai-stability-aiStability AI Image Generation
spring-ai-starter-model-postgresml-embeddingspring-ai-postgresmlPostgresML 数据库内 Embedding
spring-ai-starter-model-transformersspring-ai-transformersONNX 本地 Embedding
spring-ai-starter-model-elevenlabsspring-ai-elevenlabsElevenLabs 文本转语音
spring-ai-starter-model-openai-sdkspring-ai-openai-sdkOpenAI 官方 SDK(Chat + Embedding + Image)

3. 向量数据库 Starter

共 21 个向量数据库 Starter,命名规则 spring-ai-starter-vector-store-<database>

Starter引入的存储库数据库类型
spring-ai-starter-vector-store-pgvectorspring-ai-pgvector-storePostgreSQL 向量扩展
spring-ai-starter-vector-store-pineconespring-ai-pinecone-storePinecone 托管向量库
spring-ai-starter-vector-store-qdrantspring-ai-qdrant-storeQdrant 向量数据库
spring-ai-starter-vector-store-milvusspring-ai-milvus-storeMilvus 向量数据库
spring-ai-starter-vector-store-redisspring-ai-redis-storeRedis
spring-ai-starter-vector-store-weaviatespring-ai-weaviate-storeWeaviate 向量数据库
spring-ai-starter-vector-store-chromaspring-ai-chroma-storeChroma 向量数据库
spring-ai-starter-vector-store-elasticsearchspring-ai-elasticsearch-storeElasticsearch
spring-ai-starter-vector-store-mongodb-atlasspring-ai-mongodb-atlas-storeMongoDB Atlas
spring-ai-starter-vector-store-neo4jspring-ai-neo4j-storeNeo4j 图数据库
spring-ai-starter-vector-store-opensearchspring-ai-opensearch-storeOpenSearch
spring-ai-starter-vector-store-cassandraspring-ai-cassandra-storeApache Cassandra
spring-ai-starter-vector-store-couchbasespring-ai-couchbase-storeCouchbase
spring-ai-starter-vector-store-oraclespring-ai-oracle-storeOracle 数据库
spring-ai-starter-vector-store-azurespring-ai-azure-storeAzure AI Search
spring-ai-starter-vector-store-azure-cosmos-dbspring-ai-azure-cosmos-db-storeAzure Cosmos DB
spring-ai-starter-vector-store-typesensespring-ai-typesense-storeTypesense
spring-ai-starter-vector-store-mariadbspring-ai-mariadb-storeMariaDB
spring-ai-starter-vector-store-gemfirespring-ai-gemfire-storeVMware GemFire

SAP HANA(spring-ai-hanadb-store)和 Oracle Coherence(spring-ai-coherence-store)通过内聚模块引入,无独立 Starter。

4. MCP Starter

Starter说明
spring-ai-starter-mcp-clientMCP 客户端(同步)
spring-ai-starter-mcp-client-webfluxMCP 客户端(WebFlux 异步)
spring-ai-starter-mcp-serverMCP 服务端(同步)
spring-ai-starter-mcp-server-webfluxMCP 服务端(WebFlux)
spring-ai-starter-mcp-server-webmvcMCP 服务端(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 的记忆持久化
spring-ai-starter-model-chat-memory-repository-mongodb基于 MongoDB 的记忆持久化
spring-ai-starter-model-chat-memory-repository-cosmos-db基于 Azure Cosmos DB 的记忆持久化

6. 典型依赖声明

<!-- pom.xml -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-bom</artifactId>
<version>1.1.6</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>