Spring AI 1.0.0 RC1 发布

发布 | Mark Pollack | 2025 年 5 月 13 日 | ...

我们很高兴地宣布 Spring AI 1.0.0 RC1 的发布，这标志着在稳定版本发布之前，最后的破坏性变更、错误修复和新功能集！GA 版本定于 2025 年 5 月 20 日发布——仅一周之遥。在此期间，我们将专注于改进文档和解决任何已报告的错误。

为了庆祝本次发布，我们在 AI 生成的音乐播放列表中添加了一首新歌。收听最新曲目，以增强您的博客阅读和编码体验。

重要链接

升级说明
您可以使用 OpenRewrite recipe 自动升级到 1.0.0-RC1。此 recipe 有助于应用此版本所需的许多代码更改。可在 Arconia Spring AI Migrations 找到该 recipe 和使用说明。

关键性重大变更

聊天客户端和顾问

在 VectorStoreChatMemoryAdvisor 中
- CHAT_MEMORY_RETRIEVE_SIZE_KEY → TOP_K
- DEFAULT_CHAT_MEMORY_RESPONSE_SIZE (100) → DEFAULT_TOP_K (20)
CHAT_MEMORY_CONVERSATION_ID_KEY → CONVERSATION_ID（已移至 ChatMemory 接口）
- 更新导入为：org.springframework.ai.chat.memory.ChatMemory.CONVERSATION_ID

顾问中的自包含模板

顾问现在使用独立的模板，其中包含特定的必需占位符

QuestionAnswerAdvisor：query，question_answer_context
PromptChatMemoryAdvisor：instructions，memory
VectorStoreChatMemoryAdvisor：instructions，long_term_memory

聊天内存存储库命名标准化

在 1.0.0-RC1 中，我们通过在整个代码库中添加 repository 后缀来标准化聊天内存组件的命名模式。此更改会影响 Cassandra、JDBC 和 Neo4j 实现。

Artifact ID

所有与内存相关的 Artifact 都遵循一致的模式

spring-ai-model-chat-memory-* → spring-ai-model-chat-memory-repository-*
spring-ai-autoconfigure-model-chat-memory-* → spring-ai-autoconfigure-model-chat-memory-repository-*
spring-ai-starter-model-chat-memory-* → spring-ai-starter-model-chat-memory-repository-*

Java 包

包路径现在包含 .repository. 段
示例：org.springframework.ai.chat.memory.jdbc → org.springframework.ai.chat.memory.repository.jdbc

配置类

主自动配置类现在使用 Repository 后缀
示例：JdbcChatMemoryAutoConfiguration → JdbcChatMemoryRepositoryAutoConfiguration

属性

配置属性已从 spring.ai.chat.memory.<storage>... 重命名为 spring.ai.chat.memory.repository.<storage>...

可观测性变更

从跟踪切换到日志记录
属性已重命名（例如，include-prompt → log-prompt）
移除了 OTel SDK 依赖项

所有已弃用的内容都已移除，以提供更简洁的 API。有关完整详细信息，请参阅 Spring AI 升级说明。

新功能

模型增强

DeepSeek 集成

增加了专用的 DeepSeek 模型支持，包含核心类和启动器，以适应其与 OpenAI API 的差异。

Azure OpenAI

AzureOpenAiResponseFormat 中的 JSON Schema 支持，采用 Builder 模式
用于简化身份验证的 Entra ID 身份管理
流式用法支持，以提高响应处理效率
AzureOpenAiChatOptions 中的 reasoning_effort 参数

OpenAI

OpenAiApi 和 OpenAiChatModel Builder 的 mutate 功能
Web 搜索注解，用于改进搜索集成
OpenAiImageModel 中可配置的 imagesPath

Vertex AI Gemini

参数警告和惩罚选项，以获得更好的输出质量
jsonToStruct 中的 JSON 数组支持

RAG 和文档处理

RAG Advisor 中的 DocumentPostProcessors，用于复杂的转换管道
可自定义的 text 属性名称，并向后兼容

工具调用

工具回调中的泛型参数类型支持

内存管理

JdbcChatMemory 中的灵活数据库支持
通过 CassandraChatMemoryRepository 提供 Cassandra 支持

可观察性

增强了内容观察的日志记录
Bedrock Titan Embedding 模型的观测性支持

贡献者

还有许多其他重构、错误修复、文档增强等工作由众多贡献者完成。如果您的 PR 尚未被处理，我们会尽快处理，请耐心等待。感谢

Spring 博客