概述官网Spring AI Alibaba是阿里云推出的面向Java开发者的开源GitHub10.7K Star2.4K ForkAI应用开发框架简称SAA基于Spring AI构建旨在简化生成式AI应用的开发。深度集成了阿里云通义系列大模型及云原生基础设施提供高层次的AI API抽象帮助开发者快速构建智能化应用。官方文档。主要特性模型交互与适配支持文本、图像、语音等多模态输入输出提供同步、异步及流式通信模式提示词模板管理通过提示词模板简化提示词的定义与动态替换结构化输出将非格式化的模型输出自动转换为JavaBean确保数据格式一致性函数调用支持Function Calling模型可调用预定义函数辅助完成任务RAG结合向量数据库实现上下文增强的模型交互多轮对话支持通过Chat Memory管理对话上下文支持连续对话核心功能ReactAgent构建具有推理和行动能力的智能代理遵循ReAct推理行动范式用于迭代解决问题多代理编排使用内置模式包括SequentialAgent1、ParallelAgent、LlmRoutingAgent和LoopAgent组合多个代理以执行复杂任务上下文工程内置快速工程、上下文管理和对话流控制的最佳实践以提高代理的可靠性和性能人机协同将人工反馈和审批步骤无缝集成到代理工作流程中从而实现关键工具和操作的监督执行流式传输支持代理响应的实时流式传输错误处理强大的错误恢复和重试机制基于图的工作流基于图的工作流运行时和API用于条件路由、嵌套图、并行执行和状态管理。可将工作流导出为PlantUML和Mermaid格式A2A支持通过Nacos集成支持代理间通信实现跨服务的分布式代理协调和协作丰富的模型、工具和MCP支持利用Spring AI的核心概念支持多种LLM提供程序DashScope、OpenAI等、工具调用和MCP原理模块从GitHub源码得知以及以下组件随SAA主仓库发布版本与BOM中的SAA版本一致组件/模块artifactId说明版本约定BOMspring-ai-alibaba-bom依赖管理统一SAA各模块版本同SAA主版本Agent Frameworkspring-ai-alibaba-agent-frameworkReactAgent、多智能体编排、Hooks、Skills等同BOMGraph Corespring-ai-alibaba-graph-core图工作流运行时、持久化、流式、MCP节点等同BOMStudiospring-ai-alibaba-studio嵌入式Agent调试与可视化UI同BOMSandboxspring-ai-alibaba-sandboxAgent沙箱运行时同BOMAdminspring-ai-alibaba-admin一站式Agent平台可视开发、可观测、MCP管理随主仓库发布Starter A2A Nacosspring-ai-alibaba-starter-a2a-nacos基于Nacos的A2A通信同BOMStarter Config Nacosspring-ai-alibaba-starter-config-nacos基于Nacos的动态配置与模型热更新同BOMStarter Graph Observationspring-ai-alibaba-starter-graph-observationGraph可观测性Micrometer/OpenTelemetry同BOMStarter Builtin Nodesspring-ai-alibaba-starter-builtin-nodes预置图节点LlmNode、AgentNode等同BOMGraph一款面向Java开发者的工作流、多智能体框架。用于构建由多个AI模型或步骤组成的复杂应用。提供声明式的API来编排工作流让开发者能将AI应用的各个步骤抽象为节点Node并通过有向图的形式连接这些节点形成可定制的执行流程。特性并行条件边、并行分支聚合策略AllOf、AnyOf批量addEdge、interruptAfter钩子HookAgentToolNode异步工具执行returnDirect增强流式节点完整输出核心概念StateGraph状态图用于定义节点和边负责定义整个工作流的结构和执行逻辑。功能addNode添加各种处理节点addEdge定义节点间的连接关系addConditionalEdges设置条件分支逻辑支持复杂的子工作流嵌套Node节点封装具体操作或模型调用Edge边表示节点间跳转关系路由类型直接路由A节点完成后直接进入B节点条件路由根据处理结果选择不同的后续节点OverAllState全局状态贯穿流程共享数据CompiledGraph已编译图高效的执行引擎使开发者能够方便地管理工作流中的状态和逻辑流转。引入依赖implementation com.alibaba.cloud.ai:spring-ai-alibaba-graph:1.0.0.3implementation com.alibaba.cloud.ai:spring-ai-alibaba-graph-core:1.0.0.4区别在于AgentReactAgent集成Agent Skills能力支持以技能为单位做可复用指令与上下文的渐进式披露在相关任务时由智能体自动发现并按需加载从而降低 token 消耗、扩展能力规模。内置完善的智能体模式最佳实践如Routing、Supervisor、Handoffs、Custom Workflow等支持并行子智能体执行新增Flow Agent统一Hooks、streamMessagesAPI、工具returnDirect、ToolContextHelper。通过SkillRegistry如FileSystemSkillRegistry或ClasspathSkillRegistry管理技能再使用SkillsAgentHook注册read_skill工具并将技能列表注入系统提示即可在ReactAgent中使用SkillRegistryregistryFileSystemSkillRegistry.builder().projectSkillsDirectory(System.getProperty(user.dir)/skills).build();SkillsAgentHookhookSkillsAgentHook.builder().skillRegistry(registry).build();ReactAgentagentReactAgent.builder().name(skills-agent).model(chatModel).saver(newMemorySaver()).hooks(List.of(hook)).build();agent.call(请介绍你有哪些技能);技能可与Python、Shell等工具配合使用ShellToolAgentHook、PythonTool等让Agent根据技能说明处理技能目录下的文件与脚本。通过groupedTools将工具与技能名绑定可实现「仅当模型对该技能调用read_skill后对应工具才加入当次请求」的渐进式工具披露。更完整的Skills用法包括ChatClient、SkillPromptAugmentAdvisor、生产环境自动重载、自定义系统提示模板等。多智能体模式在工作流智能体上增强多智能体模式能力LlmRouting、Supervisor等既可路由到单一子智能体也可一次选择多个子智能体并并行执行便于做多领域并行查询与结果汇总。无论是单智能体还是多智能体核心都在于上下文管理。多智能体在以下方面能带来明显收益上下文管理 通过专职子智能体缩小单次上下文、降低延迟与Token消耗子智能体拥有隔离的上下文空间。子智能体并行执行路由或主管模型可一次选出多个子智能体并行执行后再做聚合。适合引入多智能体的典型场景单个Agent工具过多、部分任务需要专属知识/提示词或工具、需要按条件开启某子智能体能力等。常见模式概览模式核心特点典型场景Supervisor主管主智能体协调子智能体Agent As Tool路由决策集中子智能体无状态、可并行上下文隔离问题涉及多领域如邮件、数据库集中式工作流需并行多任务Handoffs交接通过状态变量如current_step动态切换Agent多轮间状态持久化每步可直接响应用户多步骤对话、客服先收集保修再退款等Skills技能能力以「技能」形式按需披露Prompt驱动、轻量适合单智能体扩展多能力单智能体需多种技能、团队分技能开发维护Routing路由按领域拆解问题并分派可单路或并行多子Agent需汇总结果多领域问答、并行查多领域知识并综合Sequential/Parallel/Loop管道如Sequential模式是指前一节点输出即下一节点输入可任意组合多种模式固定流程、RAG管道等CustomWorkflow自定义图结构顺序、分支、循环、并行可混合确定性逻辑与智能体节点以上模式不满足时的完全自编排Supervisor与LlmRouting已支持「一次选择多个子智能体并并行执行」配合Graph的并行条件边与聚合策略AllOf、AnyOf可以更自然地实现多路并行与结果汇总。实战通过BOM统一版本避免与Spring AI、Spring Boot冲突dependencyManagementdependenciesdependencygroupIdcom.alibaba.cloud.ai/groupIdartifactIdspring-ai-alibaba-bom/artifactIdversion1.1.2.0/versiontypepom/typescopeimport/scope/dependencydependencygroupIdorg.springframework.ai/groupIdartifactIdspring-ai-bom/artifactIdversion1.1.2/versiontypepom/typescopeimport/scope/dependencydependencygroupIdcom.alibaba.cloud.ai/groupIdartifactIdspring-ai-alibaba-extensions-bom/artifactIdversion1.1.2.1/versiontypepom/typescopeimport/scope/dependency/dependencies/dependencyManagementdependenciesdependencygroupIdcom.alibaba.cloud.ai/groupIdartifactIdspring-ai-alibaba-agent-framework/artifactId/dependencydependencygroupIdcom.alibaba.cloud.ai/groupIdartifactIdspring-ai-alibaba-starter-dashscope/artifactId/dependency/dependencies引入核心依赖implementation com.alibaba.cloud.ai:spring-ai-alibaba-starter-dashscope:1.0.0.4application.properties配置文件添加spring.ai.dashscope.api-keyxxx拓展官方基于SAA的开源应用。JManusGitHubDataAgentGitHubDeepResearchGitHubCopilotGitHubhttps://www.anthropic.com/engineering/building-effective-agents几种工作流模式链式工作流将复杂任务分解为有序的处理步骤路由工作流根据输入类型智能分发到专业处理节点并行化工作流多个AI节点同时处理提高效率编排者-工作者模式动态任务分解和协作处理评估者-优化者模式迭代优化追求完美输出