Spring AI Alibaba 智能 Agent 开发实战
项目概述
Spring AI Alibaba 是一个生产就绪的框架,专为构建 Agentic、Workflow 和多 Agent 应用设计。它基于 ReactAgent 设计理念,让开发者能轻松构建具备自动上下文工程和人机交互能力的智能体。
核心特性包括:
- ReactAgent: 基于 ReAct(推理 + 行动)范式,支持推理和行动闭环。
- 多 Agent 编排: 内置
SequentialAgent、ParallelAgent、LlmRoutingAgent等模式。 - 上下文工程: 提供人在回路、上下文压缩、动态工具选择等最佳实践。
- Graph 工作流: 支持条件路由、嵌套图、并行执行,可导出为 PlantUML 或 Mermaid。
- A2A 支持: 集成 Nacos,实现分布式 Agent 间的通信与协作。
技术栈要求
- JDK: 17+
- Spring Boot: 3.4.8+
- Spring AI: 1.1.0-M4+
- Maven/Gradle: 3.6+ / 7.0+
核心架构
框架采用分层设计,从上至下依次为 Agent Framework、Graph Core 和 Spring AI 基础层。
- Agent Framework: 高级抽象层,封装 ReactAgent、FlowAgent 等逻辑。
- Graph Core: 底层运行时,处理 StateGraph、Node、Edge 的状态流转。
- Spring AI: 基础抽象层,统一 ChatModel、Tool、Message 接口。
这种分层使得上层业务逻辑可以灵活复用底层的图计算能力,同时保持对 LLM 调用的解耦。
快速开始
环境准备
首先确保拥有 API Key。阿里云百炼控制台或 OpenAI Platform 均可获取。本地需安装 JDK 17+ 并验证版本:
java -version
创建项目
推荐使用 Spring Initializr 初始化项目,或在现有项目中引入依赖。这里以 Maven 为例,在 pom.xml 中配置 BOM 管理版本:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-bom</artifactId>
<version>1.1.0.0-M5
pom
import
com.alibaba.cloud.ai
spring-ai-alibaba-agent-framework
com.alibaba.cloud.ai
spring-ai-alibaba-starter-dashscope
1.1.0.0-M5
org.springframework.boot
spring-boot-starter-web

