Spring AI Alibaba 1.0 GA 正式发布，Java智能体开发进入新时代

2025 年是 AI 智能体快速爆发的一年，从单智能体、多智能体到通用智能体的多种不同构建模式持续涌现出来，智能体开发也逐步从概念、Demo 开始走向生产落地，应用范围也从编程助手等几个少数领域，逐步拓展到企业内部业务、生活工作助手等多个领域。

随着智能体开始在企业内部业务落地，Java 智能体的构建需求也呈现出爆发式增长的趋势，在智能体编程语言及平台领域，Python、Typescript 一直走在探索前沿，相对来说，Java 领域框架、平台及整体解决方案欠缺，Spring AI Alibaba 1.0 的发布，让 Java 智能体开发迎来一款生产可用的企业级框架与解决方案，助力企业智能体开发进入一个新阶段。

上半年，以 Manus 为代表的通用智能体的火爆，让具备自主规划能力的通用智能体进入大众视线，另一方面，MCP 则将模型或智能体外部数据、外部系统的交互方式做了统一。结合这些技术趋势，在探索 Spring AI Alibaba 框架、Manus 通用智能体的过程中，我们正逐步构建起一套零代码快速构建垂直领域智能体的方案（JManus），我们相信它能弥补低代码、高代码框架的开发复杂度问题，同时又能解决通用智能体效果难以满足企业级生产要求的弊端。

Spring AI Alibaba 是一款以 Spring AI 为基础，深度集成百炼平台，支持 ChatBot、工作流、多智能体应用开发模式的 AI 框架。

在 1.0 版本中，Spring AI Alibaba 提供以下核心能力，让开发者可以快速构建自己的 Agent、Workflow 或 Multi-agent 应用。

在 Spring Boot 工程中添加以下依赖，就可以开始您的 AI 智能体开发之旅了。

  <dependencyManagement>    <dependencies>      <dependency>        <groupId>com.alibaba.cloud.ai</groupId>        <artifactId>spring-ai-alibaba-bom</artifactId>        <version>1.0.0.2</version>        <type>pom</type>        <scope>import</scope>      </dependency>    </dependencies>  </dependencyManagement>
<dependencies>  <dependency>    <groupId>com.alibaba.cloud.ai</groupId>    <artifactId>spring-ai-alibaba-starter-dashscope</artifactId>  </dependency></dependencies>

您可以参考我们发布在官网的快速开始了解如何开发 Chatbot、智能体或工作流等应用：

• 官网：https://java2ai.com
• Github 仓库：https://github.com/alibaba/spring-ai-alibaba

总的来说，根据不同场景，您可以选择使用 ChatClient 或 Spring AI Alibaba Graph 两个核心组件来开发 AI 应用。

Spring AI Alibaba 官方社区开发了一个包含完整 “前端 UI+后端实现” 的智能体 Playground 示例，示例使用 Spring AI Alibaba 开发，可以体验聊天机器人、多轮对话、图片生成、多模态、工具调用、MCP集成、RAG 知识库等所有框架核心能力。

整体运行后的界面效果如下所示：

您可以本地部署 Playground 示例并通过浏览器访问体验，或者拷贝源码并按照自己的业务需求调整，以这种方式快速搭建一套自己的 AI 应用。

如果想通过更多示例来学习 Spring AI Alibaba 框架用法，请参考我们的官方示例仓库：

https://github.com/springaialibaba/spring-ai-alibaba-examples

随着 Spring AI 1.0 GA 版本的发布，Java 智能体开发迎来了一款具备完整官方支持、生产可用的编程框架，Java 智能体开发进入新时代。

在底层原子抽象能力上，Spring AI Alibaba 支持 Spring AI 的所有核心能力，并在此基础上提供了大量适配实现与最佳实践。以下是 Spring AI 核心定义列表：

• 提示（Prompt）
  

• 模型增强（The Augmented LLM）
  
• 顾问（Advisors）
  
• 检索（Retrieval）
• 记忆（ChatMemory）
• 工具（Tool）
• 评估（Evaluation）
• 可观测性（Observability）
• 模型上下文协议（MCP）

• MCP 客户端
• MCP 服务器

• MCP 和安全

