跳到主要内容

1.1.1

云端
云端
Spring AI 学习者

Spring AI 1.1.1 正式发布，累计合并 45 个提交，涉及 347 个文件（+22,653 / -780 行）。本次更新引入了 OpenAI 官方 SDK 集成模块、Anthropic Skills 技能支持、Google GenAI 推理等级控制以及结构化输出标准化接口。

核心抽象​

StructuredOutputChatOptions​

新增 StructuredOutputChatOptions 接口，统一了 OpenAI、Anthropic、Google GenAI 三个模型的结构化输出配置。各厂商的 ChatOptions 实现类（OpenAiChatOptions、AnthropicChatOptions、GoogleGenAiChatOptions）均已实现该接口，提供一致的 outputSchema 配置方式。

模型厂商​

OpenAI SDK（新增）​

1.1.1 新增 spring-ai-openai-sdk 模块，基于 OpenAI 官方 Java SDK（openai-java 4.8.0）提供 Chat、Embedding、Image 三种能力：

类说明
OpenAiSdkChatModel聊天模型（1,321 行），支持 StructuredOutputChatOptions
OpenAiSdkChatOptions聊天选项（1,139 行），丰富的配置参数
OpenAiSdkEmbeddingModel嵌入模型（263 行）
OpenAiSdkEmbeddingOptions嵌入选项（266 行）
OpenAiSdkImageModel图片生成模型（218 行）
OpenAiSdkImageOptions图片生成选项（430 行）
OpenAiSdkSetupSDK 客户端初始化工具（285 行）
  • Starter：spring-ai-starter-model-openai-sdk
  • 配置前缀：spring.ai.openai-sdk
  • 新增 OpenAiSdkAutoConfigurationUtil 统一管理自动配置逻辑
  • 支持 Azure 内部部署（AzureInternalOpenAiSdkHelper）

Anthropic​

  • Skills 支持 —— 新增 SkillsResponseHelper（191 行），AnthropicApi 大幅扩展（+475 行）。AnthropicChatOptions 新增 skillContainer 字段，支持 AnthropicSkill 和自定义 Skill（含版本管理）
  • 结构化输出 —— AnthropicChatOptions 实现 StructuredOutputChatOptions，支持 outputFormat / outputSchema

Google GenAI​

  • 推理等级控制 —— 新增 GoogleGenAiThinkingLevel 枚举（THINKING_LEVEL_UNSPECIFIED / LOW / HIGH），适用于 Gemini 3 Pro 模型
  • 推理内容输出 —— GoogleGenAiChatOptions 新增 includeThoughts 和 thinkingLevel 选项
  • 结构化输出 —— 实现 StructuredOutputChatOptions，支持 responseSchema

Vertex AI Gemini​

  • 新增 VertexAiGeminiSafetyRating——安全评分数据结构

聊天记忆​

Azure Cosmos DB 持久化（新增）​

新增 spring-ai-starter-model-chat-memory-repository-cosmos-db Starter，支持 Azure Cosmos DB 作为聊天记忆后端。

MCP 协议​

  • MCP SDK 0.17.0 —— 升级自 1.1.0 的 0.16.0
  • MCP Annotations 0.8.0 —— 新增 mcp/mcp-annotations-spring 模块，支持 Spring 风格的 MCP 注解

其他增强​

  • AdvisorParams —— 新增 AdvisorParams 类（38 行），规范化 Advisor 参数传递
  • GemFire Vector Store —— 新增 BearerTokenAuthenticationFilterFunction，支持 Bearer Token 认证；配置属性升级
  • Elasticsearch AI Search —— 新增 ElasticsearchAiSearchFilterExpressionConverter
  • ToolCallAdvisor —— 重构增强（+73 行）

基础设施​

  • Spring Boot 3.5.8 —— 基于 Spring Boot 3.5.8 构建
  • MCP SDK 0.17.0 —— 升级 MCP 协议 SDK
  • MCP Annotations 0.8.0 —— 新增 Spring 风格 MCP 注解模块
  • OpenAI Java SDK 4.8.0 —— 引入官方 SDK 依赖

Spring AI 1.1.1 作为补丁版本升级，引入了 OpenAI 官方 SDK 集成、Anthropic Skills 技能支持和 Google GenAI 推理等级控制，同时推进了 StructuredOutputChatOptions 标准化，为多模型结构化输出提供了一致配置接口。