Appearance
L03-02 框架选型：什么时候用 Spring AI，什么时候上 AgentScope
全局中心内容：选型看的是「你要控制多少」，不是「哪个框架更火」。 全局讲解主线：两个极端 → 决策维度 → 三档建议 → 抽象层设计 → 切换演示 → 常见误判。
P1 · 产出页
中心内容：一个 AgentRunner 抽象 + 两套可切换实现。
- 讲解技巧
- 开场提问：「Agent 框架几十个，选哪个？」——然后说这个问题问错了，应该问「我需要多少控制力」。
- 时长：20s
P2 · 两个极端
中心内容：全手写（完全可控但重复造轮子）vs 全框架（快但被绑定）。
- 讲解技巧
- 客观讲框架的价值：编排、持久化、可观测这些确实值得复用。
- 也讲代价：框架抽象泄漏时，你要花的时间比自己写还多。
- 时长：4min
P3 · 决策维度
中心内容：团队栈 / 复杂度 / 可控性要求 / 多语言需求 / 运维能力。
页面内容：五维决策表
讲解技巧
- 把「团队栈」放第一位讲：Java 团队用 Python Agent 框架，运维和排障成本会翻倍。
- 强调多语言需求这个硬约束：要接 Python 生态的工具，纯 Java 框架会很痛苦。
时长：6min
P4 · 三档建议
中心内容：简单场景 Spring AI 手写；复杂编排上专业框架；混合场景做抽象层。
页面内容：三档的判据与典型场景
讲解技巧
- 给出明确判据：工具少于 8 个、流程线性 → Spring AI 就够。
- 明确说出什么时候该换：需要多 Agent 协作、需要复杂状态恢复时才值得上框架。
时长：5min
P5 · 抽象层设计
中心内容：定义自己的 AgentRunner 接口，框架只是实现之一。
页面内容：接口定义 + 两套实现 + @ConditionalOnProperty 切换
讲解技巧
- 这是本节的核心工程建议：花半天定义接口，能换来将来换框架不改业务代码。
- 提醒接口不要太厚，只暴露 run() 和必要的回调，否则换实现时照样要重写。
时长：7min
P6 · 切换演示
中心内容：改一个配置，从 Spring AI 实现切到框架实现。
- 讲解技巧
- 现场演示最有说服力：同一份业务代码，两个实现跑出一样的结论。
- 时长：4min
P7 · 常见误判
中心内容：为「将来可能要」提前上重框架；因为 demo 好看选框架。
- 讲解技巧
- 逐条讲危害，尤其是 demo 陷阱：框架的示例跑得漂亮，不代表你的场景跑得动。
- 时长：4min
P8 · 避坑与小结
中心内容：选型错了可以换，前提是你做了抽象层。
- 讲解技巧
- 引出下一节：不管用什么框架，工具设计是共同的——03-03。
- 时长：2min
讲师备忘
| 项 | 内容 |
|---|---|
| 课前必做 | 准备五维决策表；准备两套实现的切换配置 |
| 最容易超时处 | P3 决策表，容易变成框架点评——保持中立 |
| 学员最常问 | 「Spring AI 够不够做 Agent？」答：单 Agent 线性流程完全够 |
| 现场备用 | 无法演示第二套实现 → 展示接口与配置代码 |