Graph 是 Spring AI Alibaba 社区核心实现之一，也是整个框架在设计理念上区别于 Spring AI 只做底层原子抽象的地方，Spring AI Alibaba 期望帮助开发者更容易地构建智能体应用。基于 Spring AI Alibaba Graph 开发者可以构建工作流、多智能体应用。Spring AI Alibaba Graph 在设计理念上借鉴 LangGraph，因此在一定程度上可以理解为是 Java 版的 LangGraph 实现，社区在此基础上增加了大量预置 Node、简化了 State 定义过程等，让开发者更容易编写对等低代码平台的工作流、多智能体等。

Spring AI Alibaba Graph 核心能力：

• 支持 Multi-agent，内置 ReAct Agent、Supervisor 等常规智能体模式
• 支持工作流，内置工作流节点，与主流低代码平台对齐
• 原生支持 Streaming
• Human-in-the-loop，通过人类确认节点，支持修改状态、恢复执行
• 支持记忆与持久存储
• 支持流程快照
• 支持嵌套分支、并行分支
• PlantUML、Mermaid 可视化导出

关于 Graph 的具体使用方式，请关注官网文档更新。在下文中我们会介绍官方发布的 基于 Spring AI Alibaba 实现的通用智能体平台，您可以把这些官方智能体实现当作 Graph 的最佳应用实践。

在 Agent 生产落地过程中，用户需要解决智能体效果评估、MCP 工具集成、Prompt 管理、Token 上下文、可视化 Tracing 等各种问题，Spring AI Alibaba 通过与 Nacos3、Higress AI 网关、阿里云 ARMS、阿里云向量检索数据库、百炼智能体平台等深度集成，提供全面的智能体企业级生产解决方案，加速智能体从 Demo 走向生产落地。

Spring AI Alibaba MCP 通过集成 Nacos MCP Registry，支持 MCP Server 分布式部署与负载均衡调用。对于存量 Spring Cloud、Dubbo 等应用，支持零代码改造实现 API 到 MCP 服务发布，开发者可通过 Spring AI Alibaba MCP 开发自己的 MCP Server 服务代理，即可支持 Nacos 中心 MCP 元数据的自动加载。

如果您使用 Higress 作为后端模型代理，则可以通过 OpenAI 标准接口接入 Higress AI 模型代理服务，只需要使用spring-ai-starter-model-openai就可以了。

如果您有存量的 API 服务，需要在无需修改代码的情况下，可以使用 Higress 作为 API 到 MCP 服务的代理方案。

a. 百炼 RAG 知识库

百炼是一款可视化 AI 智能体应用开发平台，它提供 RAG 知识库管理能力。简单来讲，您可以将私有数据上传到百炼平台，借助百炼平台数据解析、切片、向量化等能力实现数据向量化预处理，处理后的数据可用于后续 Spring AI Alibaba 智能体应用检索，借用百炼平台强大的数据处理效果。

b. 百炼析言 ChatBI，从自然语言到 SQL 自动生成

Spring AI Alibaba NL2SQL 模块可基于大模型的 ChatBI 技术，帮助用户轻松实现自然语言交互的数据分析，理解用户的数据库 schema，帮助用户自动生成 SQL 查询语句。无论是简单的条件过滤还是复杂的聚合统计、多表关联，都能准确生成对应的 SQL 语句。

Spring AI 在多个关键节点都做了 SDK 默认埋点，用来记录运行过程中的 metrics 与 tracing 信息，这包括模型调用、向量检索、工具调用等关键环节的调用情况。Spring AI tracing 信息兼容 OpenTelemetry，因此理论上可接入市面上主流的开源平台如 Langfuse，或者阿里云 ARMS。

AI 应用开发不只是无状态大模型的 API 调用过程，由于大模型预训练的特性，AI 应用还需要具备领域数据检索（RAG）、会话记忆（Memory）、工具调用（Tool）等集成能力，这些对外集成统称为模型增强模式（The Augmented LLM），它允许开发者将自己的数据和外部 API 直接带入模型的推理过程。

此图出自 Anthropic《Building Effective AI Agents》文章

ChatClient 是 Spring AI 中最核心的组件，开发者可以使用 ChatClient 开发自己的聊天机器人或智能体应用，ChatClient 支持模型增强模式，为模型调用挂载 Retrieval、Tools、Memory 等外部数据与服务。

Flux<String> response = chatClient.prompt(query)        .tools(toolCallbacks)        .advisors(new QuestionAnswerAdvisor())        .stream()        .content();

