Spring AI Alibaba 源码教程

这是一套面向 Spring Boot 程序员的 Spring AI Alibaba 源码教程。源码和官网是这套教程的“食材”，但端到你面前的应该是一桌能吃懂的菜：先讲清楚心智模型、工程套路和最小例子，再把源码锚点放到课后索引里。

你不需要一边开着 IDE 一边读正文。正文默认按“没打开源码也能听懂”的方式写；如果你想验证某个结论，再打开每章末尾的源码索引。

这套教程怎么读

每章都按三层来组织：

层次	你会得到什么	是否需要看源码
人话模型	用生活类比和 Spring Boot 经验理解概念	不需要
最小例子	看到一个能跑、能改、能扩展的小场景	不需要
课后源码索引	给出类名、方法名、路径，方便验证和深挖	想研究实现时再看

本专题不会把文件清单当正文主角。源码索引只是课后路标，真正要学会的是：这个抽象解决什么问题、运行时数据怎么流、放到工程里该怎么取舍。

当前章节

学习主线

贯穿案例

后续阅读时，可以把整套教程想成同一个案例在慢慢长大：智能客服邮件处理助手。

阶段	对应章节	案例能力
会回答	第 2 章	能解释用户邮件大概在问什么
会查资料	第 3 章	调用知识库、工单系统、天气或库存这类外部工具
会记上下文	第 4 章	同一个 `threadId` 下记住客户前后问题
会给结构	第 5 章	输出 `intent`、`urgency`、`topic`、`summary`
会守规则	第 6 章	敏感操作前 Hook 审核，工具失败时 Interceptor 重试
会跑流程	第 7/8 章	邮件分类、检索、草拟回复、人工审核、继续执行
会分工	第 9/10 章	售前、售后、技术支持多个 Agent 协作或路由
会工程化	第 11/12 章	Studio 调试、日志观测、A2A/Nacos 接入、复杂场景扩展

这条线的作用是防止教程变成散装零件：每章新增一个能力，但都回到同一个工程故事里。你读到后面时，应该感觉像在给同一个助手逐步升级，而不是在参观一排互不认识的类。

三张总图

第一张图看分层：你知道每个模块站在哪一层。

第二张图看 state 怎么流：你知道 input、messages、outputKey、OverAllState 不是孤立概念。

第三张图看生产调用链：你知道 Controller/Service、异常、日志、配置、观测应该接在哪里。

阅读建议

如果你已经有 Spring Boot 经验，可以直接从第 1 章开始。第一章会先跑官方 examples/chatbot，然后顺着 ChatbotApplication、ChatbotAgent、ReactAgent、Agent、AgentLlmNode、AgentToolNode 这条链路，把框架主线搭起来。

读源码最怕“看见树叶，忘了森林”。这套教程会尽量把树叶扎成一束花，再告诉你花枝从哪里来的。

Spring AI Alibaba 源码教程 ​

这套教程怎么读 ​

当前章节 ​

学习主线 ​

贯穿案例 ​

三张总图 ​

阅读建议 ​