Appearance
官方资料索引：一手来源清单
1. 本节产出
拿到一份经过可达性核验的一手资料清单，知道每一份配套哪一章、值得读的理由是什么，以及哪些常见说法其实是错的。
2. 前置依赖
- 00-01 学习地图：确定自己的路径后，只挑对应资料看
3. 为什么需要这份清单
AI 领域二手内容泛滥，存在三个具体问题：
| 问题 | 后果 |
|---|---|
| 教程写的是旧版本 API | 照抄跑不起来，浪费几小时 |
| 公众号解读夹带私货 | 学到的是别人的理解偏差 |
| 不知道哪些是「源头」 | 一旦出现新概念，没有任何框架可以判断对错 |
这份清单只收一手来源：官方文档、原作者、标准组织、原始论文。
提示：不要顺着这份清单从第一份读到最后一份。每篇课程章节里都标了配套资料，学到哪里读哪里。
4. 核心内容：五类资料与用途
| 类别 | 什么时候用 | 代表资料 |
|---|---|---|
| A Java/Spring 官方 | 写到任何代码之前先确认 API 现状 | Spring AI Reference |
| B Agent 工程实践 | 设计 Agent 架构时 | Anthropic Building effective agents |
| C Prompt/上下文 | 优化输入输出质量时 | Google Prompt Engineering |
| D 安全合规 | 给老板汇报、做方案评审时 | OWASP GenAI LLM Top 10 |
| E 奠基论文 | 需要论证「为什么这么设计」时 | RAG、ReAct、Lost in the Middle |
5. 操作步骤：清单怎么用
5.1 写代码前
先看 Spring AI Reference（https://docs.spring.io/spring-ai/reference/），确认你用的那个版本的类名与方法签名。Spring AI 在 1.x 与 2.x 之间有 starter 命名与部分 API 变更，网上老教程不通用。
配套的文件和标准：
| 资料 | 链接 |
|---|---|
| Spring AI API 文档 | https://docs.spring.io/spring-ai/reference/api/chatclient.html |
| Spring AI 源码（看 release note 的 breaking change） | https://github.com/spring-projects/spring-ai |
| Spring Boot 文档（决定能配哪个 AI 版本） | https://docs.spring.io/spring-boot/documentation.html |
| MCP 协议规范 | https://modelcontextprotocol.io/specification/latest |
| Micrometer（理解内置埋点机制） | https://micrometer.io/docs |
5.2 设计 Agent 时
这几份是 03 篇的理论基座，按推荐顺序读：
| 顺序 | 资料 | 链接 | 配套章节 |
|---|---|---|---|
| 1 | Building effective agents（Anthropic） | https://www.anthropic.com/research/building-effective-agents/ | 03A：workflow 与 agent 的边界 |
| 2 | Agent Harness Design（Anthropic） | https://claude.com/blog/harnessing-claudes-intelligence | 03B：harness 的定义就是这里来的 |
| 3 | Google Agents 白皮书 | https://www.kaggle.com/whitepaper-agents | 03A：模型+工具+编排+运行时 |
| 4 | Agents Companion | https://www.kaggle.com/whitepaper-agent-companion | 03B 评测与 AgentOps |
| 5 | Introduction to Agents | https://www.kaggle.com/whitepaper-introduction-to-agents | 03A：Level 0-4 分层 |
| 6 | 多 Agent 研究系统复盘 | https://www.anthropic.com/engineering/multi-agent-research-system | 03C：真实成本与失败归因 |
| 7 | A Practical Guide to Building Agents（OpenAI PDF） | https://cdn.openai.com/business-guides-and-resources/a-practical-guide-to-building-agents.pdf | 03A |
| 8 | Agentic AI Patterns on AWS（PDF） | https://docs.aws.amazon.com/pdfs/prescriptive-guidance/latest/agentic-ai-patterns/agentic-ai-patterns.pdf | 04：部署拓扑 |
5.3 讲冤枉安防—合规评审时
OWASP GenAI LLM Top 10 2026：https://genai.owasp.org/llm-top-10/ 下载页：https://genai.owasp.org/resource/owasp-genai-llm-top-10-2026/
用法：把这十条当风险清单，逐条映射到课程章节（例如「过度自主 Excessive Agency」→ 03B 工具权限沙箱；「无限消耗 Unbounded Consumption」→ 03B 超时与迭代上限）。这样你的方案就不是「我觉得应该做熔断」，而是「业界标准第 X 条要求」。
5.4 需要论证设计时（取一个结论即可，别通读论文）
| 论文 | 链接 | 可取的结论 |
|---|---|---|
| RAG（原始论文） | https://arxiv.org/abs/2005.11401 | 检索增强的基本框架 |
| ReAct | https://arxiv.org/abs/2210.03629 | 思考-行动-观察循环 |
| Chain-of-Thought | https://arxiv.org/abs/2201.11903 | 推理链为何有效 |
| Lost in the Middle | https://arxiv.org/abs/2307.03172 | 中间位置内容易被忽略 → 论证为什么要 Rerank |
| Self-RAG | https://arxiv.org/abs/2310.11511 | 按需检索与自我评估 |
| Toolformer | https://arxiv.org/abs/2302.04761 | 模型自学会调用工具 |
| CodeAct（Apple ML） | https://machinelearning.apple.com/research/codeact | 让 Agent 写代码而非僵硬 JSON |
5.5 优化提示词与上下文时
| 资料 | 链接 |
|---|---|
| Prompt Engineering（Google） | https://www.kaggle.com/whitepaper-prompt-engineering |
| Foundational LLM & Text Generation | https://www.kaggle.com/whitepaper-foundational-llm-and-text-generation |
| Agent Quality（评测） | https://www.kaggle.com/whitepaper-agent-quality |
| From Prototype to Production | https://www.kaggle.com/whitepaper-prototype-to-production |
| 白皮书合集（含 embeddings/vector stores） | https://www.kaggle.com/datasets/toddgardiner/google-genai-intensive-april-2025 |
6. 验证清单：常见误解对照
如果你对下面这些说法深信不疑，说明该补原文了：
- [ ] 「Agent 一定比 workflow 高级」→ 错。Anthropic 明确建议能用简单方案就不要上 Agent
- [ ] 「上下文越长越好」→ 错。存在位置效应（Lost in the Middle 的 U 型曲线）
- [ ] 「多 Agent 一定更强」→ 不一定。成本可能是单 Agent 的数倍，错误会累积
- [ ] 「框架越厚越省事」→ 上生产时应当减少抽象层
- [ ] 「Harness 应该包办一切」→ 模型能力变强后，harness 的假设会过期，需要周期性减负
7. 生产避坑
- 不要囤资料。清单半年会失效一半，正确的做法是「学到哪读到哪」，读完就用。
- 不要转发二手解读当作结论给别人。尤其是各类 Prompt「咒语」技巧，你自己跑一遍验证的成本很低，不验证却可能把错误结论传递出去。正确做法：查原文 → 自己跑一遍 → 再说结论。
- 不要直接批量下载第三方 PDF 打包发给付费学员。多数白皮书允许个人下载，但商业再分发需要确认许可。正确做法是给链接 + 写你自己的中文导读。
8. 延伸与锚点
- 讲师版完整清单（含各章节备课提示）：资源清单-官方经典资料收录
- 核验约定：本页链接每季度复检一次，失效链接会标注「已失效」并给替代源。
- 下一章：99-02 速查表（待编写）