我们这里把 ChatClient 开发的 AI 应用称为单智能体应用，这可能是我们最理想的智能体开发模式，它足够简单直接，即把所有的工具、上下文信息等给到模型，由模型持续决策、迭代直到最终完成任务解答。然而，事情远没有那么简单，模型的能力还远未达到我们想要的效果，当我们给模型的上下文、工具过多时，整体效果就会变差，有时事情的走向会严重偏离我们的预期。因此，我们考虑把复杂的问题拆解开来，当前有两种常用模式：工作流和多智能体。

工作流是以相对固化的模式来人为地拆解任务，将一个大任务拆解为包含多个分支的固化流程。工作流的优势是确定性强，模型作为流程中的一个节点起到的更多是一个分类决策的职责，因此它更适合意图识别等类别属性强的应用场景。工作流也有明显的劣势，它要求开发人员对业务流程有深刻的理解，整个流程是由人绘制的，模型在其中更多的只是内容生成、总结、分类识别的作用，并不能最大化利用模型的推理能力，因此很多人诟病这种模式是不够智能的。

应用 Spring AI Alibaba Graph 可以轻松开发工作流，声明不同的节点，并将节点串联成一个流程图。

值得注意的是，Spring AI Alibaba Graph 中提供大量预置节点，这些节点可以对标到市面上主流的如 dify、百炼等低代码平台，典型节点包括 LlmNode（大模型节点）、QuestionClassifierNode（问题分类节点）、ToolNode（工具节点）等，为用户免去重复开发、定义的负担，只需要专注流程串联。

以上是一个可视化绘制的“用户评价分类系统”工作流，对应 Spring AI Alibaba Graph 代码如下所示：

StateGraph stateGraph = new StateGraph("Consumer Service Workflow Demo", stateFactory)      .addNode("feedback_classifier", node_async(feedbackClassifier))      .addNode("specific_question_classifier", node_async(specificQuestionClassifier))      .addNode("recorder", node_async(new RecordingNode()))
      .addEdge(START, "feedback_classifier")      .addConditionalEdges("feedback_classifier",edge_async(new CustomerServiceController.FeedbackQuestionDispatcher()),Map.of("positive", "recorder", "negative", "specific_question_classifier"))      .addConditionalEdges("specific_question_classifier",edge_async(new CustomerServiceController.SpecificQuestionDispatcher()),Map.of("after-sale", "recorder", "transportation", "recorder", "quality", "recorder", "others","recorder"))      .addEdge("recorder", END);

复杂任务拆解的另一种解决方案是多智能体，相比于工作流，多智能体虽也遵循特定的流程，但是在整个决策、执行流程上具备更多的自主性和灵活性。多个子智能体间通过通信协作完成，最终完成任务解答，在业界，有多种常见的多智能体通信模型，如下图是几个典型示例：

图片出自 Langchain 官方博客

Spring AI Alibaba Graph 可用来开发各种多智能体模式。官方社区目前发布了几款基于 Spring AI Alibaba Graph 开发的智能体产品，包括通用智能体 JManus、DeepResearch 智能体、AgentScope 等。

Spring AI Alibaba 定位为以 ChatClient、Graph 抽象为核心的智能体框架，集成框架周边生态，用来帮助用户开发快速构建企业级 AI 智能体。

随着通用智能体模式的快速发展，社区也在基于 Spring AI Alibaba 探索具备自主规划能力的智能体产品与平台，目前已经发布了 JManus、DeepResearch 两款产品，通过 JManus 等智能体产品，一方面探索智能体在解决日常生活、工作效率等开放性问题方面的无限空间；另一方面，社区也在智能体开发平台、深度搜索等垂直领域持续探索，期望在低代码平台、高代码框架之外，为开发者带来面向自然语言的零代码智能体研发体验。

在我们最开始发布 JManus 时，给它的定位是一款完全以 Java 语言为核心、彻底开源的 Manus 复刻实现，基于 Spring AI Alibaba 实现的通用 AI Agent 产品，包含一个设计良好的前端 UI 交互界面。

随着我们对于通用智能体等方向的深度探索，我们对于 JManus 通用智能体的最终产品定位也进行了调整。Manus 的横空出世，让通用智能体自动规划、执行规划的能力给了人们无限想象空间，它非常擅长解决开放性问题，在日常生活、工作等场景都能有广泛的应用。但在实践中人们也开始认识到，基于当前以及未来相当长时间内的模型能力，完全依赖通用智能体的自动规划模式很难解决一些确定性极强的企业场景问题。企业级业务场景的典型特点是确定性，我们需要定制化的工具、子agent，需要稳定而又确定性强的规划与流程，为此，我们期望 JManus 能成为一个智能体开发平台，让用户能以最直观、低成本的方式构建自己垂直领域的智能体实现。

