Spring AI 1.x 系列【14】三月双版本连发！Spring AI 最新功能全掌握

文章目录

• [1. 前言](#1. 前言)
• [2. Spring AI 1.1.3 版本发布说明](#2. Spring AI 1.1.3 版本发布说明)
• • [🎯 核心亮点](#🎯 核心亮点)
  • [📢 重要更新](#📢 重要更新)
  • [⭐ 新特性](#⭐ 新特性)
  • [🪲 漏洞修复](#🪲 漏洞修复)
  • [📓 文档优化](#📓 文档优化)
  • [🔨 依赖升级](#🔨 依赖升级)
  • [🔩 构建优化](#🔩 构建优化)
• [3. Spring AI 1.1.4 版本发布说明](#3. Spring AI 1.1.4 版本发布说明)
• • [🎯 核心亮点](#🎯 核心亮点)
  • [⭐ 新特性](#⭐ 新特性)
  • [🪲 漏洞修复](#🪲 漏洞修复)
  • [🔩 构建优化](#🔩 构建优化)

1. 前言

在之前的版本中，我们使用的 Spring AI 1.1.2 版本 ，在 26 年三月份，Spring 连续发布了两个版本，下面一起来看下新版本有哪些更新，后续本系列专栏会使用最新的 1.1.4 版。

2. Spring AI 1.1.3 版本发布说明

🎯 核心亮点

本次版本包含19 项新特性 、31 处漏洞修复 、23 项文档优化 及 25 项其他改进。

📢 重要更新

为保持与 Anthropic API 的兼容性，代码库及集成测试中所有已弃用的 Anthropic 模型名称，均已替换为现行有效模型标识符。

⭐ 新特性

1. Neo4j 向量存储现已支持通过构建器模式自定义过滤表达式转换器，为自定义查询过滤逻辑提供更高灵活性。
2. 为 OpenAiSdkChatModel 实例引入构建器模式，实现更灵活、更易读的实例化方式。
3. OpenAiEmbeddingModel 新增支持通过配置文件 /embedding/embedding-model-dimensions.properties 自定义嵌入向量维度。
4. ToolCallAdvisor 现已支持流式响应，可实现实时函数调用交互。
5. SimpleVectorStore 新增删除条目时的过滤能力，实现向量数据管理的更细粒度控制。
6. 新增对 Anthropic Claude Skills API 的支持，采用统一 API 设计并提供技能集成辅助类。
7. Ollama 嵌入模型新增维度参数支持，可控制嵌入向量的长度。
8. 支持为结构化输出与函数调用自定义 JSON Schema 生成规则。
9. Mistral AI 对话模型现已支持基于 JSON Schema 校验的结构化输出，实现类型安全响应与自动转换。
10. 新增便捷方法，可直接从 Prompt 对象中获取系统提示消息。
11. 新增 Mcp*ServerCustomizer 接口，并修复 MCP 自动配置在非 Web 环境下无法正常运行的问题。
12. OllamaChatOptions 现已实现 StructuredOutputChatOptions 接口，支持结构化 JSON 输出，并配套完善单元与集成测试。
13. Ollama 对话交互新增简单 JSON 格式选项支持。
14. 优化 Microsoft Foundry 集成中的模型提供商检测逻辑。
15. 对话记忆顾问现已支持 ToolResponseMessage，优化对话历史中工具响应的处理逻辑。
16. 新增运行时动态扩展工具 Schema 能力，支持更灵活的工具配置与自定义。
17. 为 ToolCallAdvisor 新增 conversationHistoryEnabled 选项，可控制工具调用时是否携带对话历史。
18. Azure 向量存储新增可配置字段名 支持，可适配使用自定义字段名（而非硬编码默认值：content、embedding、metadata）的现有 Azure AI 搜索索引。
19. TokenTextSplitter 新增自定义标点符号支持，适配多语言与各类场景下更灵活的文本切分。

🪲 漏洞修复

1. 修复并优化向量存储操作的 FilterExpressionConverter，增强查询过滤能力。
2. 将已停用的 Azure OpenAI 图像模型替换为最新可用版本。
3. 修正 DeepSeekAssistantMessage 中 prefixAssistantMessage 的实现逻辑。
4. 解决新批次处理首个文档时令牌计数未正确统计的问题，确保令牌用量上报准确。
5. 文档名称现已完成合规化处理，满足 AWS Bedrock Converse API 命名规范，避免 API 调用被拒绝。
6. 确保 CosmosDB 对话记忆自动配置优先加载，解决 Bean 依赖与初始化顺序问题。
7. 通过更新为现行模型名称，修复 Anthropic 集成测试异常问题。
8. 新增歧义校验并优化 Google GenAI 认证逻辑，避免配置冲突。
9. 解决批量嵌入处理时 MetadataMode 配置未生效的问题。
10. 修正 OpenSearch 向量存储集成中的过滤表达式分组逻辑，保证查询结果准确。
11. 解决 Bedrock 缓存指标未正确纳入 Usage 对象的问题，保障监控可观测性。
12. 修正 Elasticsearch 集成中 IN/NOT IN 运算符的过滤表达式语法。
13. 修复 MongoChatMemoryRepository 消息排序问题，确保对话历史正确获取。
14. 修复 ToolCallAdvisor 在记忆功能禁用时无法保留系统消息的问题。
15. 修正 Google 生成式 AI 嵌入模型的观测器使用方式，保障指标采集与链路追踪正常
16. 优化 ChromaApi 异常处理，实现异常的正确捕获与处理。
17. 优化工具描述，助力模型正确返回地理坐标，并完善集成测试类。
18. 修正 Mistral AI 的 chatClientEntityWithStructuredOutput 集成测试。
19. 解决语法解析流程中的字符串解析问题。
20. 修复 Spring AI BOM 中缺失 Redis 对话记忆存储库构件的问题。
21. 适配不同 Ollama 模型版本的令牌计数差异，提升集成测试稳定性。
22. 将 Anthropic 集成测试切换为现行模型，提升测试可靠性。
23. 修复 Neo4jVectorStore 的 doAdd 方法忽略会话配置的问题。
24. 对 Neo4jVectorStore 实现进行通用优化与更新。
25. 解决 Antora 文档构建流程中的异常问题。
26. 修复 ChromaApi HTTP 服务端/客户端异常信息校验，正确处理错误场景。
27. 修正集合存在性校验的错误提示拼写问题
28. 更新 TransformersEmbeddingModel 使用原始 URL，提升兼容性。
29. 解决构建过程中的 Checkstyle 执行异常。
30. 修复多项构建系统问题，提升构建稳定性。
31. 修复代码库中 ErrorProne 检测出的各类错误，提升代码质量、规避潜在漏洞。

📓 文档优化

1. 完善 JavaDoc 说明，明确请求支持的内容类型（字符串/媒体内容列表）与响应类型（仅字符串）。
2. 新增文档说明贡献者需遵循的 Java 代码格式化规范与环境配置。
3. 完善 Bedrock 缓存指标功能的文档与测试覆盖率，同时保障向后兼容。
4. 修正用户指南文档中的 API 参考错误。
5. 修正文档中的拼写错误 。
6. 新增 MongoChatMemoryRepository 消息排序行为的相关文档。
7. 为 ETL 流水线文档补充依赖信息，简化集成流程。
8. 修复通用模块代码注释中的拼写错误。
9. 完善 Prompt 功能相关文档。
10. 新增 Mistral AI 原生结构化输出转换使用文档。
11. 修正文档中多处拼写错误。
12. 修正 RetrievalAugmentationAdvisor 文档中的步骤编号。
13. 新增 LLM 评判器（LLM as a Judge） 模式及实现策略的全新文档指南。
14. 新增动态工具发现能力与使用模式的文档指南。
15. 修正 Gemini 模型提供商文档中的拼写错误。
16. 移除文档中 OpenAI 基础 URL 示例里冗余的 /v1 后缀，提升可读性。
17. 新增 Anthropic 自定义技能集成的完整参考文档。
18. 修复对话选项构建器示例代码中的语法错误。
19. 修正 TokenCountBatchingStrategy JavaDoc 中失效的文档链接。
20. 修正 MilvusFilterExpressionConverter JavaDoc 中失效的文档链接。
21. 为项目 README 添加 Maven Central 徽章，提升项目辨识度。
22. 新增 Azure 向量存储自定义字段名功能的相关文档。
23. 新增 TokenTextSplitter 自定义标点符号支持的相关文档。

🔨 依赖升级

1. 将向量存储组件依赖更新至最新版本。
2. 更新集成测试中使用的 GemFire 向量存储 Docker 镜像版本。
3. Spring Boot 依赖升级至 3.5.11 ，引入 Spring Boot 生态最新漏洞修复与功能优化。
4. OpenAI Java SDK 依赖升级至 4.17.0，适配最新特性与修复。
5. Azure SDK 依赖更新至最新版本，提升安全性与稳定性。
6. 更新 Google GenAI SDK，新增对 Gemini 3 Pro/Flash 模型专属思考等级的支持。
7. 更新 Mistral AI 对话模型列表，纳入最新模型版本。
8. OpenAI Java SDK 依赖更新至 4.13.0。
9. Google 生成式 AI SDK 依赖升级至 1.30.0。

🔩 构建优化

1. 移除不再需要的 AnthropicApiLegacyToolIT 集成测试。
2. 更新 Checkstyle 规则，适配新的版权声明格式。
3. 更新非 Java 文件的版权声明，保持许可协议一致性。
4. 统一代码库版权声明格式为「2023-present」，便于维护。
5. 更新 Google GenAI 对话自动配置的集成测试。
6. 使用官方 spring-io 回退机器人操作，简化版本回退自动化流程
7. 重构构建结构，将 antlr4 语法文件与 swagger 文件移出资源目录。
8. 将 OllamaEmbeddingOptionsTests 重新归类为集成测试，规范测试分类。
9. 将相关测试迁移至 IT 测试分类，规范测试归类
10. 修正 Checkstyle 插件的代码质量检查配置。
11. 将多个 CI 工作流合并为单一统一工作流，提升可维护性。
12. 集成 Maven 构建缓存插件，提升构建性能。
13. 优化 Maven 构建缓存配置，提升缓存效率。
14. 清理 ChatClientToolsWithGenericArgumentTypesIT 中歧义性测试。
15. 更新 BedrockRuntimeHints 与 OpenAIRuntimeHints，提升 GraalVM 原生镜像兼容性。

3. Spring AI 1.1.4 版本发布说明

🎯 核心亮点

本次版本包含1 项新特性 、11 处漏洞修复 、1 项其他改进。

⭐ 新特性

新增运行时动态禁用原生结构化输出功能的能力，在配置和使用场景中提供更高灵活性。

🪲 漏洞修复

1. 修复 Oracle 与 PgVector 向量存储集成测试问题，提升测试可靠性 。
2. 修复对话请求中提供工具定义（toolDefinitions）时，extraBody 参数丢失的问题。
3. 解决不稳定测试场景问题，提升 Bedrock 对话集成测试稳定性。
4. 更新 Google GenAI 嵌入模型至现行 API，并修复函数调用测试不稳定问题 。
5. 修复 Google GenAI 文本嵌入模型观测集成测试问题。
6. 增强 Bedrock 代理对话模型获取媒体资源时的异常处理能力与可靠性 。
7. 优化 SimpleVectorStore 中的过滤判断逻辑，提升性能与可维护性 。
8. 修复 Anthropic 提示词缓存实现中，多块系统消息无法正常缓存的问题 。
9. 修正 Redis 过滤表达式转换器中，TAG 与 TEXT 过滤类型对字符串值的处理逻辑 。
10. 优化 Neo4j 向量存储过滤表达式转换器中的键处理逻辑，实现更精准的过滤 。
11. 修复 FilterExpressionTextParser 中的标识符解析逻辑问题，确保过滤表达式处理正确。

🔩 构建优化

修复文档上传 GitHub Actions 工作流中的问题，确保文档正常部署。