Spring AI Alibaba 源码学习
从 Graph 定义、执行与存储，到 Agent 编排、远程协作及扩展机制，按 11 讲阅读 Spring AI Alibaba 源码资料，以 Tool 工具系统收尾。
11 篇文章
整理于 2026-11-08
按章节顺序阅读
章节目录
Graph：定义、执行与存储
4 篇- 项目结构与模块分工从模块目录和依赖关系入手，认识 Graph 核心、Agent Framework、Studio 与 Starter 的分工。
- Graph 定义与核心抽象围绕 StateGraph、CompiledGraph、Node、Edge 和 OverAllState，梳理工作流的定义与编译。
- Graph 执行流程与状态管理沿 GraphRunner 的调用链阅读节点执行、状态合并、Checkpoint 和中断恢复。
- Store 存储体系阅读 Store 接口、命名空间、键编码和搜索逻辑，区分长期存储与 Checkpoint。
Agent：组织、编排与扩展
7 篇- Agent Framework 工作原理与使用从 Graph Runtime 转向 Agent Framework，了解 ReAct、编排方式及 Hook、Interceptor 和 Tool 的用法。
- Agent、BaseAgent 与 ReactAgent逐层阅读 Agent 的图管理、BaseAgent 的输入输出，以及 ReactAgent 的模型与工具循环。
- Flow Agent 与多智能体编排对照顺序、并行、循环和路由四种模式，理解子 Agent 如何组成工作流。
- A2aRemoteAgent 与远程协作梳理 AgentCard、远程调用节点、流式调用及共享或隔离状态的处理。
- Interceptor 拦截机制理解模型与工具拦截器的包装顺序，以及重试、降级和上下文编辑的设计。
- Hook 生命周期扩展沿 HookPosition 和跳转机制，阅读模型调用限制、人工干预与工具注入。
- Tool 工具系统与调用流程（完结篇）从 ToolCallback 和 AgentTool 出发，阅读工具注册、模型与工具节点协作、拦截器链及状态更新。
阅读前准备与来源说明
这套课程面向已有 Java 与 Spring 基础、希望阅读 AI 应用框架源码的开发者。先读 Graph 的定义、执行和存储，再进入 Agent Framework，最后阅读编排、远程协作和扩展机制。
阅读前准备
能阅读 Java 接口、继承、泛型和 Builder 调用，了解 Maven 依赖与 Reactor 的基本概念。若还不熟悉模型调用，可先阅读 Spring AI ChatClient 入门。
课程以源码节选和结构分析为主。原材料含 1.1.0.0-M4 版本线索，但没有完整的提交记录；使用代码前需要结合自己的依赖版本核对 API。节选与示例尚未编译或运行验证。
来源与整理说明
原始来源与发布日期待补充。材料中出现“阿呆-bot”的署名线索，尚未核实首发作者。本站对材料做了排版、文字整理与阅读顺序调整，保留技术节选和配图；原文关注公众号等引流语已清理。
本站将已收集材料按学习顺序编为 11 讲。原材料第五篇缺失，原第六至十二篇依次编为本站第五至十一讲，Tool 篇作为已收集资料的完结篇；原编号对应关系保留在整理记录中。第四讲与第五讲分别讲 Graph 存储和 Agent Framework，后者重新介绍架构与执行入口，可以承接阅读。