从零搭建你的第一个 Agent

这条路径解决什么问题

「从零搭建你的第一个 Agent」是本站的主线。它服务一个很具体的场景：你写过一点程序，听说过 Agent 很火，打开某个框架的文档却立刻被“模型、工具、记忆、工作流、MCP……”淹没，不知道从哪里下手。

这条路径不打算一次性讲完所有概念，而是按真实的搭建顺序带你走一遍：先建立能迁移到任何框架的心智模型，再写一个你能完全看懂的最小 Agent，然后逐步把它变得可靠、可维护，最后发布成一个可以长期运行的小服务。

目标读者

• 写过一点程序（任何语言都行），第一次认真学 Agent；
• 不想停留在“调 API 聊天”，而是想理解 Agent 为什么这样设计、并能亲手搭一个跑起来；
• 读中文，愿意保留英文技术名词（查官方文档时对得上号）；
• 时间有限，希望每门课都有明确产出，而不是看完一堆概念。

学完你将能做什么

走完这条路径后，你应该能：

• 用自己的话解释 Agent 的四个核心部件（模型 / 工具 / 循环 / 记忆），并能在具体任务上判断“该用 Agent，还是普通脚本就够了”；
• 在命令行从零跑起一个带自定义工具的、最小但完整的 Agent；
• 知道怎么给 Agent 划边界（允许哪些工具、最多跑几步、出错怎么办），降低失控风险；
• 能读懂主流 Agent 框架（LangChain、OpenAI Agents SDK、Claude Agent SDK 等）的文档，而不是被它们吓住。

按每周投入两到三小时估算，走完当前已就绪课程约需一周；后续课程补齐后整体约两到三周，动手越多越快。

路径地图（按顺序学习）

路径内课程按下列顺序引用，前序课程的概念是后序课程的前提，不建议跳学：

1. 第 1 课《Agent 核心概念入门》 —— 先用不写代码的方式建立四部件心智模型，学会判断什么任务才需要 Agent。对应内容 slug：agent-core-concepts（frontmatter courses 中引用的正式目标）。

后续课程（最小 Agent 实现、记忆与工具进阶、可靠性工程、发布运维）正在规划中，完成后会陆续上线并自动出现在本页的课程列表里，无需任何额外操作即可看到更新。

学习建议

• 每一课都建议先读文章、再做练习。概念类文章刻意不贴大段 SDK 代码，读完请照文章“延伸阅读”里的官方文档链接去翻原档。
• 卡住时先回读本路径说明，确认自己是否跳过了前序课程；仍无法推进的内容可以在对应文章的评论区或站点反馈渠道提出（上线后开放）。
• 这条路径本身也接受你的反馈：顺序不合理、某课太难或太水，都是有效的修订意见。