Spring AI Alibaba

这是一个面向 Java 开发者的生产级 AI 应用开发框架，专注于 Agent（智能体）、工作流及多智能体（Multi-agent）应用构建。

Agent 框架文档、Graph 文档、Spring AI、示例项目。

架构

Spring AI Alibaba Admin 是一个一站式 Agent 平台，支持可视化 Agent 开发、可观测性分析、评估及 MCP 管理等功能。它还集成了 Dify 等开源低代码平台，支持将 DSL 快速迁移至 Spring AI Alibaba 项目中。

Spring AI Alibaba Agent Framework 是一个 Agent 开发框架，能够快速开发集成内置 Context Engineering（上下文工程） 和 Human In The Loop（人在回路） 支持的智能体。对于需要复杂流程控制的场景，Agent Framework 提供了内置的工作流，如 SequentialAgent、ParallelAgent、RoutingAgent 和 LoopAgent。

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

核心功能

• 多智能体编排：通过内置的 SequentialAgent、ParallelAgent、RoutingAgent 和 LoopAgent 等模式组合多个智能体，以执行复杂任务。

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

• 语音智能体：基于 WebSocket 的实时语音智能体，支持音频或文本流式输入，并返回生成的音频响应。

• 上下文工程：内置上下文工程最佳实践策略，提升智能体的可靠性和性能，包括人在回路（Human-in-the-loop）、上下文压缩、上下文编辑、模型与工具调用限制、工具重试、规划以及动态工具选择。

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

• A2A 支持：支持集成 Nacos 实现 Agent-to-Agent 通信，助力跨服务的分布式智能体协调与协作。

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

• 一站式 Agent 平台：通过可视化方式构建智能体，支持零代码部署，或导出为独立的 Java 项目。

入门指南

前置条件

• JDK 17+。
• 选择你的 LLM 服务商并获取 API-KEY。

快速运行一个 ChatBot

社区提供了一个 ChatBot 示例，位于 examples/chatbot。

1. 下载代码：

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

2. 启动 ChatBot：

   启动前，请先设置 API-KEY（访问阿里云百炼获取 API-KEY）：

   # 本示例使用 '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. 与 ChatBot 聊天：

   打开浏览器访问 http://localhost:8080/chatui/index.html 即可与 ChatBot 进行交流。

Chatbot 代码详解

1. 添加依赖：

   <dependency>
       <groupId>com.alibaba.cloud.ai</groupId>
       <artifactId>spring-ai-alibaba-agent-framework</artifactId>
       <version>1.1.2.0</version>
   </dependency>