架构
Spring AI Alibaba 项目从架构上包含如下三层:
- Agent Framework,是一个以 ReactAgent 设计理念为核心的 Agent 开发框架,使开发者能够构建具备自动上下文工程和人机交互等核心能力的Agent。
- Graph,graph 是一个低级别的工作流和多代理协调框架,能够帮助开发者实现复杂的应用程序编排,它具备丰富的预置节点和简化的图状态定义,Graph 是 Agent Framework 的底层运行时基座。
- Augmented LLM,以 Spring AI 框架底层原子抽象为基础,为构建大型语言模型(LLM)应用提供基础抽象,例如模型(Model)、工具(Tool)、多模态组件(MCP)、消息(Message)、向量存储(Vector Store)等。

依赖引入
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-agent-framework</artifactId>
<version>1.1.0.0-M5</version>
</dependency>
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
<version>1.1.0.0-M5</version>
</dependency>
核心功能
ReactAgent:构建具有推理和行动能力的智能代理,遵循 ReAct(推理 + 行动)范式,用于迭代解决问题。
多代理编排:使用内置模式(包括 SequentialAgent1、ParallelAgent、LlmRoutingAgent和LoopAgent`)组合多个代理,以执行复杂的任务。
上下文工程:内置快速工程、上下文管理和对话流控制的最佳实践,以提高代理的可靠性和性能。
人机协同:将人工反馈和审批步骤无缝集成到代理工作流程中,从而实现关键工具和操作的监督执行。
流式传输支持:代理响应的实时流式传输
错误处理:强大的错误恢复和重试机制
基于图的工作流:基于图的工作流运行时和 API,用于条件路由、嵌套图、并行执行和状态管理。可将工作流导出为 PlantUML 和 Mermaid 格式。
A2A 支持:通过 Nacos 集成支持代理间通信,实现跨服务的分布式代理协调和协作。
丰富的模型、工具和 MCP 支持:利用 Spring AI 的核心概念,支持多种 LLM 提供程序(DashScope、OpenAI 等)、工具调用和模型上下文协议 (MCP)。