Skip to main content
Spring AI 1.0.1 已发布！这是一次以“稳定性 + 文档完善 + 开发体验”为核心的小版本更新，包含 24 项新功能、50 个缺陷修复、45 处文档改进与多项性能、构建优化。

​
🎯 核心亮点

  • 功能增强：工具调用（@tool 注解、流式工具调用、异常处理可配置化）、多模型提供商持续完善（Anthropic/Mistral/OpenAI/Ollama/Neo4j 等）
  • 稳定性修复：覆盖方法同名工具调用、流式输出 NPE、自动配置缺陷、Schema 生成顺序等问题
  • 文档大幅完善：工具、Advisor、各模型接入页、向量库文档、示例代码与链接修复
  • 兼容与升级：支持 Spring Framework 7.x 相关兼容，Spring Boot 升至 3.5.0

​
⭐ 新功能速览

​
工具调用与 ChatClient

  • 强化 @tool 注解能力，完善工具调用生态（含无参流式工具调用）
  • ChatClient#mutate 现在复制 advisors 与参数，避免实例间共享引用
  • 默认工具执行异常处理器支持“选择性重新抛出”，便于精细化容错
  • MessageAggregator 重构以支持工具调用聚合

​
多模型与提供商增强

  • Anthropic：支持最新 Claude 系列、思维事件流式输出、按请求动态 API Key 配置
  • Mistral：新增与完善聊天与配置项，补充新模型支持
  • OpenAI：更新语音枚举、支持 PDF 作为媒体输入、改进音频相关用例
  • Ollama：OllamaChatModel 集成重试模板，提升鲁棒性；修复自动配置问题
  • Neo4j：向量库可根据模型自动推断默认 embedding 维度

​
RAG / 向量库

  • 文档入库前新增“文本/媒体内容校验”，保证向量数据质量
  • Chroma/Elasticsearch/Milvus/Qdrant 等向量库在 Schema、元数据与测试覆盖方面均有改进

​
兼容性与通用改进

  • RetryUtils#ResponseErrorHandler 增加对 Spring Framework 7.x 的兼容
  • MiniMax 选项对象补充 equals/hashCode/deep copy 支持与完整测试

​
🪲 关键缺陷修复（节选）

  • 解决“方法工具调用中存在同名方法引发错误”的问题
  • 修复 Anthropic 流式 API NPE、参数顺序错误、空指针与断言信息不清晰等问题
  • 修正 Ollama 自动配置导致的初始化异常
  • 工具调用在“内部执行开启”的场景下不再错误输出流式响应
  • 统一移除错误的 @nullable 注解、修复 JSON Schema 生成顺序、修正多处拼写/链接

​
🧾 文档与示例改进（节选）

  • 工具调用、默认工具配置、Advisor 与 MCP Server Boot Starter 文档显著完善
  • OpenAI Vision、ZhipuAI、Mistral、DeepSeek/Minimax 等集成页面更新与修正
  • 向量库（Elasticsearch、Milvus、Chroma）文档补充属性说明与示例
  • 多处示例修正（如 ToolDefinition.builder() 用法、依赖声明、链接与图片）

​
🔩 依赖与构建

  • Spring Boot 升级至 3.5.0，测试与构建脚本更健壮
  • Jakarta EE 兼容性：从 swagger-annotations 迁移到 swagger-annotations-jakarta
  • 重构与清理测试、CI 工作流与示例资源，提升可维护性

​
⚡ 性能优化

  • 复用 DocumentRowMapper 减少对象创建
  • 聊天记忆 Advisor 组件在 debug 级别日志输出上做了性能优化

​
🔭 展望：Spring AI 1.1 与 2.0

基于官方博客的公开信息，1.1 聚焦稳定性之上的“能力补全与开发体验”，2.0 将基于 Spring Boot 4 进行更大范围的架构演进与节奏管理。

​
1.1 当前关注方向（节选）

  • 核心基础与维护：
    • Spring Boot 4 支持与兼容性
    • CI/CD 改进（覆盖 Google Vertex、Amazon 测试缺口）
    • Issue 分流与社区 PR 整合
    • Kotlin 空安全改进
  • 模型提供商增强：
    • 聊天 SDK 升级（Azure OpenAI、Google Vertex 等迁移）
    • 增强聊天特性（Prompt 缓存、消息批处理、“思考”模型）
    • 非聊天 API 拓展（Responses、Image、TTS、Realtime 等）
    • 原生 JSON 模式与结构化输出增强
  • 高阶能力：
    • MCP（Model Context Protocol）集成与流式支持
    • 向量库与混合检索（超越相似度检索）
    • 企业级 Guardrails 与安全能力
    • 可观测性与监控增强
    • Chat Memory 增强与类 MemGPT 实现探索
  • 开发者体验：
    • 评测器与 AI 应用测试框架
    • Agent 框架与工作流辅助
    • 多客户端配置体验改进
    • API Key 轮换与供应器模式
  • 新兴方向：
    • Agent 与 Agent 协议/通信
    • 商业化 MCP 代理
    • GraphRAG 与进阶检索范式
此外，团队强调将“广泛征集社区优先级”，以便在快速演进的 AI 领域下更聚焦地推进 1.1 的交付。

​
2.0 方向与节奏

  • 以 Spring Boot 4 为新基座，规划更大规模的架构演进
  • 路线图以 日期驱动 帮助社区把握节奏，同时指示关键结构性变化
  • 具体功能将结合 1.1 的落地情况与社区反馈，逐步披露