Python AI Agent 框架入门

进阶

2026 年，写 AI 应用已经不只是「调 API 聊天」：Agent（智能体）会自己规划、调用工具、跑多步任务。但市面上的框架多到让人无从下手——这门课面向会 Python 基础语法的大学生，用通俗的语言带你把 2026 年的框架版图看明白，再逐个上手主流框架、各写一个能跑的最小例子，建立属于自己的选型直觉。

你将学会什么

看懂 2026 年 Agent 框架版图与选型思路
用 Smolagents 十分钟写出第一个 Agent
用 LangGraph 把工作流画成状态图
用 PydanticAI 拿到类型安全的结构化输出
知道 MCP 在 Python 侧怎么用
理解 DSPy、CrewAI、OpenAI Agents SDK 的适用场景

前置要求

会 Python 基础语法（函数、类型注解、pip 安装）
建议先读《MCP 协议入门》课程，了解「协议」是什么
有一个能跑 Python 的环境（本机或 Colab 都行）

章节目录

章节	内容
1. 全景与选型	2026 年框架版图、四层坐标系与选型口诀
2. Smolagents	让 LLM 写代码的极简 Agent，十分钟跑通
3. LangGraph	状态图编排：节点、边、条件边与 reducer
4. PydanticAI	类型安全：用 Pydantic 模型锁定输出结构
5. MCP Python 实战	用 MCPServer 写工具服务器，任何框架都能接
6. DSPy	评测驱动：让优化器自动调你的提示词
7. CrewAI	角色分工的多 Agent 团队编排
8. OpenAI Agents SDK	少量原语 + 内置追踪的轻量生产 SDK
9. LlamaIndex	Agentic RAG：让 Agent 从知识库里找答案

学习路线建议

官方课程与本书顺序一致：Hugging Face 的 Agents Course（免费、发证书、浏览器可跑）和 LangChain 的 Academy 都可以作为配套练习
建议按 1 → 2 → 3 → 4 章顺序精读，前三章建立「Agent 是什么、代码型怎么写、流程怎么编排」的完整心智；后面几章按兴趣跳读
每章末尾都有 3 道小测验，答错时解析会说明原因

常见问题

Smolagents、LangGraph、PydanticAI 到底怎么选？

先按课程第一讲的四层坐标系定位，不要跨层比较。快速写出单个 Agent，选 Smolagents 或 PydanticAI：前者代码量最小、十分钟跑通，后者输出类型安全；需要状态图编排长任务、断点续跑，才用 LangGraph。

为什么老教程里的写法现在会报错？

2026 年各框架更新了 API 命名：Smolagents 的模型类改为 InferenceClientModel（HfApiModel 已退役），PydanticAI 改用 instructions、output_type、result.output。照抄老教程会直接报错，写代码前先看 Smolagents 与 PydanticAI 章节里的版本说明。

PydanticAI 的类型安全解决了什么问题？

没有类型安全时，agent.run() 返回的是自由文本，取字段只能靠正则；声明 output_type 后，result.output 的类型、字段、校验逻辑都由你声明，写错当场报错，校验失败还会自动重试。完整的例子和进阶玩法见 PydanticAI：类型安全的 Agent。

章节必须按顺序学吗？

建议按 1 → 2 → 3 → 4 章顺序精读，建立框架版图、代码型 Agent、流程编排与类型安全四个概念；后面几章按兴趣跳读。想最快动手，直接读 Smolagents：十分钟写出第一个 Agent，再回头补全景与选型也可以。