升级说明

在构建Prompt从 ChatClient 输入中，SystemMessage构建自systemText()现在，它位于邮件列表的首位。以前，它被放在最后，导致多个模型提供程序出错。spring-doc.cadn.net.cn

MessageAggregator具有一种新方法，用于聚合来自ChatClientRequest.前面的方法聚合来自旧AdvisedRequest已被删除，因为它已在 M8 中标记为已弃用。spring-doc.cadn.net.cn

这ChatClient已得到增强，可以解决在 advisor 中使用用户和系统提示之前未呈现时的一些不一致或不需要的行为。新行为可确保在执行 advisor 链之前始终呈现用户和系统提示。作为此增强功能的一部分，AdvisedRequest和AdvisedResponseAPI 已被弃用，取而代之的是ChatClientRequest和ChatClientResponse.顾问现在在完全构建的Prompt对象包含在ChatClientRequest而不是AdvisedRequest，保证一致性和完整性。spring-doc.cadn.net.cn

超载的tools方法中的ChatClient为清楚起见，并避免基于参数类型的方法调度中的歧义，已重命名了提示生成器 API。spring-doc.cadn.net.cn

ChatClient.PromptRequestSpec#tools(String…​ toolNames)已重命名为ChatClient.PromptRequestSpec#toolNames(String…​ toolNames).使用此方法指定工具函数的名称 （在其他位置注册，例如，通过@Bean定义@Description），允许模型调用。spring-doc.cadn.net.cn

ChatClient.PromptRequestSpec#tools(ToolCallback…​ toolCallbacks)已重命名为ChatClient.PromptRequestSpec#toolCallbacks(ToolCallback…​ toolCallbacks).使用此方法提供内联ToolCallback实例，其中包括函数实现、名称、描述和输入类型定义。spring-doc.cadn.net.cn

一个ChatMemory每当使用 Spring AI Model Starters之一时，bean 都会自动为您配置。默认情况下，它使用MessageWindowChatMemory实现并将对话历史记录存储在内存中。spring-doc.cadn.net.cn

这ChatMemoryAPI 已得到增强，以支持更灵活、可扩展的对话历史记录管理方式。存储机制已与ChatMemory接口，现在由新的ChatMemoryRepository接口。这ChatMemoryAPI 现在可用于实现不同的内存策略，而无需绑定到特定的存储机制。默认情况下，Spring AI 提供了一个MessageWindowChatMemory实现，该实现将消息窗口维持到指定的最大大小。spring-doc.cadn.net.cn

这get(String conversationId, int lastN)method 中ChatMemory已被弃用，转而使用MessageWindowChatMemory当需要将内存中的消息保留到一定限制时。这get(String conversationId)method 现在是从内存中检索消息的首选方式，而ChatMemory可以决定筛选、处理和返回消息的策略。spring-doc.cadn.net.cn

这JdbcChatMemory已被弃用，转而使用JdbcChatMemoryRepository与ChatMemory实现方式，例如MessageWindowChatMemory.如果您依赖于自动配置的JdbcChatMemorybean，你可以通过自动连接ChatMemoryBean 自动配置为使用JdbcChatMemoryRepositoryinternally 用于在相关依赖项位于 Classpath 中时存储消息。spring-doc.cadn.net.cn

这spring.ai.chat.memory.jdbc.initialize-schema属性已被弃用，取而代之的是spring.ai.chat.memory.repository.jdbc.initialize-schema.spring-doc.cadn.net.cn

请参阅 新聊天内存 文档 有关新 API 及其使用方法的更多详细信息。spring-doc.cadn.net.cn

这MessageWindowChatMemory.get(String conversationId, int lastN)方法已弃用。窗口大小现在根据实例化期间提供的配置在内部进行管理，因此只有get(String conversationId)应该使用。spring-doc.cadn.net.cn

这PromptTemplateAPI 经过重新设计，以支持更灵活、可扩展的模板化提示方式，依赖于新的TemplateRenderer应用程序接口。作为此更改的一部分，getInputVariables()和validate()方法已被弃用，并将抛出UnsupportedOperationException如果调用。特定于模板引擎的任何逻辑都应该通过TemplateRenderer应用程序接口。spring-doc.cadn.net.cn

移动的评估类：spring-doc.cadn.net.cn

移动了输出转换器类：spring-doc.cadn.net.cn

移动的 Transformer 类：spring-doc.cadn.net.cn

移动的实用程序类：spring-doc.cadn.net.cn

对spring.ai.client观察：spring-doc.cadn.net.cn

对spring.ai.advisor观察：spring-doc.cadn.net.cn

这DocumentPostProcessor引入了 API 以在模块化 RAG 架构中实现检索后组件，取代了DocumentCompressor,DocumentRanker,DocumentSelector现已弃用的 API。spring-doc.cadn.net.cn

spring.ai.<provider>.chat.enabledspring-doc.cadn.net.cn

spring.ai.<provider>.embedding.enabledspring-doc.cadn.net.cn

spring.ai.<provider>.image.enabledspring-doc.cadn.net.cn

spring.ai.<provider>.moderation.enabledspring-doc.cadn.net.cn

spring.ai.model.audio.speech=<model-provider|none>spring-doc.cadn.net.cn

spring.ai.model.audio.transcription=<model-provider|none>spring-doc.cadn.net.cn

