AI Agent 教程 · 卷 0 · 学习地图
导读
本合集目录
本章目录
本卷目标:看懂全景、装好环境、跑通第一个 Agent、选对自己的下一步。 读完这一卷,你不需要读其他任何一卷,就已经拥有一个能工作的 Agent 和一个可继续扩展的环境。
本文件是卷 0 的导航页:说明这一卷包含什么、文件怎么组织、从哪开始。正式内容在 6 个分册里,每个分册都可以单独打开阅读。

一、本卷信息
| 项 | 内容 |
|---|---|
| 卷号 / 卷名 | 卷 0 · 学习地图(入口卷) |
| 章数 | 6 章(原规划 3 章;为达成"卷内闭环"把"跑通"扩成了完整的第 4、5 章) |
| 组织方式 | 一章一个文件,每章自带前置说明、正文、验收,可单独分发或单独阅读 |
| 主题范围 | ① 建立 Agent 的全景认知框架 ② 把运行环境从零装到可用 ③ 亲手跑通一个能动手的 Agent ④ 判断自己该走哪条学习路径 |
| 不涉及 | 不做原理深挖(模型怎么训练、注意力怎么算)、不讲具体框架用法、不做工程化治理 —— 这些分别是卷 1、卷 3、卷 6 的事 |
| 目标读者 | ① 零基础、不写代码但想用 Agent 干活的人 ② 会一点 Python、想真做出来的学生与科研人员 ③ 要给团队/学生做培训、自己必须先摸清全貌的人 |
| 前置条件 | 会基本电脑操作(装软件、找文件、打开终端)。不要求会编程,第 5 章的代码可以直接运行,看注释也能读懂 |
| 产出物 | 一个可用的环境 · 三条打通的链路 · 一个能跑能收手的 Agent · 一份属于你自己的学习路径 |
| 验收口径 | 不看"学完了没有",只看能不能正确使用(清单见第 6 章) |
| 卷内自洽 | 本卷自成一个完整单元:所有出现的概念都在本卷内解释到"够用",不依赖术语表或其他卷 |
二、六章目录
| 章 | 文件 | 这一章给你什么 | 产出 |
|---|---|---|---|
| 1 | 卷0-01-这一卷要解决什么.md | 范围、读者画像、阅读线、本卷验收标准 | 一份自己的路径选择 |
| 2 | 卷0-02-全景地图-七层模型.md | 一张能用来"定位故障"的图 | 知道自己卡在第几层 |
| 3 | 卷0-03-环境准备-机器与终端.md | 路线选择、系统、终端、路径坑、密钥、目录、代理 | 一个干净的实验目录 |
| 4 | 卷0-04-环境准备-三条链路.md | 网页 / 客户端 / API 三条链路 + 错误码诊断 | 三条链路全通 |
| 5 | 卷0-05-第一个Agent.md | 一个 200 行、能跑、有安全边界、有终止条件的 Agent | 一个能干活的东西 |
| 6 | 卷0-06-收口-自检与分叉.md | 12 项验收、三个自测、路径分叉、速查卡 | 下一步的方向 |
章与章的依赖是线性的:第 2 章不装环境也能读,但第 4 章必须做完第 3 章,第 5 章必须做完第 4 章。不要跳——跳过第 4 章直接跑第 5 章的代码,报错信息会让你以为是代码问题,其实是环境问题。
三、读完应该拿到什么
四样东西,每一样都有明确的判定证据,不靠"我感觉我会了"。

四、开始之前
三件事先确认,缺一件都会在后面的章节里反复卡:
| 项 | 要求 | 详见 |
|---|---|---|
| 电脑 | 能上网;Windows 10/11、macOS 12+ 或主流 Linux;8GB 内存起 | 第 3 章 3.2 |
| 模型服务账号 | 至少一个,能拿到 API Key(也可以先用客户端,稍后再配) | 第 3 章 3.3 |
| 终端 | 会打开、会 cd、会看自己在哪个目录 |
第 3 章 3.4 |
不需要:不需要服务器、不需要域名、不需要会 Docker、不需要先学机器学习。
五、阅读约定
本卷 6 个文件共用一套约定,跨文件阅读时不必重新适应:
- 编号沿用不分册:小节号
5.3指第 5 章第 3 节,无论你在哪个文件里看到它,位置都不变。跨章引用写成"见 5.3 节"。 - 图放在用它的地方:每张图都在正文里被引用,图注说明"这张图回答什么问题",不是装饰。
- 代码全部可直接运行:
code/下三个脚本零第三方依赖(只用 Python 标准库),不需要pip install任何东西。命令给 Windows 与 macOS 双版本。 - "应当会使用"是唯一的验收口径:不考核看了几遍、花了多少小时,只考核能不能正确用出来。
- 本卷不承诺"一次成功":第 5 章 5.7 节专门写"它一定会失败"的四种崩法 —— 那是正常现象,不是你没学会。
六、文件清单
AI-Agent教程/卷0/
├── 卷0-00-导读.md ← 你正在读的这份(导航 + 目录 + 约定)
├── 卷0-01-这一卷要解决什么.md 第 1 章
├── 卷0-02-全景地图-七层模型.md 第 2 章
├── 卷0-03-环境准备-机器与终端.md 第 3 章
├── 卷0-04-环境准备-三条链路.md 第 4 章
├── 卷0-05-第一个Agent.md 第 5 章
├── 卷0-06-收口-自检与分叉.md 第 6 章
├── images/ 13 张配图(自绘 + 渲染 PNG)
│ ├── fig-0-1-position.png 卷 0 在教程中的位置
│ ├── fig-0-2-seven-layers.png 七层模型
│ ├── fig-0-3-three-links.png 三条链路
│ ├── fig-0-4-agent-loop.png Agent 循环
│ ├── fig-0-5-four-paths.png 四条学习路径
│ ├── fig-0-6-route-choice.png 三条路线选择
│ ├── fig-0-7-lab-tree.png 实验目录与权限
│ ├── fig-0-8-diag-flow.png 报错四步定位
│ ├── fig-0-9-context-growth.png 上下文膨胀
│ ├── fig-0-10-exits.png 四出口 + 人工闸门
│ ├── fig-0-11-acceptance.png 12 项验收
│ ├── fig-0-12-reading-lines.png 三条阅读线
│ └── fig-0-13-deliverables.png 四个产出物
├── code/
│ ├── check_env.py 环境体检(零依赖,14 项)
│ ├── hello_model.py 链路③ 最小示例(零依赖)
│ ├── first_agent.py 第一个 Agent(零依赖,约 200 行)
│ └── requirements.txt 说明:无需安装任何包
└── _archive/
└── 卷0-学习地图-合并版.md 早期单文件版本(已被本目录 6 个分册取代)
七、从哪开始
- 第一次读:直接进 第 1 章,它会告诉你该走"快线 / 标准线 / 深线"哪一条。
- 只想知道怎么装:跳到 第 3 章。
- 已经能调 API,只想写 Agent:确认第 3、4 章的东西你都齐了,然后直接 第 5 章。
- 要评估这套教程适不适合自己带人:第 1 章 1.2 节 + 第 6 章 6.3 节。
卷 0 自成单元。本导读只做导航,不承担教学内容;六章正文各自完整。