alibaba/spring-ai-alibaba View GitHub Homepage for Latest Official Releases

为Java开发者打造的企业级智能体AI框架，基于Spring AI并深度集成阿里云，用于构建智能代理、工作流和多智能体应用。

Apache-2.0Javaspring-ai-alibabaalibaba 7.5k Last Updated: December 15, 2025

Spring AI Alibaba - 面向 Java 开发者的智能体 AI 框架

概述

Spring AI Alibaba 是一个专为 Java 开发者设计的企业级 AI 应用开发框架。它基于 Spring AI 构建，并与阿里云百炼平台深度集成，为在生产环境中构建智能体、工作流和多智能体应用提供了全面的解决方案。

官方仓库： https://github.com/alibaba/spring-ai-alibaba 官方网站： https://java2ai.com 许可证： 开源 要求： JDK 17+

核心架构

该框架由三个基本组件组成：

1. 智能体框架 (Agent Framework)

一个基于 ReactAgent 的开发框架，以 ReAct（推理 + 行动）范式为核心。它使开发者能够构建具有自动上下文工程和人机协作（Human-in-the-loop）能力的智能体。对于复杂场景，它提供了内置的工作流模式，包括：

顺序智能体 (SequentialAgent)：按顺序执行智能体
并行智能体 (ParallelAgent)：并发运行多个智能体
路由智能体 (RoutingAgent)：根据条件路由请求
循环智能体 (LoopAgent)：实现迭代工作流

2. 图运行时 (Graph Runtime)

一个受 LangGraph 启发的低级工作流和多智能体编排框架。它具有以下特点：

丰富的预构建工作流节点集
简化的图状态定义
原生流式支持
人机协作集成
内存和持久化存储
图状态快照
嵌套和并行图执行
PlantUML 和 Mermaid 格式导出

3. Spring Boot Starter

集成 Starter，将智能体框架与 Nacos 等企业服务连接，提供：

智能体到智能体 (A2A) 通信
动态配置管理
分布式 MCP（模型上下文协议）发现和路由

关键特性

智能体开发

ReactAgent 模式：遵循 ReAct 范式构建具有推理和行动能力的智能体
多智能体编排：组合多个智能体以执行复杂任务
上下文工程：内置提示工程和上下文管理的最佳实践
人机协作 (Human In The Loop)：无缝集成人工反馈和审批步骤
流式支持：以令牌粒度实时流式传输智能体响应
错误处理：健壮的错误恢复和重试机制

模型与工具集成

多种大型语言模型 (LLM) 提供商：支持通义千问 (Qwen)、DeepSeek、OpenAI 和其他提供商
工具调用：通过 FunctionToolCallback 提供全面的函数调用能力
模型上下文协议 (MCP)：全面支持 MCP，实现标准化的模型交互
结构化输出：定义输出模式和类型以控制格式
多模态支持：处理文本、图像和其他模态

企业级特性

Nacos MCP 注册中心：分布式 MCP 服务发现和负载均衡
Higress AI 网关：LLM 模型代理和路由
ARMS 可观测性：与阿里云应用实时监控服务集成
Langfuse 集成：全面的追踪和评估
向量存储：支持多种向量数据库（Hologres、AnalyticDB、OpenSearch）
RAG 支持：完整的检索增强生成管道
聊天记忆：多轮对话的会话记忆管理
NL2SQL：自然语言到 SQL 转换

附加能力

文档解析：支持多种格式（PDF、Word、Excel 等）
图像生成：基于通义万相的图像模型集成
音频处理：音频转录和合成
提示管理：与 Nacos 集成的动态提示模板
工作流可视化：将工作流导出为 PlantUML 和 Mermaid 格式

快速入门

快速开始示例

将依赖项添加到您的 Spring Boot 项目：

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

<dependencies>
  <dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-agent-framework</artifactId>
  </dependency>
  <dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
  </dependency>
</dependencies>

简单 ReactAgent 示例

// 初始化聊天模型
DashScopeApi dashScopeApi = DashScopeApi.builder()
    .apiKey(System.getenv("AI_DASHSCOPE_API_KEY"))
    .build();

DashScopeChatModel chatModel = DashScopeChatModel.builder()
    .dashScopeApi(dashScopeApi)
    .build();

// 创建 ReactAgent
ReactAgent writerAgent = ReactAgent.builder()
    .name("writer_agent")
    .model(chatModel)
    .description("一位专业的写作智能体")
    .instruction("你是一位擅长创意写作的著名作家。")
    .outputKey("article")
    .build();

// 调用智能体
AssistantMessage message = writerAgent.call("写一篇关于 AI 的 100 字短文");

多智能体工作流示例

// 创建审阅智能体
ReactAgent reviewerAgent = ReactAgent.builder()
    .name("reviewer_agent")
    .model(chatModel)
    .description("审阅和编辑文章")
    .instruction("你是一位审阅和改进内容的专家编辑。")
    .outputKey("reviewed_article")
    .build();

// 按顺序组合智能体
SequentialAgent blogAgent = SequentialAgent.builder()
    .name("blog_agent")
    .description("撰写和审阅文章")
    .subAgents(List.of(writerAgent, reviewerAgent))
    .build();