当前，JManus 具备以下核心能力：

• 完整实现了 Manus 多智能体产品
  
  JManus 完整实现了 Manus 产品能力，用户可以基于 UI 界面使用产品功能，JManus 可以基于自动规划模式帮助用户完成问题解答。
• 无缝支持 MCP（Model Context Protocol）工具集成
  
  这意味着 Agent 不仅可以调用本地或云端的大语言模型，还能与各类外部服务、API、数据库等进行深度交互，极大拓展了应用场景和能力边界。
• 原生支持 PLAN-ACT 模式
  
  能够让 Agent 具备复杂推理、分步执行和动态调整的能力，适用于多轮对话、复杂决策、自动化流程等高阶 AI 应用场景。
• 支持通过 UI 界面配置 Agent
  
  开发者和运维人员无需修改底层代码，只需在直观的Web管理界面上进行简单操作，就能灵活调整Agent的参数、模型和工具，还可以调整任务规划，大大提升了易用性和运维效率。
• 自动生成基于 SAA 的智能体工程
  用户通过自然语言与 JManus 交互，生成规划并沉淀为特定垂直方向的固化解决方案。如果您不想将运行态限定在平台之上，我们正在探索与低代码平台、框架脚手架的深度整合，支持规划转换为具备对等能力的 Spring AI Alibaba 工程。
  
  

JManus 智能体平台还在持续开发建设中，请关注官方仓库源码及后续发布动态。

DeepResearch 是一款基于 Spring AI Alibaba Graph 开发的 Deep Research 智能体，包含完整的前端 Web UI（开发中） 和后端实现，DeepResearch 支持一系列精心设计的工具如 Web Search（网络查询）、Crawling（爬虫）、Python 脚本引擎等，可以借助大模型与工具能力，帮助用户完成各类深度调研报告。

以下是 DeepResearch 多智能体应用架构：

DeepResearch 智能体还在持续开发建设中，请关注官方仓库源码及后续发布动态。

• 框架自身的持续迭代优化，如基于 Spring AI 最新设计升级内部实现，优化性能和稳定性，提供更丰富的智能体开发工具与组件。
• 可观测与评估平台。目前 Spring AI Alibaba 支持通过 OpenTelemetry 接入市面上主流的可观测产品，但我们将加强与阿里云 ARMS、百炼模型评测系统的集成，提供更完善的监控与效果评估能力。
• 本地项目构建与调试工具。提升 Agent、Graph 研发效率，支持本地化可视化调试。
• 所见即所得，从拖拽绘图到代码自动生成。社区正推进深度集成百炼 DashScope、Dify 等 AI 应用开发平台，支持可视化绘制 AI 工作流，一键导出 Spring AI Alibaba 代码工程。
• 自动智能体开发平台，相较于低代码拖拽、框架直接编码两种模式，社区将探索智能体基于模型规划与 MCP Registry 的自动智能体研发模式。
• 深度参与 MCP、A2A、AG-UI 等智能体协议共建。

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 孵化自企业智能体构建过程，目标是为企业提供开箱即用的企业级解决方案，包括多智能体搭建与编排的 Graph 框架、低代码框架集成、企业数据与工具集成、效果评估、通用智能体产品与平台构建等。

• Spring AI Alibaba 官网：https://java2ai.com
• Spring AI Alibaba 仓库：https://github.com/alibaba/spring-ai-alibaba
• Spring AI Alibaba 官方示例仓库：https://github.com/springaialibaba/spring-ai-alibaba-examples

• Playground 示例：https://github.com/springaialibaba/spring-ai-alibaba-examples/tree/main/spring-ai-alibaba-playground

Spring AI Alibaba 目前已经有接近 100 位贡献者，持续为仓库提交代码、使用反馈等，非常感谢各位开源贡献者的付出，使得 Spring AI Alibaba 1.0 得以正式发布。

感谢 Spring AI、Langchain 等 AI 社区及开源项目为开源做出的卓越贡献，不断地给 AI Agent 开发带来新思路与产品。