spring.ai.model.chat=<model-provider|none>spring-doc.cadn.net.cn

spring.ai.model.embedding=<model-provider|none>spring-doc.cadn.net.cn

spring.ai.model.embedding.multimodal=<model-provider|none>spring-doc.cadn.net.cn

spring.ai.model.embedding.text=<model-provider|none>spring-doc.cadn.net.cn

spring.ai.model.image=<model-provider|none>spring-doc.cadn.net.cn

spring.ai.model.moderation=<model-provider|none>spring-doc.cadn.net.cn

模型Starters：spring-ai-{model}-spring-boot-starter→spring-ai-starter-model-{model}spring-doc.cadn.net.cn

Vector Store Starters：spring-ai-{store}-store-spring-boot-starter→spring-ai-starter-vector-store-{store}spring-doc.cadn.net.cn

MCP Starters：spring-ai-mcp-{type}-spring-boot-starter→spring-ai-starter-mcp-{type}spring-doc.cadn.net.cn

KeywordMetadataEnricher和SummaryMetadataEnricher已从org.springframework.ai.transformer自org.springframework.ai.chat.transformer.spring-doc.cadn.net.cn

Content,MediaContent和Media已从org.springframework.ai.model自org.springframework.ai.content.spring-doc.cadn.net.cn

spring-ai-commons（基金会）spring-doc.cadn.net.cn

spring-ai-model（取决于共享资源）spring-doc.cadn.net.cn

spring-ai-vector-store和spring-ai-client-chat（两者都取决于型号）spring-doc.cadn.net.cn

spring-ai-advisors-vector-store和spring-ai-rag（取决于 client-chat 和 vector-store）spring-doc.cadn.net.cn

spring-ai-model-chat-memory-*modules （取决于 client-chat）spring-doc.cadn.net.cn

通过functions()method 的默认值FunctionCallingOptions实例包含在 从该ChatModel实例，可能会被运行时选项覆盖。spring-doc.cadn.net.cn

通过functionCallbacks()method 的默认值FunctionCallingOptions实例仅 可用于运行时动态解析（请参阅工具解析），但从不可用于运行时动态解析 包含在对模型的任何调用中，除非明确请求。spring-doc.cadn.net.cn

通过functions()方法或functionCallbacks()的默认值FunctionCallingOptions实例现在以相同的方式处理：它包含在从该ChatModel实例 可能被运行时选项覆盖。因此，调用中包含工具的方式是一致的 添加到模型，并防止由于functionCallbacks()以及所有其他选项。spring-doc.cadn.net.cn

将prompt和messages和metadatapackages 的子软件包org.springframework.ai.chatspring-doc.cadn.net.cn

新功能是文本生成图像客户端。类是OpenAiImageModel和StabilityAiImageModel.有关用法，请参阅集成测试，文档即将推出。spring-doc.cadn.net.cn

新软件包model其中包含接口和基类，以支持为任何输入/输出数据类型组合创建 AI 模型客户端。目前，chat 和 image model 包实现了这一点。我们很快就会将 embedding 包更新到这个新模型。spring-doc.cadn.net.cn

新的 “portable options” 设计模式。我们希望在ModelCall尽可能跨不同的基于聊天的 AI 模型。有一组通用的生成选项，然后是特定于模型提供程序的选项。使用了一种 “duck typing” 方法。ModelOptions在 model 包中是一个 marker 接口，指示此类的实现将为模型提供选项。看ImageOptions，一个定义所有 text→image 的可移植选项的子接口ImageModel实现。然后StabilityAiImageOptions和OpenAiImageOptions提供特定于每个模型提供程序的选项。所有选项类都是通过 Fluent API 构建器创建的，都可以传递到可移植的ImageModel应用程序接口。这些选项数据类型用于ImageModel实现。spring-doc.cadn.net.cn

从spring.ai.openai.model自spring.ai.openai.chat.options.model.spring-doc.cadn.net.cn

从spring.ai.openai.temperature自spring.ai.openai.chat.options.temperature.spring-doc.cadn.net.cn

将org.springframework.ai.ollama.client.OllamaClient替换为org.springframework.ai.ollama.OllamaModelCall。spring-doc.cadn.net.cn

OllamaChatClient 方法签名已更改。spring-doc.cadn.net.cn

将org.springframework.ai.autoconfigure.ollama.OllamaProperties重命名为org.springframework.ai.model.ollama.autoconfigure.OllamaChatProperties，并将后缀更改为：spring.ai.ollama.chat.一些属性也发生了变化。spring-doc.cadn.net.cn

将 AiClient 重命名为 ChatClientspring-doc.cadn.net.cn

将 AiResponse 重命名为 ChatResponsespring-doc.cadn.net.cn

将 AiStreamClient 重命名为 StreamingChatClientspring-doc.cadn.net.cn

将包 org.sf.ai.client 重命名为 org.sf.ai.chatspring-doc.cadn.net.cn

transformers-embedding自spring-ai-transformersspring-doc.cadn.net.cn

出发地：org.springframework.experimental.aispring-doc.cadn.net.cn

收件人：org.springframework.aispring-doc.cadn.net.cn

Azure OpenAIspring-doc.cadn.net.cn

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

OpenAIspring-doc.cadn.net.cn

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