Spring AI 1.0.0 M8 现已发布。项目团队原定于 Spring AI 1.0.0 M7 为最后一个里程碑版本，但在审查了API 设计和 M7 后的弃用情况后，其确定一些重大变更在 RC1 版本中将成为破坏性变更。因此引入了这个额外的里程碑，为开发者提供一个过渡版本，让弃用的 API 与替代 API 共存，从而在 RC1 之前实现更顺畅的升级体验。
- 升级说明
- 可以使用 OpenRewrite 配方自动升级到 1.0.0-M8。此配方有助于应用此版本所需的许多代码更改。可以在Arconia Spring AI 迁移中找到配方和使用说明。
从 Spring AI 1.0 M7 升级到 1.0 M8 时，之前注册过工具回调的用户会遇到重大变更，导致工具调用功能静默失败。这尤其会影响使用已弃用tools()方法的代码。
Breaking Changes
示例
以下是在 M7 中可以运行但在 M8 中不再按预期运行的代码示例：
Copy// Old code in M7 - no longer works correctly in M8
chatClient.prompt("What day is tomorrow?")
.tools(toolCallback)
.call()
.content();
如何调整你的代码
要在升级到 M8 时解决此问题，需要更新代码以使用新toolCallbacks()方法：
Copy// Updated code for M8
chatClient.prompt("What day is tomorrow?")
.toolCallbacks(toolCallback)
.call()
.content();
为何做出这一改变
Spring AI 团队重命名了重载tools()方法，以提高清晰度并避免方法调度中的歧义。之前的 API 设计在 Java 编译器需要根据参数类型在多个重载方法之间进行选择时，容易造成混淆。
Method Mapping from M7 to M8
以下是旧方法与新方法的对应关系：
-
tools(String... toolNames)→toolNames(String... toolNames)- 当引用在其他地方注册的工具时使用（例如，通过
@Beanwith@Description）
- 当引用在其他地方注册的工具时使用（例如，通过
-
tools(ToolCallback... toolCallbacks)→toolCallbacks(ToolCallback... toolCallbacks)- 用于内联工具回调注册
-
tools(List<ToolCallback> toolCallbacks)→toolCallbacks(List<ToolCallback> toolCallbacks)- 当你有一组工具回调时使用
-
tools(ToolCallbackProvider... toolCallbackProviders)→toolCallbacks(ToolCallbackProvider... toolCallbackProviders)- 用于实现
ToolCallbackProvider接口的对象
- 用于实现
-
tools(Object... toolObjects)保持不变- 仅适用于带有
@Tool注解的方法的对象
- 仅适用于带有
改进的错误处理
在最新的 PR (spring-projects/spring-ai#2964) 中，tools(Object... toolObjects)会在提供的对象上未找到@Tool方法时抛出异常。这有助于开发人员立即识别迁移问题。
迁移摘要
如果要从 M7 升级到 M8：
- 将对
.tools(toolCallback)的所有调用替换为.toolCallbacks(toolCallback) - 将对
.tools(toolCallbackProvider)的所有调用替换为.toolCallbacks(toolCallbackProvider) - 将对
.tools("toolName")的所有调用替换为.toolNames("toolName")
这些变化将确保你的工具调用功能在升级到 Spring AI 1.0 M8 后继续正常工作。
新功能
- 聊天记忆增强功能
- 增强型聊天记忆架构
- 改进的
ChatMemoryAPI，实现更灵活的对话历史管理 - 新
ChatMemoryRepository界面允许不同的存储策略 - 添加
MessageWindowChatMemory用于维护消息窗口 - 改进属性命名以确保跨实现的一致性
- 支持各种存储后端：
InMemoryChatMemoryRepository（默认）- 用于关系数据库的
JdbcChatMemoryRepository
- 有关聊天内存配置的更多详细信息，参阅内存类型和内存存储。
- 改进的
- 模板渲染*
- 引入 TemplateRenderer 进行快速模板化
- 用于模板渲染的灵活的新 API，可在不同的模板引擎之间提供一致的接口
- 新增了
StTemplateRenderer对内置函数和自定义验证选项的支持。点击此处查看如何使用。 - 直接集成到 ChatClient 中，以简化提示模板
- 已添加
NoOpTemplateRenderer，适用于不需要模板的情况 - 相关：“在 ChatClient 中配置 TemplateRenderer”、“更新文档以提及 NoOpTemplateRenderer”
- MCP 改进
- 增强的 MCP tool callback 配置
- 在 MCP 客户端属性中添加了 tool callback 配置
- 支持 MCP server 中的完成规范
- 为 MCP server 添加了指令支持
- 向 WebFlux 和 WebMvc 传输提供程序添加了 SSE 端点参数
- Prompt Engineering Patterns
- 添加 Prompt Engineering Patterns 文档
- 关于 advanced prompt engineering techniques 的全新综合文献
- 为开发人员提供有效提示设计的最佳实践
- 包括各种用例的示例和模式
- Vector Store 增强
- Cosmos DB Entra ID 支持和修复
- 为 Cosmos DB 添加了 Azure Entra ID（原 Azure AD）身份验证功能
- 改进 Azure 部署的安全性和身份验证选项
- Cassandra Vector Store 改进
- 修复了 Cassandra 聊天内存中的消息顺序
- 添加了更好的错误消息并修复了各种问题
更多详情可查看官方公告。