一、背景与概述随着AI大模型的爆发式发展Java/Spring生态亟需一套标准化的AI工程框架。Spring官方于2023年秋季启动Spring AI项目定位为AI领域的JDBC——提供统一的模型抽象API层。阿里云团队在此基础上推出Spring AI AlibabaSAA定位为AI领域的MyBatis-Plus——在Spring AI之上提供深度扩展聚焦企业级AI工作流编排与多智能体协作。核心关系SAA不是Spring AI的替代而是其之上的深度扩展。二、Spring AI 原理与架构2.1 架构全景2.2 三层架构详解层级核心组件职责API层ChatClient, Prompt Template, Structured Output, Advisor Chain, Tool Calling面向开发者的Fluent API提供对话、模板、结构化输出、拦截器链、工具调用抽象层ChatModel, ImageModel, EmbeddingModel, VectorStore, RAG统一的模型接口抽象屏蔽底层模型差异实现层OpenAI, Anthropic, Azure, Ollama, Gemini, Mistral, Bedrock等20提供商各模型提供商的具体实现2.3 核心设计原则可移植性Portable一套API适配多种模型切换模型只需改配置模块化Modular各功能独立模块按需引入POJO构建块用Java对象而非JSON构建AI应用可组合ComposableAdvisor Chain实现功能可插拔组合2.4 核心特性ChatClient Fluent API链式调用风格简化对话开发Prompt Template参数化提示词模板支持外部化配置Structured Output将LLM输出自动映射为Java POJOAdvisor Chain拦截器链模式支持请求/响应的横切关注点Tool/Function Calling让LLM调用Java方法实现Agent基础能力RAG检索增强生成结合向量数据库提供上下文ETL框架DocumentReader → DocumentTransformer → DocumentWriter标准化数据处理流水线VectorStore支持PGVector、Milvus、Chroma、Pinecone、Redis、Elasticsearch等10向量数据库2.5 版本演进时间版本里程碑2023秋0.x首次发布社区孵化2025.51.0.0 GA首个正式发布版API稳定2025.111.1 GA引入Agents框架、Bench评估工具三、Spring AI Alibaba 原理与架构3.1 架构全景3.2 四层架构详解层级核心组件职责Studio应用层ChatBot, Workflow, Multi-Agent, JManus面向应用的三种开发范式Agent框架层StateGraph, OverAllState, NodeEdge, MCP Client智能体编排与状态管理Graph核心运行时GraphBuilder, StateGraph, AsyncNode, SubGraph, ConditionalEdge工作流图引擎支持条件分支/子图/异步节点Spring AI基础层继承Spring AI全部能力底层模型抽象、RAG、VectorStore等3.3 核心扩展特性3.3.1 Graph多智能体框架SAA的核心创新是引入了有状态的工作流图StateGraph区别于Spring AI的无状态模式OverAllState跨步骤的全局状态管理支持状态在节点间传递和更新Node Edge节点处理逻辑 边流转规则的图结构编排ConditionalEdge条件分支根据状态动态选择下一节点SubGraph子图嵌套支持复杂工作流的模块化AsyncNode异步节点支持并行执行提升效率3.3.2 JManus自主规划智能体JManus是SAA内置的自主规划Agent采用三Agent协作架构Planning Agent → Executor Agent → Supervisor AgentPlanning Agent分析任务拆解执行计划Executor Agent按计划逐步执行调用工具Supervisor Agent监督执行结果决定是否重规划3.3.3 MCP Nacos集成MCP协议Model Context ProtocolAnthropic推出的标准化AI模型与外部工具交互协议Nacos注册发现MCP Server通过Nacos注册实现分布式工具发现自动Router根据MCP Server注册信息自动生成路由动态MCP Server代理运行时动态发现和调用MCP Server3.3.4 阿里云深度集成集成项说明通义千问Qwen默认模型系列包括Qwen-Max/Qwen-Plus/Qwen-Turbo百炼平台阿里云AI平台模型管理/部署/监控一体化ARMS可观测应用实时监控链路追踪/指标采集LangfuseLLM可观测性平台Token追踪/成本分析云原生网关MCP Server的网关管理和模板管理3.4 版本演进时间版本里程碑2024.100.x开源发布社区孵化2025.61.0.0.2 GA首个正式发布版20251.1.0.0-RC1Graph框架增强、JManus完善四、深度对比分析4.1 对比全景图4.2 核心维度对比对比维度Spring AISpring AI Alibaba架构定位模型抽象层JDBC深度扩展层MyBatis-Plus核心理念可移植性 模块化Graph工作流编排 多智能体Agent能力v1.1引入Agents框架基础Graph多Agent JManus完整状态管理无状态单次请求有状态OverAllState跨步骤默认模型OpenAI等海外模型通义千问Qwen系列MCP集成MCP Client基础支持MCP Nacos注册发现 Router可观测性无内置ARMS Langfuse工作流编排无需自行实现StateGraph完整支持云绑定无云绑定阿里云深度绑定学习曲线低Spring开发者友好中需理解Graph/State概念生态兼容Spring生态通用Spring 阿里云生态4.3 关键差异解读差异一有状态 vs 无状态这是两个框架最本质的区别。Spring AI采用无状态设计每次请求独立处理SAA引入OverAllState支持跨步骤的状态传递和累积这是实现复杂工作流编排的基础。差异二Graph工作流 vs 链式调用Spring AI通过Advisor Chain实现简单的拦截器链式调用SAA通过StateGraph实现完整的图结构工作流支持条件分支、循环、子图嵌套、并行执行等复杂编排模式。差异三单Agent vs 多Agent协作Spring AI v1.1引入的Agents框架偏向单Agent工具调用模式SAA的JManus实现了Planning-Executor-Supervisor三Agent协作架构支持任务自主拆解和执行监督。差异四模型生态差异Spring AI以OpenAI等海外模型为默认适合全球化部署SAA以通义千问为默认适合国内合规场景和阿里云生态。五、适应场景分析5.1 Spring AI 适合的场景场景说明简单对话机器人ChatBot、FAQ问答、客服对话RAG知识库问答结合向量数据库的企业知识检索多模型A/B测试需要频繁切换/对比不同模型效果海外模型集成主要使用OpenAI/Anthropic等海外模型轻量级AI增强在现有Spring应用中快速添加AI能力无云绑定需求需要跨云/混合云部署Function Calling让LLM调用Java方法完成特定任务5.2 Spring AI Alibaba 适合的场景场景说明复杂工作流编排多步骤、有分支、需状态管理的AI流程多智能体协作多个Agent分工协作完成复杂任务自主规划Agent需要Agent自主拆解任务、规划执行步骤阿里云生态部署已在阿里云上需要与百炼/Nacos/ARMS集成国内合规场景需要使用国产模型通义千问MCP工具生态需要分布式MCP Server注册发现企业级可观测需要LLM链路追踪、Token成本监控六、选型建议6.1 决策树是否需要复杂工作流编排多步骤/分支/状态 ├── 是 → 是否使用阿里云生态 │ ├── 是 → Spring AI Alibaba │ └── 否 → Spring AI 自行实现工作流 └── 否 → 是否需要多Agent协作 ├── 是 → Spring AI AlibabaJManus └── 否 → 是否需要国产模型/合规 ├── 是 → Spring AI Alibaba通义千问 └── 否 → Spring AI6.2 选型矩阵评估因素权重Spring AISAA说明开发效率高★★★★★★★★★Spring AI更轻量上手快工作流能力高★★★★★★★SAA的Graph是核心优势Agent能力高★★★★★★★★SAA的JManus更完整模型可移植性中★★★★★★★★Spring AI无绑定更灵活企业级特性中★★★★★★★★SAA可观测/网关更完善社区活跃度中★★★★★★★★Spring AI社区更大学习成本低★★★★★★★★Spring AI更简单6.3 渐进式引入策略推荐策略先Spring AI后按需引入SAA由于SAA基于Spring AI构建两者底层兼容可以采用渐进式引入Phase 1使用Spring AI快速构建基础AI能力对话、RAG、Tool CallingPhase 2当需要工作流编排时引入SAA的Graph模块Phase 3当需要多Agent协作时引入SAA的JManusPhase 4当需要企业级特性时接入SAA的MCPNacos/ARMS等6.4 总结场景推荐快速原型/简单AI增强Spring AI多模型切换/全球化部署Spring AI复杂工作流/多AgentSpring AI Alibaba阿里云生态/国产模型Spring AI Alibaba不确定/渐进演进先Spring AI后按需引入SAA七、参考资料Spring AI 官方文档Spring AI GitHubSpring AI Alibaba 官方文档Spring AI Alibaba GitHubMCP 协议规范通义千问 API