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 部落格