alibaba/spring-ai-alibaba

项目介绍

Spring AI Alibaba 是建立在 Spring AI 之上的 Java 框架，用来构建智能体、工作流和多智能体应用。它面向需要生产级智能体编排的 Java/Spring 开发者，而不是只包一层对话接口。项目分为三层：Agent Framework 负责快速定义智能体，内置上下文工程和 Human In The Loop；Graph 是底层运行时，提供持久化、工作流编排和流式输出，支撑长时间运行的有状态智能体；Admin 是可视化平台，支持智能体开发、可观测性、评测和 MCP 管理，还能导入 Dify DSL README 第 21–32 行。

核心能力包括内置多智能体模式（SequentialAgent、ParallelAgent、RoutingAgent、LoopAgent）、多模态 ReactAgent 输入、基于 WebSocket 的语音智能体、支持条件路由和嵌套图的 Graph 工作流、结合 Nacos 的 A2A 通信，以及多模型提供方和 MCP 支持 README 第 33–54 行。

快速使用

前提是 JDK 17+ 和所选模型提供方的 API Key README 第 57–61 行。

1. 克隆仓库并进入目录：

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

2. 设置 DashScope API Key。示例使用 spring-ai-alibaba-starter-dashscope starter；OpenAI 和 DeepSeek 的用法见文档：

   export AI_DASHSCOPE_API_KEY=your-api-key
   

3. 运行社区 chatbot 示例，使用 wrapper 时本地无需安装 Maven：

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

4. 打开 http://localhost:8080/chatui/index.html 与机器人对话 README 第 62–93 行。示例源码在 examples/chatbot。

新建应用时，在 Maven 依赖中加入 spring-ai-alibaba-agent-framework 和模型 starter（如 spring-ai-alibaba-starter-dashscope），然后按 Quick Start 编写 Chatbot 定义，因为 README 只给出依赖片段，智能体代码需要看文档 README 第 94–117 行。

使用约束

• 需要 Java 17 或更高版本，并准备支持模型提供方的有效 API Key，否则智能体无法运行。
• 这是框架而非开箱即用的终端应用，实际使用需要编写 Java/Spring 代码或通过 Admin 平台操作。
• Agent、Graph、Admin 和 Studio 是各自独立的模块和入口，应按任务选择对应层，而不是假设一个构建产物覆盖所有工作流。
• 项目采用 Apache-2.0 许可证，并发布到 Maven Central Maven Central 构件。

HotRepo 点评

项目当前有 11,110 个 Star 和 2,470 个 Fork。2026-11-05 的 Java 日榜记录中新增 3 个 Star，排名第 14，说明站内记录呈现的是一个稳定的成熟仓库，而非突然爆发。对已经在用 Spring AI 的 Java 团队来说，价值在于把 Agent Framework 的约定式封装和 Graph 的底层运行时分开：简单智能体保持简单，复杂多智能体流程下放到显式的图编排。