00 · 如何使用本教程（ADHD 版）

⏱ 20 分钟 ｜ 🎁 可以跳过，但读了能省后面几十小时

🎯 一句话

这一节不讲 Agent，讲怎么让你真的学完它。如果你已经读过《推荐算法》教程的第 00 节，规则一样，扫一眼下面的「本教程特有的三件事」就够了。

🧠 这套教程和普通教程的区别

普通 AI 教程的三个坑，这里都做了针对性处理：

🔧 标记系统（和其他教程一致）

⭐ 「走神救援」是这套教程里最该用的功能： 它是整章浓缩成的一段话，30 秒就能把上下文接回来。

❌ 错误的做法：三天后回来，从第 1 节重新读 ✅ 正确的做法：读上一节的走神救援，直接进下一节

📌 本教程特有的三件事

1. 它和站内其他教程的分工

   《机器学习与深度学习基础》 → 模型内部在算什么
   《机器学习的数学原理》     → 凭什么这么做
   《大模型全景导论》         → 这个领域有哪些方向
   ────────────────────────────────────────────
   《智能体工程教程》 ← 你在这里
     怎么【用】模型搭出能干活的系统
   ────────────────────────────────────────────
   《推荐算法》 / 《Kaggle 方法论》 → 两个纵深领域

⭐ 一个重要的定位：这套教程是"应用层"，不需要你懂模型内部。 你完全可以在不知道什么是注意力机制的情况下学完它并做出东西。 （好奇的话再去看全景导论第 2 章。）

2. 你需要一点 Python，但只要一点

会 def、dict、for 就够。比推荐算法教程的要求还低—— 这个领域的代码大都是「把字符串发给 API，处理返回的字符串」。

# 这个复杂度就是全教程的天花板了
def call_model(messages, tools=None):
    resp = client.messages.create(model=MODEL, messages=messages, tools=tools)
    return resp

💡 没有 API Key 也能学：第 1 节的代码用一个「假模型」就能跑通全部机制。 零成本，而且假模型反而让你看得更清楚——因为你能控制它返回什么。

3. 时效性警告 ⚠️

Agent 领域比推荐系统变得还快。方法论比参数持久：

每章尽量只教前者。看到具体数字时，记住它是「量级感」不是「当前值」。

⏲️ 学习节奏（ADHD 版四规则）

① 10 分钟番茄起步

番茄钟是用来启动的，不是用来打断的。 进入状态就别停。 ADHD 大脑最难的是「开始」，不是「持续」——所以门槛要设得极低。

② 一天最多两节，看完起来走一圈

连着塞四节的真实结果是后两节完全没进脑子，而且第二天不想打开了。

③ 卡住就记欠账

看不懂的记下来继续走，超过 5 条再回头补。 这个领域前面的洞后面会自动补上——很多"第 3 节没懂的东西"，第 7 节自然就通了。

欠账本（在这写）：
1.
2.
3.

④ 每节做完那个 🔨 动手环节 ⭐

这是四条里最重要的一条。

   ❌ "我看懂了这个循环怎么工作"
   ✅ "我跑了一遍，看到它在第 3 轮调了 search 工具"

   ⭐ 判断标准：如果你说得出结论却说不出"我跑出来是什么"，
      那一节其实没学

💡 对 ADHD 特别有效的一点：跑代码有即时反馈。 读三页文字得不到任何多巴胺，跑一段代码看到输出就有—— 把学习拆成一段段"能立刻看到结果"的动作，比靠意志力有用得多。

🚫 本领域特有的陷阱

🔑 最后一条值得展开：很多人被"多 Agent 协作"的概念吸引， 但绝大多数任务用一个 Agent + 好的工具设计就能做。 过早引入多 Agent，你会同时面对"单 Agent 还没做好"和"协作出问题"两个难题。

