主题
学习路线图
欢迎！在写第一行代码之前，花 10 分钟搞清楚三件事：Agent 是什么、为什么用 Python、接下来怎么学。
Agent 到底是什么？
用一句话说：
Agent = 大模型（大脑）+ 工具（手脚）+ 循环（自主决策）
你一定用过 ChatGPT。普通的聊天机器人是「你问一句，它答一句」，它只能说。而 Agent 能做：
| 聊天机器人 | Agent | |
|---|---|---|
| 能力 | 根据训练知识回答问题 | 自己决定调用工具：搜索、读写文件、调 API、执行代码…… |
| 流程 | 一问一答 | 思考 → 行动 → 观察结果 → 再思考……直到完成任务 |
| 例子 | 「什么是 React？」 | 「帮我把这个项目从 Vue2 升级到 Vue3，跑通测试」 |
你日常用的 Cursor、Claude Code、Qoder 的 Agent 模式、Manus、各种 Deep Research，本质上都是 Agent。学完这套教程，你就能理解它们是怎么工作的，并且做出自己的版本。
为什么是 Python？
你的方向是合理的：Python 是 Agent 开发的重要主流语言之一，并不是唯一选择。对本课程来说，选择它的原因很现实：
- 生态丰富：LangChain / LangGraph、LlamaIndex、CrewAI、OpenAI Agents SDK 等都有 Python 路径；数据处理、模型与研究工具也经常使用 Python。不是所有框架都以 Python 优先，TS 同样有成熟选项。
- AI 领域的通用语言：论文代码、开源模型、数据处理工具（numpy、pandas）都是 Python，你迟早要读别人的代码。
- 容易借力已有经验：对于有 JS 基础的你，可以通过对照语法迅速开始练习。学习时间取决于每天投入和动手情况，不必按固定天数要求自己。
前端同学的定心丸
TypeScript 生态也有不错的选择（Vercel AI SDK、Mastra、LangChain.js）。但先用 Python 学透原理是更好的路径：原理是相通的，学完之后你用 TS 写 Agent 也会非常顺手。在 项目 4 中，我们就会用 Python 后端 + 前端页面 的方式，让你的前端技能派上用场。
本教程的学习路径
LEARNING PATH
一条清晰的学习路线
七个阶段，每一步都建立在上一步之上。跟着走，不迷路。
🧭STAGE 00⏱ 0.5 天
开始之前
搞清楚学什么、为什么学，并把开发环境一次配好。
开始 →🐍STAGE 01⏱ 5-7 天
Python 速成
用你熟悉的 JS/TS 做对照，一周掌握写 Agent 够用的 Python。
开始 →🧠STAGE 02⏱ 3-4 天
大模型基础
理解 Token、上下文、温度，学会调 API、写 Prompt、拿结构化输出。
开始 →🤖STAGE 03⏱ 5-7 天
Agent 核心
不依赖任何框架，从零手写 Agent：工具调用、循环、记忆、RAG、规划。
开始 →🧩STAGE 04⏱ 4-5 天
框架与生态
有了底层认知再学框架：LangGraph 状态图、MCP 协议、多 Agent 协作。
开始 →🚀STAGE 05⏱ 10+ 天
实战项目
5 个由浅入深的完整项目，最后用你的前端功底做出全栈 Agent 产品。
开始 →🛡STAGE 06⏱ 2-3 天
工程化
调试、观测、评估、安全与成本控制，让 Agent 真正可上线。
开始 →本教程的教学理念
1. 用 JS 对照学 Python
你不是编程新手，只是 Python 新手。所以我们不会从「什么是变量」讲起，而是这样：
js
const names = users.filter(u => u.age > 18).map(u => u.name)python
names = [u["name"] for u in users if u["age"] > 18]2. 先造轮子，再用轮子
很多教程一上来就教 LangChain，结果学了一堆 API，出了问题完全不知道发生了什么。
我们反过来：第三阶段完全不用框架，只用最基础的 HTTP API 手写一个 Agent。你会发现所谓的 Agent 核心不过几十行代码。理解了这个，再去学任何框架都只是「看文档」的事。
3. 每个阶段都有实战
学完就练，练完就有原型。五个教学项目从完整核心代码出发；结合自己的业务继续完善、增加测试后，可以整理成作品。
怎样使用这份文档
- ✅ 一定要动手敲代码。复制粘贴只会给你「我懂了」的错觉。
- ✅ 遇到报错先读报错信息。Python 的报错信息非常友好，最后一行通常就告诉你哪里错了。
- ✅ 善用 AI 助手。看不懂的代码，丢给 AI 解释——这本身也是在学习如何与大模型协作。
- ✅ 每个阶段结束后做实战，别跳过。
- ⏭ 如果你已经会 Python，可以直接从 第二阶段 开始。
准备好了吗？下一步：配置开发环境 →