Spring AI Alibaba

一个用于构建代理式、工作流和多智能体应用的生产就绪框架。

Agent Framework 文档, Graph 文档, Spring AI, 示例.

架构

Spring AI Alibaba Admin 是一个一站式代理平台，支持可视化的代理开发、可观测性、评估以及 MCP 管理等功能。它还与 Dify 等开源低代码平台集成，从而实现从 DSL 到 Spring AI Alibaba 项目的快速迁移。

Spring AI Alibaba Agent Framework 是一个代理开发框架，能够快速开发具备内置 上下文工程 和 人类参与循环 支持的代理。对于需要更复杂流程控制的场景，Agent Framework 提供了 SequentialAgent、ParallelAgent、RoutingAgent 和 LoopAgent 等内置工作流。

Spring AI Alibaba Graph 作为 Agent Framework 的底层运行时，提供了持久化、工作流编排以及长时运行有状态代理所需的流式处理等核心能力。相比 Agent Framework，用户可以基于 Graph API 构建更加灵活的多智能体工作流。

核心特性

• 多智能体编排：使用内置模式（如 SequentialAgent、ParallelAgent、RoutingAgent 和 LoopAgent）组合多个智能体，以执行复杂任务。

• 多模态支持：支持文本和媒体输入（图像理解）的 ReactAgent；支持基于工具生成图像或音频的 ReactAgent。

• 语音代理：基于 WebSocket 的实时语音代理，支持流式音频或文本输入，并以生成的音频进行响应。

• 上下文工程：内置上下文工程策略的最佳实践，以提升代理的可靠性和性能，包括人类参与循环、上下文压缩、上下文编辑、模型与工具调用限制、工具重试、规划以及动态工具选择。

• 基于图的工作流：基于图的工作流运行时及 API，支持条件路由、嵌套图、并行执行和状态管理。可将工作流导出为 PlantUML 和 Mermaid 格式。

• A2A 支持：通过 Nacos 集成实现代理间通信，支持跨服务的分布式代理协调与协作。

• 丰富的模型、工具和 MCP 支持：依托 Spring AI 的核心概念，支持多家 LLM 提供商（DashScope、OpenAI 等）、工具调用以及模型上下文协议（MCP）。

• 一站式代理平台：以可视化方式构建代理，无需编写代码即可部署，也可导出为独立的 Java 项目。

开始使用

先决条件

• 需要 JDK 17 或更高版本。
• 选择您的 LLM 提供商并获取 API 密钥。

快速运行聊天机器人

社区提供了一个聊天机器人示例，位于 examples/chatbot。

1. 下载代码。

   git clone --depth=1 https://github.com/alibaba/spring-ai-alibaba.git
   cd spring-ai-alibaba
   

2. 启动聊天机器人。

   在启动之前，请先设置 API 密钥（访问 阿里云百炼 获取 API 密钥）：

   # 此示例使用 'spring-ai-alibaba-starter-dashscope'，请访问 https://java2ai.com 了解如何使用 OpenAI/DeepSeek。
   export AI_DASHSCOPE_API_KEY=your-api-key
   

   # 使用 mvnw 时，Maven 安装是可选的。
   ./mvnw -pl examples/chatbot spring-boot:run
   

3. 与聊天机器人对话。

   打开浏览器并访问 http://localhost:8080/chatui/index.html，即可与聊天机器人进行对话。

聊天机器人代码解析

1. 添加依赖项

   <dependencies>
     <dependency>
       <groupId>com.alibaba.cloud.ai</groupId>
       <artifactId>spring-ai-alibaba-agent-framework</artifactId>
       <version>1.1.2.0</version>
     </dependency>
     <!-- 假设您将使用 DashScope 模型。有关如何选择模型的信息，请参阅文档。-->
     <dependency>
       <groupId>com.alibaba.cloud.ai</groupId>
       <artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
       <version>1.1.2.1</version>
     </dependency>
   </dependencies>
   

2. 定义聊天机器人

   有关如何编写聊天机器人的更多详细信息，请查看我们官方网站上的 快速入门。

📚 文档

• 概述 - 框架的高层次概述
• 快速入门 - 通过一个简单智能体开始使用
• 智能体框架教程 - 分步教程
• 使用图API构建复杂工作流 - 构建多智能体和工作流的深入用户指南
• Spring AI基础 - AI应用的基本概念，包括ChatModel、MCP、工具、消息等。

项目结构

本项目由几个核心组件组成：