🗺️ 全教程结构

  【阶段1】跑起来      01-02    ← 10 分钟造出第一个 Agent
  【阶段2】三大基本功  03-05    ← 提示词 / 上下文 / 04b 记忆 / Claude Code 实操
  【阶段3】能力扩展    06-11    ← 工作流决策 / 工具 / MCP / GUI 操作 / Skills / RAG
  【阶段4】规模化      12-14    ← Harness / 多 Agent / 评测
  【阶段5】上生产      15-16c   ← 安全 / 企业落地（循环工程在这一章里）
                                / 16b 框架这层皮 / 16c 接进真实产品
  【阶段6】动手        17       ← 三个实战项目，挑一个做
  【阶段7】终极挑战    18-20    ← 手搓框架 / 评测驱动 / 提示注入攻防
  【随时查】           附录A 术语 / 附录B 上线清单

两节是全教程的核心，别跳：

📌 04b · Agent 记忆 是第 4 节的续集，用不用取决于你要做什么： 做一次性任务（一轮问答、一次代码修改）——可以先跳过，第 4 节的上下文工程够用了。 做跨会话的东西（助理、客服、长期陪伴你的编码 Agent）——⭐ 别跳，而且要在做第 11 节 RAG 之前先看。 原因很实际：RAG 和 Memory 的检索那一半是同一套，写入那一半完全不同， ⚠️ 先学了 RAG 的人极容易把 Memory 当成「RAG 换个名字」直接开做， 然后在「该记什么」「新旧冲突谁赢」「怎么忘」这三件事上全部返工。

📌 阶段 5 末尾那两章最容易被忽略，但它们是全教程最长的两章（合计 134 分钟）， 而且要不要读取决于你打算走到哪一步： 16b · 框架这层皮（54 分钟）一行 API 都不写， 它做的是把 LangGraph / CrewAI 这些你上班第一周就会撞见的名字，一个一个对回前面讲过的机制—— 只想自己搭东西可以先跳，要进团队接别人的代码就别跳。 ⭐ 16c · 接进真实产品（80 分钟）反过来：用不用框架都躲不掉。 结构化输出、流式输出、护栏这三件事没有任何框架能替你做完， 只要你打算把 Demo 交给真实用户，它就是必读的那一章。

✅ 检查点

1. 📚 和 ⚡ 两个标记分别是什么意思？
2. 走神回来该看哪个区块？错误的做法是什么？
3. 这套教程需要你懂模型内部原理吗？
4. 没有 API Key 能不能学？为什么"假模型"反而看得更清楚？
5. 学习节奏四规则里最重要的是哪一条？判断"学没学会"的标准是什么？
6. 为什么"一上来就做多 Agent"是陷阱？
7. 哪两节是全教程核心？

🛑 到这就够了

⚡ 走神救援

这节讲怎么真的学完。标记系统里最该用的是 ⚡走神救援——中断后读它 30 秒接回上下文，别从头重读（那是放弃整套教程最常见的原因）。定位：这是应用层教程，不需要懂模型内部；Python 只要会 def/dict/for；没有 API Key 也能学（第1节用"假模型"，而且假模型更清楚因为你能控制它返回什么）。时效性：方法论比参数持久，具体数字只当量级感。四规则：10分钟番茄起步(门槛设极低，ADHD最难的是开始不是持续)、一天最多两节、卡住记欠账(超5条再回头)、⭐每节做完动手环节——说得出结论却说不出"我跑出来是什么"就等于没学；跑代码有即时反馈，比靠意志力有用。五陷阱：先学框架(框架把机制藏起来了)、收集Prompt模板、没Key不开始、追新闻(多巴胺陷阱)、一上来做多Agent(复杂度指数级，会同时面对两个难题)。两个核心节：04上下文工程(理解后面一切的钥匙)、14评测(不会评测所有改进都是感觉)。全教程七个阶段：01-02跑起来／03-05基本功／06-11能力扩展／12-14规模化／15-16c上生产／17实战／18-20挑战。⚠️阶段5末尾那两章最长也最容易漏（共134分钟）：16b框架这层皮(54分钟，一行API都不写，只把框架的名字对回已学的机制——进团队接别人代码就别跳)、⭐16c接进真实产品(80分钟，结构化输出/流式/护栏，用不用框架都躲不掉，要把Demo交给真实用户就必读)。

现在做一件事：设 10 分钟闹钟，打开 👉 01-第一天-10分钟造出你的第一个Agent.md