AI - Java之Spring AI Alibaba

一、Spring AI AlibabaSpring AI AlibabaSAA是一款以 Spring AI 为基础深度集成百炼平台支持 ChatBot、工作流、多智能体应用开发模式的 AI 框架。基于Spring AI官方标准封装、阿里云开源的国产 Java 大模型开发框架专门适配阿里云灵积 DashScope通义千问 Qwen、百炼平台完美兼容 Spring Boot/Spring Cloud 生态Spring AI Alibaba。在 1.0 版本中Spring AI Alibaba 提供以下核心能力让开发者可以快速构建自己的 Agent、Workflow 或 Multi-agent 应用。Graph 多智能体框架。基于 Spring AI Alibaba Graph 开发者可快速构建工作流、多智能体应用无需关心流程编排、上下文记忆管理等底层实现。通过 Graph 与低代码、自规划智能体结合为开发者提供从低代码、高代码到零代码构建智能体的更灵活选择。通过 AI 生态集成解决企业智能体落地过程中关心的痛点问题。Spring AI Alibaba 支持与百炼平台深度集成提供模型接入、RAG知识库解决方案支持 ARMS、Langfuse 等可观测产品无缝接入支持企业级的 MCP 集成包括 Nacos MCP Registry 分布式注册与发现、自动 Router 路由等。探索具备自主规划能力的通用智能体产品与平台。社区发布了基于 Spring AI Alibaba 框架实现的 JManus 智能体除了对标 OpenManus 的通用智能体能力外我们的目标是基于 JManus 探索自主规划在智能体开发方向的应用为开发者提供从低代码、高代码到零代码构建智能体的更灵活选择。与 Spring AI 的联系和区别Spring AI 是 Spring 官方社区维护的开源框架最初于 2024 年 5 月发布首个 Milestone 版本在 2025 年 5 月正式发布首个 1.0 GA 版本。Spring AI 侧重 AI 能力构建的底层原子能力抽象以及与 Spring Boot 生态的无缝集成如模型通信ChatModel、提示词Prompt、检索增强生成RAG、记忆ChatMemory、工具Tool、模型上下文协议MCP等帮助 Java 开发者快速构建 AI 应用。自 2024 年 9 月正式开源以来Spring AI Alibaba 一直与 Spring AI 社区有深度沟通合作期间发布了多个 Milestone 版本并与很多企业客户建立的深度合作关系。在交流过程中我们看到了低代码开发模式的优势与限制随着业务复杂度提升客户从聊天机器人、单智能体到对多智能体架构方案的诉求也看到了智能体开发从简单 Demo 走向生产上线过程中遇到的困难。官网 文档Spring AI Alibaba 官网https://java2ai.comSpring AI 官方网站https://spring.io/projects/spring-ai#overview阿里云百炼模型平台https://bailian.console.aliyun.com/console?tabmodel#/model-marketGithub 代码仓库Spring AI Alibaba 主仓库https://github.com/alibaba/spring-ai-alibabaSAA 官方示例工程https://github.com/springaialibaba/spring-ai-alibaba-examplesSpring AI 官方仓库https://github.com/spring-projects/spring-ai发布 技术文章Spring AI Alibaba 1.0 GA 发布公告https://java2ai.com/blog/spring-ai-alibaba-10-ga-release/?spm5176.29160081.0.0.2856aa5cww2t9DSpring AI 1.0 GA 解读文章https://java2ai.com/blog/spring-ai-100-ga-released二、SpringAI Alibaba整体架构流程分层链路微服务底座 → AI 开发框架层 → 大模型服务层上层微服务基础设施Spring Cloud Alibaba 生态包含服务发现、Nacos 配置、网关、负载均衡、监控、服务治理、安全管理整套云原生能力是企业现有 Java 业务系统的底座。 现有 Spring Cloud 微服务业务不需要重构可直接接入 AI 能力。中间 AI 框架层三选一LangChain4J社区 Java 大模型开发框架第三方生态Spring AISpring 官方原生 AI 抽象框架Spring AI AlibabaSAA基于 Spring AI 封装深度打通阿里云百炼 / 通义大模型、云原生微服务体系国内企业首选底层大模型服务模型推理接收业务请求调用大模型生成结果返回客户端模型训练持续调优模型参数优化输出效果Spring AI Alibaba 三大核心优势原生适配 Spring 全家桶完全基于 Spring AI原生兼容 Spring Boot通过 Bean 自动装配注入 AI 能力零侵入现有 Spring 项目无需复杂适配。一站式 AI 全栈抽象能力内置标准化封装Model 调用、Prompt 提示词模板、RAG 检索增强、Tool 函数调用、对话记忆、多智能体 Agent 等上层 AI 开发组件。阿里云云原生深度打通原生适配通义千问系列大模型、阿里云百炼平台无缝集成 Nacos 配置、网关、Serverless、ARMS 可观测、阿里云 ADB 向量库等云原生基础设施。核心底层逻辑SAA 完整继承 Spring AI 全部底层原子抽象同时额外扩展国内生态适配阿里云模型、向量存储、Nacos 提示词管理、微服务 MCP 注册、工作流等独有组件。三、三大 Java AI 框架横向对比Spring AI Alibaba / Spring AI / LangChain4J常见问题解答-阿里云Spring AI Alibaba官网官网当前主流 Java AI 框架对比情况对比维度Spring AI AlibabaSpring AILangChain4JSpring Boot 集成原生支持原生支持社区适配文本模型主流模型可扩展主流模型可扩展主流模型可扩展音视频、多模态、向量模型支持支持支持RAG模块化 RAG模块化 RAG模块化 RAG向量数据库主流向量数据库 阿里云ADB、OpenSearch等主流向量数据库主流向量数据库MCP 支持支持 Nacos MCP Registry 支持支持支持函数调用支持20官方工具集成支持支持提示词模版硬编码无声明式注解硬编码无声明式注解声明式注解提示词管理Nacos 配置中心无无Chat Memory优化版JDBC、Redis、ElasticSearchJDBC、Neo4j、Cassandra多种实现适配可观测性支持可接入阿里云ARMS支持部分支持工作流 Workflow支持兼容 Dify、百炼 DSL无无多智能体 Multi-agent支持官方通用智能体实现无无模型评测支持支持支持社区活跃度与文档健全性官方社区活跃度高官方社区活跃度高个人发起社区开发提效组件丰富包括调试、代码生成工具等无无Example 仓库丰富活跃度高较少丰富活跃度高Spring AI 与 Spring AI Alibaba 有什么差异Spring AI 定位 AI 应用开发底层框架提供了 AI 开发需要的底层原子抽象包括模型适配、工具定义、向量数据库存取等Spring AI Alibaba 定位 AI 智能体开发框架提供了基于图算法的智能体编程 Graph 框架让开发者更容易开发工作流、multi-agent 应用。为方便理解举个不完全正确的类比例子如果说 Spring AI 是 LangChain 生态中的 Langchain 框架的话则 Spring AI Alibaba 则是 Langchain 生态中的 Langraph 框架。除了框架本身外Spring AI Alibaba 是阿里云基于 Spring AI 框架的企业级智能体开发最佳实践与整体解决方案输出与阿里开源生态、阿里云平台服务等深度集成包含与百炼 Dashscope 模型服务集成支持 Qwen、Deepseek 等主流模型系列与百炼智能体应用平台 AgentScope 集成提供低代码、高代码双向转换提升研发效率与百炼析言 ChatBI 集成提供自然语言到 SQL 的自动生成开源框架与服务与阿里云云产品集成包括向量检索库AnalyticDB、向量检索库OpenSearch、信息检索服务 IQS 等与开源 Nacos、Higress 生态集成提供 MCP 注册中心、MCP 智能路由、Prompt管理、模型代理等能力提供前沿方向的智能体产品实现与整体解决方案包括 JManus、DeepResearch、NL2SQL 等。提供 AI 应用开发的完整配套生态包括本地开发工具、项目构建平台等。确定 Spring AI Alibaba 与 Spring AI、Spring Boot 版本的兼容关系Spring AI Alibaba 使用四位版本号的版本管理方式前三位版本号与 Spring AI 主版本对应Spring AI Alibaba 社区在前三位主版本基础上持续迭代第四位版本号。以下为部分版本对应关系新版发布版本依此类推:Spring AI AlibabaSpring AISpring Boot1.0.0.21.0.03.4.51.0.0-M6.11.0.0-M63.4.2核心选型结论企业微服务、使用阿里云、Spring Cloud Alibaba→ 首选 Spring AI Alibaba 独有优势Nacos 动态提示词、微服务 MCP、ARMS 监控、多智能体、工作流编排、阿里云百炼深度适配完美贴合国内 Java 后端技术栈。通用 Spring 项目、不依赖阿里云→ 标准 Spring AI独立 AI 应用、无 Spring 体系、轻量化→ LangChain4J主流大模型厂商对比业务选型参考阿里百炼通义千问优势性价比高、国内合规、Spring AI Alibaba 原生适配新企业用户千万 Token 免费额度适配政企场景支持私有化部署。OpenAI GPT能力强事实标准但国内无法直连仅适合海外业务。DeepSeek / 智谱清言 / 硅基流动 / Ollama开源 / 本地部署方案适合私有化、低成本场景但生态集成不如阿里百炼适配 SAA 顺滑。版本兼容规则Spring AI Alibaba 版本管理版本命名规则4 位版本号x.x.x.y前三位和 Spring AI 主版本一一对应第四位是 SAA 自主迭代补丁版本。 例1.0.0.2→ 对应 Spring AI 1.0.0适配 Spring Boot 3.4.5对应关系示例Spring AI Alibaba 1.0.0.2 → Spring AI 1.0.0 → Spring Boot 3.4.5Spring AI Alibaba 1.0.0-M6.1 → Spring AI 1.0.0-M6 → Spring Boot 3.4.2使用规范升级时必须对齐三者版本避免依赖冲突。四、Spring AI Alibaba 运行 Demo通义千问对话一环境版本约束严格对齐避免冲突Spring AI Alibaba1.0.0.2Spring AI1.0.0Spring Boot3.4.5JDK17二Maven POM 依赖xml?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version3.4.5/version relativePath/ /parent groupIdcom.ai/groupId artifactIdspring-ai-alibaba-demo/artifactId version0.0.1-SNAPSHOT/version nameSpring AI Alibaba Demo/name properties java.version17/java.version spring-ai-alibaba.version1.0.0.2/spring-ai-alibaba.version /properties dependencies !-- SpringBoot Web -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- Spring AI Alibaba 核心依赖 -- dependency groupIdcom.alibaba.spring.ai/groupId artifactIdspring-ai-alibaba-starter/artifactId version${spring-ai-alibaba.version}/version /dependency !-- 测试 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency /dependencies build plugins plugin groupIdorg.springframework.boot/groupId artifactIdspring-boot-maven-plugin/artifactId /plugin /plugins /build /project三配置文件 application.yml前往 阿里云百炼平台 获取api-keyyamlspring: ai: alibaba: api-key: 你的百炼API-Key # 默认通义千问可切换通义千问plus等 chat: options: model: qwen-turbo四启动类package com.ai.demo; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; SpringBootApplication public class AiDemoApplication { public static void main(String[] args) { SpringApplication.run(AiDemoApplication.class, args); } }五对话接口 Controller同步 流式输出package com.ai.demo.controller; import org.springframework.ai.chat.client.ChatClient; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; import reactor.core.publisher.Flux; RestController public class ChatController { // SpringAI自动注入ChatClient底层适配阿里云通义模型 private final ChatClient chatClient; public ChatController(ChatClient.Builder chatClientBuilder) { this.chatClient chatClientBuilder.build(); } /** * 同步对话接口一次性返回完整结果 */ GetMapping(/chat) public String chat(RequestParam String message) { return chatClient.prompt() .user(message) .call() .content(); } /** * 流式输出打字机效果前端SSE接收 */ GetMapping(/stream/chat) public FluxString streamChat(RequestParam String message) { return chatClient.prompt() .user(message) .stream() .content(); } }六测试同步接口浏览器 / Postman 访问http://127.0.0.1:8080/chat?message用Java写一个冒泡排序流式 SSE 接口实时分段返回http://127.0.0.1:8080/stream/chat?message介绍Spring AI Alibaba七扩展 DemoRAG 简单检索增强追加代码1. 新增向量库依赖阿里云 OpenSearch/ADB 二选一这里用内存向量库本地测试dependency groupIdorg.springframework.ai/groupId artifactIdspring-ai-starter-vector-store-memory/artifactId /dependency2. RAG 控制器package com.ai.demo.controller; import org.springframework.ai.chat.client.ChatClient; import org.springframework.ai.document.Document; import org.springframework.ai.vectorstore.MemoryVectorStore; import org.springframework.ai.vectorstore.VectorStore; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; import java.util.List; RestController public class RagController { private final ChatClient chatClient; private final VectorStore vectorStore; public RagController(ChatClient.Builder builder, MemoryVectorStore vectorStore) { this.chatClient builder.build(); this.vectorStore vectorStore; // 初始化知识库文档 vectorStore.add(List.of( new Document(Spring AI Alibaba 是阿里基于Spring AI开发深度集成阿里云百炼大模型的Java AI框架), new Document(Spring AI Alibaba完美兼容Spring Cloud Alibaba微服务生态支持Nacos配置管理提示词) )); } GetMapping(/rag/chat) public String ragChat(RequestParam String msg) { return chatClient.prompt() .user(msg) // 自动从向量库检索相关文档作为上下文 .advisors(advisor - advisor.retriever(vectorStore)) .call() .content(); } }访问http://127.0.0.1:8080/rag/chat?messageSpring AI Alibaba有什么优势八关键补充说明API Key 获取步骤登录阿里云百炼控制台https://bailian.console.aliyun.com/左侧「API-KEY 管理」创建密钥复制填入 yml模型切换修改spring.ai.alibaba.chat.options.modelqwen-turbo轻量快速qwen-plus更强理解qwen-max旗舰大模型生产环境优势原生对接 Nacos 动态管理 Prompt无需硬编码支持 ARMS 链路监控 AI 调用耗时、Token 消耗兼容 Spring Cloud 微服务网关、服务发现可封装 AI 微服务对外提供接口