• spring-ai-alibaba-agent-framework：一个多智能体框架，专为构建具备内置上下文工程最佳实践的智能体而设计。
• spring-ai-alibaba-graph：Agent Framework的底层运行时。我们建议开发者使用Agent Framework，但直接使用Graph API也是完全可以的。
• spring-ai-alibaba-admin：一个一站式智能体平台，支持可视化智能体开发、可观测性、评估以及MCP管理等功能。
• spring-ai-alibaba-studio：用于以可视化方式快速调试智能体的嵌入式UI。
• spring-boot-starters：将Agent Framework与Nacos集成的启动器，提供A2A和动态配置功能。

Spring AI阿里巴巴生态体系

仓库	描述	⭐
Spring AI阿里巴巴图	用于构建、管理和部署长期运行、有状态智能体的低级编排框架和运行时。
Spring AI阿里巴巴管理平台	本地可视化工具包，用于智能体应用开发，支持项目管理、运行时可视化、追踪及智能体评估。
Spring AI扩展	Spring AI核心概念的扩展实现，包括DashScopeChatModel、MCP注册表等。
Spring AI阿里巴巴示例	Spring AI阿里巴巴示例项目。
JManus	基于Spring AI阿里巴巴实现的Java版Manus，目前在阿里巴巴集团内部的许多应用中使用。
DataAgent	基于Spring AI阿里巴巴的自然语言转SQL项目，使您无需编写复杂的SQL即可直接用自然语言查询数据库。
DeepResearch	基于spring-ai-alibaba-graph实现的深度研究工具。

联系我们

• 钉钉群，搜索94405033092并加入。

• 微信公众号，扫描下方二维码并关注我们。

资源

• AI原生应用架构白皮书：由40位一线工程师联合撰写，并得到15位行业专家的认可，这本超过20万字的白皮书是首份专门针对AI原生应用全DevOps生命周期的综合指南。它系统地剖析了核心概念和关键挑战，提供了实用的问题解决方法和架构洞察。

星标历史

---

由Spring AI阿里巴巴团队用心打造

Spring AI Alibaba 快速上手指南

Spring AI Alibaba 是一个生产级的框架，用于构建智能体（Agent）、工作流（Workflow）及多智能体应用。它基于 Spring AI 生态，内置了上下文工程、人机协同（Human-in-the-Loop）及多种多智能体编排模式。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• JDK 版本：必须安装 JDK 17 或更高版本。
• 构建工具：推荐使用 Maven 或项目自带的 mvnw wrapper。
• 大模型 API Key：
  • 默认示例使用阿里云百炼（DashScope）。
  • 请访问 阿里云百炼控制台 获取 API-KEY。
  • 该框架也支持 OpenAI、DeepSeek 等其他模型提供商。

安装步骤

我们可以通过克隆官方仓库并运行示例项目来快速体验。

1. 下载源代码 使用 Git 克隆项目（使用 --depth=1 可加速下载）：

   git clone --depth=1 https://github.com/alibaba/spring-ai-alibaba.git
   cd spring-ai-alibaba
   

2. 配置 API Key 在启动前，需要设置环境变量。以下以 DashScope 为例：

   # Linux/macOS
   export AI_DASHSCOPE_API_KEY=your-api-key
   
   # Windows (PowerShell)
   $env:AI_DASHSCOPE_API_KEY="your-api-key"
   

3. 运行示例 ChatBot 使用 Maven Wrapper 启动内置的 ChatBot 示例：

   ./mvnw -pl examples/chatbot spring-boot:run
   

   (注：如果本地已安装 Maven，也可直接使用 mvn 命令)

基本使用

启动成功后，即可在浏览器中访问交互界面，或在您的项目中集成依赖进行开发。

1. 体验 Web 界面

打开浏览器访问以下地址，即可与 AI 机器人对话：

http://localhost:8080/chatui/index.html

2. 在项目中进行开发

若要在自己的 Spring Boot 项目中集成 Spring AI Alibaba，请在 pom.xml 中添加以下核心依赖：

<dependencies>
  <!-- Agent Framework 核心依赖 -->
  <dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-agent-framework</artifactId>
    <version>1.1.2.0</version>
  </dependency>
  
  <!-- 模型启动器 (以通义千问 DashScope 为例) -->
  <dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
    <version>1.1.2.1</version>
  </dependency>
</dependencies>

核心能力概览：

• 多智能体编排：内置 SequentialAgent (串行), ParallelAgent (并行), RoutingAgent (路由), LoopAgent (循环) 等模式。
• 上下文工程：自动处理上下文压缩、编辑及工具调用限制。
• 可视化开发：可结合 Spring AI Alibaba Admin 平台进行低代码 Agent 开发与调试。

更多详细教程与高级用法（如 Graph API 工作流、A2A 通信等），请参考 官方文档。