升级说明

Common Artifact ID 变更

Common 包变更

Common 模块结构

删除了所有弃用的代码 (76bee8c) 和 (b6ce7f3)

移除了 1.0.0-M8 中的所有弃用项 (76bee8c)

常规弃用项清理 (b6ce7f3)

常见构件 ID 变更

常见包变更

常见模块结构

spring.ai.<provider>.chat.enabled

spring.ai.<provider>.embedding.enabled

spring.ai.<provider>.image.enabled

spring.ai.<provider>.moderation.enabled

spring.ai.model.audio.speech=<model-provider|none>

spring.ai.model.audio.transcription=<model-provider|none>

spring.ai.model.chat=<model-provider|none>

spring.ai.model.embedding=<model-provider|none>

spring.ai.model.embedding.multimodal=<model-provider|none>

spring.ai.model.embedding.text=<model-provider|none>

spring.ai.model.image=<model-provider|none>

spring.ai.model.moderation=<model-provider|none>

模型 Starter：spring-ai-{model}-spring-boot-starter → spring-ai-starter-model-{model}

向量存储 Starter：spring-ai-{store}-store-spring-boot-starter → spring-ai-starter-vector-store-{store}

MCP Starter：spring-ai-mcp-{type}-spring-boot-starter → spring-ai-starter-mcp-{type}

KeywordMetadataEnricher 和 SummaryMetadataEnricher 已从 org.springframework.ai.transformer 迁移至 org.springframework.ai.chat.transformer 包。

Content、MediaContent 和 Media 已从 org.springframework.ai.model 迁移至 org.springframework.ai.content 包。

spring-ai-commons （基础层）

spring-ai-model （依赖于 commons）

spring-ai-vector-store 和 spring-ai-client-chat （两者均依赖于 model）

spring-ai-advisors-vector-store 和 spring-ai-rag （依赖于 client-chat 和 vector-store 两者）

spring-ai-model-chat-memory-* 模块（依赖于 client-chat）

通过默认的 FunctionCallingOptions 实例的 functions() 方法传递的任何工具，都会包含在该 ChatModel 实例每次对模型的调用中，可能会被运行时选项覆盖。

通过默认的 FunctionCallingOptions 实例的 functionCallbacks() 方法传递的任何工具，仅用于运行时动态解析（参见 工具解析），但除非明确请求，否则不会包含在任何对模型的调用中。

通过默认的 FunctionCallingOptions 实例的 functions() 方法或 functionCallbacks() 方法传递的任何工具，现在以相同的方式处理：它会被包含在该 ChatModel 实例每次对模型的调用中，可能会被运行时选项覆盖。这样一来，工具在模型调用中的包含方式保持了一致性，避免了之前 functionCallbacks() 与其他选项之间行为差异所导致的混淆。

spring-ai-qdrant → spring-ai-qdrant-store

spring-ai-cassandra → spring-ai-cassandra-store

spring-ai-pinecone → spring-ai-pinecone-store

spring-ai-redis → spring-ai-redis-store

spring-ai-qdrant → spring-ai-qdrant-store

spring-ai-gemfire → spring-ai-gemfire-store

spring-ai-azure-vector-store-spring-boot-starter → spring-ai-azure-store-spring-boot-starter

spring-ai-redis-spring-boot-starter → spring-ai-starter-vector-store-redis

将提示（prompt）、消息（messages）和元数据（metadata）包迁移至 org.springframework.ai.chat 的子包下。

新增 model 包，包含支持创建任意输入/输出数据类型组合的 AI 模型客户端的接口与基类。目前聊天模型和图像模型包已实现该结构，嵌入模型包也将很快适配此新模型。

新的 “可移植选项” 设计模式。我们希望在 ModelCall 中尽可能多地提供基于聊天的 AI 模型的可移植性。有一组通用的生成选项，还有一些特定于模型提供者的选项。我们使用了一种 “鸭子类型” 的方法。模型包中的 ModelOptions 是一个标记接口，表示该类的实现将为模型提供选项。请参见 ImageOptions，它是一个子接口，定义了所有文本→图像 ImageModel 实现中的可移植选项。然后，StabilityAiImageOptions 和 OpenAiImageOptions 为每个模型提供者提供特定的选项。所有选项类都是通过 Fluent API Builder 创建的，都可以传入可移植的 ImageModel API。这些选项数据类型用于 ImageModel 实现的自动配置/配置属性。

spring.ai.openai.model → spring.ai.openai.chat.options.model

spring.ai.openai.temperature → spring.ai.openai.chat.options.temperature

用 SimpleVectorStore 取代 InMemoryVectorStore

将 org.springframework.ai.ollama.client.OllamaClient 替换为 org.springframework.ai.olama.OllamaModelCall。

OllamaChatClient 方法签名已更改。

将 org.springframework.ai.autoconfigure.ollama.OllamaProperties 重命名为 org.springframework.ai.model.olama.autoconfigure.OllamaChatProperties，并将后缀改为 spring.ai.ollama.chat。部分属性也已变更。

将 AiClient 重命名为 ChatClient

将 AiResponse 重命名为 ChatResponse

将 AiStreamClient 更名为 StreamingChatClient

将包 org.sf.ai.client 更名为 org.sf.ai.chat

transformers-embedding 更名为 spring-ai-transformers

从 org.springframework.experimental.ai 替换为 org.springframework.ai。

Azure OpenAI

<dependency>
    <groupId>org.springframework.experimental.ai</groupId>
    <artifactId>spring-ai-azure-openai-spring-boot-starter</artifactId>
    <version>0.7.1-SNAPSHOT</version>
</dependency>

OpenAI

<dependency>
    <groupId>org.springframework.experimental.ai</groupId>
    <artifactId>spring-ai-openai-spring-boot-starter</artifactId>
    <version>0.7.1-SNAPSHOT</version>
</dependency>