Repolode
alibaba

alibaba/spring-ai-alibaba

基于 Spring AI 的 Java 智能体框架,用于构建智能体、工作流和多智能体应用。

Star
11,044
Fork
2,455
未关闭 Issue
172
最近提交
14天前

这是什么?

Spring AI Alibaba 是一个用于构建 AI 智能体、图式工作流和多智能体系统的 Java 框架。它在 Spring AI 之上提供 Agent Framework,内置上下文工程和人在回路(Human In The Loop)支持,并提供 SequentialAgent、ParallelAgent、RoutingAgent、LoopAgent 等工作流智能体。

底层的 Graph 运行时负责长时运行、有状态智能体所需的持久化、工作流编排和流式输出,支持条件路由、嵌套图和并行执行,工作流可导出为 PlantUML 和 Mermaid 格式。项目还支持基于 Nacos 的 A2A 智能体间通信、多模态输入,以及基于 WebSocket 的语音智能体。

项目同时包含 Spring AI Alibaba Admin,用于可视化开发智能体、可观测性、评估和 MCP 管理,运行环境需要 JDK 17 及以上版本。示例中的 ChatBot 可通过 DashScope API Key 直接启动。

核心功能

  • 01支持 Sequential、Parallel、Routing、Loop 等多智能体编排模式。
  • 02基于图的工作流运行时,支持条件路由、嵌套图和状态管理。
  • 03内置上下文压缩、工具重试等上下文工程策略。
  • 04支持 DashScope、OpenAI 等多种大模型以及 MCP 协议。
  • 05集成 Nacos 实现 A2A 智能体间通信。
  • 06工作流可导出为 PlantUML 和 Mermaid 格式。

适用场景

  • 在 Spring Boot 后端服务中集成大模型驱动的智能体。
  • 通过路由或并行工作流协调多个专用智能体。
  • 构建需要持久化和流式输出的长时运行有状态智能体。
  • 借助 Admin 平台可视化地开发和调试智能体。

快速上手

  1. 1

    检查前提条件:JDK 17+ 并获取 LLM 提供商的 API 密钥

  2. 2

    克隆代码仓库

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

    设置 DashScope API 密钥

    export AI_DASHSCOPE_API_KEY=your-api-key
  4. 4

    启动 ChatBot 示例

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

使用前须知

  • 需要 JDK 17 或更高版本,以及付费或需要账号的 LLM API 密钥(例如 DashScope)。
  • 快速开始示例默认配置为 DashScope,使用其他提供商需要参考文档进行额外设置。

标签

常见问题

spring-ai-alibaba 是什么?
基于 Spring AI 的 Java 智能体框架,用于构建智能体、工作流和多智能体应用。 Spring AI Alibaba 是一个用于构建 AI 智能体、图式工作流和多智能体系统的 Java 框架。它在 Spring AI 之上提供 Agent Framework,内置上下文工程和人在回路(Human In The Loop)支持,并提供 SequentialAgent、ParallelAgent、RoutingAgent、LoopAgent 等工作流智能体。
spring-ai-alibaba 可以免费使用吗?用的什么许可证?
spring-ai-alibaba 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
spring-ai-alibaba 还在维护吗?
活跃维护中。spring-ai-alibaba 最近一次提交是在 2026年10月7日。
spring-ai-alibaba 适合用来做什么?
在 Spring Boot 后端服务中集成大模型驱动的智能体。 通过路由或并行工作流协调多个专用智能体。 构建需要持久化和流式输出的长时运行有状态智能体。 借助 Admin 平台可视化地开发和调试智能体。
spring-ai-alibaba 怎么安装和运行?
检查前提条件:JDK 17+ 并获取 LLM 提供商的 API 密钥 克隆代码仓库: git clone --depth=1 https://github.com/alibaba/spring-ai-alibaba.git 设置 DashScope API 密钥: export AI_DASHSCOPE_API_KEY=your-api-key 启动 ChatBot 示例: ./mvnw -pl examples/chatbot spring-boot:run
在哪里获取 spring-ai-alibaba?
源代码和安装说明在 GitHub 上:https://github.com/alibaba/spring-ai-alibaba

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目