03 篇导览：Agent 与编排

这一篇解决一个问题：让 AI 不只是「回答问题」，而是「完成一件事」——并且能稳定地、可控地完成。

学完你能做什么

设计并实现一个生产可用的 Agent：它会自己规划步骤、调用工具、观察结果、修正计划；它不会跑飞（有超时和迭代上限）、不会死循环、不会越权（工具分级 + 审批）、做过的每一步都可审计。

前置要求

项	要求
已完成	01 篇 全部，02 篇 至少 02A
环境	Java 21 + Spring Boot 4.x + Spring AI 2.0.x、Docker
知识	理解 Tool 调用（01-07）、Advisor 机制（01-12）

三子篇地图

子篇	章节	解决什么	验收标准
03A 单 Agent	01-06	一个 Agent 怎么跑起来	能完成一个多步任务
03B 可靠性	07-13	怎么让它不跑飞	超时/循环/越权全部有防护
03C 实战	14-18	三个端到端案例 + 评测	可交付的 Agent 应用

为什么 03B 是本篇的核心

市面上讲 Agent 的课，绝大多数只讲 03A（怎么让模型调工具）。但企业愿意付钱的是 03B。

原因很直白：让模型调一次工具，二十行代码就能做出来，任何人看文档半小时就会。而下面这些问题，没有做过生产的人根本想不到：

问题	后果
Agent 死循环	一夜烧掉几万元
工具无权限分级	Agent 删了生产数据
没有审计	出事无法追溯是谁让 AI 做的
单点超时缺失	一次卡死拖垮整个线程池

03B 的七章，每一章对应一类真实事故。 这是本课程差异化的部分。

阅读路径建议

你的角色	建议
想快速上手	03-01 → 03-03 → 03-07 → 03-13
要交付企业项目	全篇顺序读，03B 一章都不能跳
已有 Agent 但不敢上生产	直接读 03B（07-13）

一条贯穿全篇的判断：Agent 的核心价值不在「能调工具」，而在「跑飞了能停下来」。框架给你的是循环，可靠性是你自己加的。

对应 Demo

agent-spring-harness（纯 Spring AI 2.0 实现）+ agent-scope-lab（AgentScope 对照）。每章一个 git tag，命名 ch03-XX-xxx。