// 执行工作流
Optional<OverAllState> result = blogAgent.invoke("写一篇关于 Spring AI 的博客文章");

官方产品与示例

JManus

一个使用 Spring AI Alibaba 构建的 Manus（通用 AI 智能体）的 Java 实现。它支持：

自主规划和执行
针对特定业务场景的微调智能体
定制工具和子智能体
计划调整和重用能力
目前已在阿里巴巴集团的许多应用中使用

DeepResearch

一个智能研究智能体，具有以下特点：

完整的前端 Web UI 和后端实现
Web 搜索和爬取能力
Python 脚本引擎集成
MCP 服务支持
使用 LLM 和工具生成全面的研究报告

DataAgent

一个自然语言到 SQL 的项目，支持：

使用自然语言直接查询数据库
无需编写复杂的 SQL 语句
与企业数据库无缝集成

Playground

一个全面的示例应用程序，具有：

完整的前端 UI 和后端实现
演示所有核心框架功能
特性：聊天机器人、多轮对话、图像生成、多模态、工具调用、MCP、RAG
可用于本地部署和定制

Spring AI Alibaba Admin

本地可视化工具包，提供：

项目管理
运行时可视化
追踪和调试
智能体评估工具

生态系统集成

阿里云服务

百炼平台：LLM 模型服务（通义系列、DeepSeek）
通义万相：全面的 AI 模型服务平台
向量存储：Hologres、AnalyticDB、OpenSearch
ARMS：应用监控和可观测性
Nacos：配置和服务发现

第三方集成

Langfuse：追踪和评估
OpenAI：兼容 OpenAI API
Higress：用于模型路由的 AI 网关
Spring AI：基于 Spring AI 核心概念构建

版本信息

当前稳定版本： 1.0.0.2 (GA) 最新版本： 1.1.0.0-M5 (里程碑)

1.1.x 版本特性

增强的智能体开发模式（智能体式、多智能体、工作流）
改进的图运行时
增强的 A2A 通信
更好的 MCP 集成
升级的文档和官方网站

1.0.x 版本特性

首个 GA 版本发布
生产就绪框架
完整的聊天机器人、工作流和多智能体支持
深度阿里云集成
基于图的多智能体框架

可用 Starter

spring-ai-alibaba-starter-dashscope - 通义万相模型集成
spring-ai-alibaba-agent-framework - 智能体框架核心
spring-ai-alibaba-graph-core - 图运行时
spring-ai-alibaba-starter-nl2sql - 自然语言到 SQL
spring-ai-alibaba-starter-memory - 聊天记忆管理
spring-ai-alibaba-starter-nacos-mcp-client - Nacos MCP 客户端
spring-ai-alibaba-starter-nacos-mcp-server - Nacos MCP 服务端
spring-ai-alibaba-starter-nacos-prompt - 提示管理
spring-ai-alibaba-starter-arms-observation - ARMS 可观测性
spring-ai-alibaba-starter-rag - RAG 能力

社区与支持

沟通渠道

钉钉群：搜索 130240015687 并加入
微信：关注官方微信公众号
GitHub Discussions：社区讨论和问答
官方文档：https://java2ai.com

用例

企业应用

客户服务聊天机器人
内部业务自动化
文档处理和分析
知识库问答系统
代码生成和审查

垂直领域智能体

领域特定智能助手
自动化研究和报告
数据分析和可视化
流程自动化和编排
多步骤工作流执行

开发工具

AI 驱动的编程助手
代码审查和优化
文档生成
测试和调试支持

技术优势

Java 原生：对 Java 生态系统和 Spring Boot 的一流支持
企业级：在阿里巴巴集团经过生产验证
云原生：与阿里云基础设施深度集成
灵活架构：支持各种开发模式（低代码、高代码、零代码）
全面工具：丰富的智能体开发工具和组件集
活跃社区：强大的社区支持和定期更新
最佳实践：内置来自真实企业部署的模式

与其他框架的比较

与基于 Python 的框架（LangChain、LangGraph）不同，Spring AI Alibaba 提供：

原生 Java 支持与 Spring Boot 生态系统集成
企业级特性（可观测性、网关、配置管理）
生产就绪部署与云原生基础设施
与阿里云服务的无缝集成
强类型和编译时安全
在 JVM 环境中卓越的性能

未来路线图

持续的框架优化和性能改进
增强的智能体开发模式和工具
扩展的模型提供商支持
更全面的文档和教程
额外的企业集成能力
社区驱动的特性和改进

结论

Spring AI Alibaba 代表了基于 Java 的 AI 应用开发的重大进步，将企业级智能体框架引入 Java 生态系统。凭借其全面的功能、深度云集成和经过生产验证的架构，它使 Java 开发者能够以他们对 Spring 生态系统所期望的相同生产力和可靠性来构建复杂的 AI 应用。

无论您是构建简单的聊天机器人、复杂的多智能体系统还是企业工作流自动化，Spring AI Alibaba 都提供了将您的 AI 应用从演示带到生产所需的工具、模式和基础设施。