跳到正文
AI Agent 教程 · 卷 0 · 学习地图

导读

本合集目录
本章目录

本卷目标:看懂全景、装好环境、跑通第一个 Agent、选对自己的下一步。 读完这一卷,你不需要读其他任何一卷,就已经拥有一个能工作的 Agent 和一个可继续扩展的环境。

本文件是卷 0 的导航页:说明这一卷包含什么、文件怎么组织、从哪开始。正式内容在 6 个分册里,每个分册都可以单独打开阅读。

卷 0 在整套教程中的位置


一、本卷信息

项 内容
卷号 / 卷名 卷 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 章的代码,报错信息会让你以为是代码问题,其实是环境问题。


三、读完应该拿到什么

四样东西,每一样都有明确的判定证据,不靠"我感觉我会了"。

卷 0 的四个产出物与判定方式


四、开始之前

三件事先确认,缺一件都会在后面的章节里反复卡:

项 要求 详见
电脑 能上网;Windows 10/11、macOS 12+ 或主流 Linux;8GB 内存起 第 3 章 3.2
模型服务账号 至少一个,能拿到 API Key(也可以先用客户端,稍后再配) 第 3 章 3.3
终端 会打开、会 cd、会看自己在哪个目录 第 3 章 3.4

不需要:不需要服务器、不需要域名、不需要会 Docker、不需要先学机器学习。


五、阅读约定

本卷 6 个文件共用一套约定,跨文件阅读时不必重新适应:

  1. 编号沿用不分册:小节号 5.3 指第 5 章第 3 节,无论你在哪个文件里看到它,位置都不变。跨章引用写成"见 5.3 节"。
  2. 图放在用它的地方:每张图都在正文里被引用,图注说明"这张图回答什么问题",不是装饰。
  3. 代码全部可直接运行:code/ 下三个脚本零第三方依赖(只用 Python 标准库),不需要 pip install 任何东西。命令给 Windows 与 macOS 双版本。
  4. "应当会使用"是唯一的验收口径:不考核看了几遍、花了多少小时,只考核能不能正确用出来。
  5. 本卷不承诺"一次成功":第 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 自成单元。本导读只做导航,不承担教学内容;六章正文各自完整。