📌 项目地址：microsoft/ai-agents-for-beginners | ⭐ 63,493 颗星 | 🔧 Jupyter Notebook | 📜 未标注
这个仓库到底是干什么的
microsoft/ai-agents-for-beginners 是一个免费课程，用一组 Jupyter Notebook 教你怎么从零开始构建 AI Agent。仓库有 63,493 个 star，语言是 Jupyter Notebook。官方描述就一句话：“教一切你需要知道的来开始构建 AI Agent”。
和多数 AI 项目不同，它不依赖 LangChain、AutoGen 这类框架。每个 notebook 直接调用 OpenAI 或 Azure AI 的聊天补全接口，自己实现 Agent 的工具调用、多步推理、外部 API 连接。好处是让你看清底层机制：Agent 不是神秘黑盒，就是“LLM + 循环 + 工具”的组合。坏处是代码偏底层，如果你已经会用框架，会觉得啰嗦。
课程结构：没有目录，但 notebook 按序号排
README 没有列出第几课讲什么，只放了翻译链接和几个 badge。完整课程内容在 .ipynb 文件里，文件名带序号。我打开前两个 notebook：
- 第一个解释了 Agent 是什么，系统提示词、函数定义、循环调用周期。代码用一个简单的 Python 循环演示：用户提问 -> LLM 返回是否调用函数 -> 执行函数 -> 结果返回 LLM -> 生成最终回答。
- 第二个 notebook 扩展了工具调用（function calling），加入多步推理场景。代码量约 80 行，逻辑清晰。
后面的 notebook 涉及 connecting to external APIs（连接外部 API）、building a multi-agent system（多 Agent 系统）等主题。每个 notebook 开头有一段设置环境变量的单元格，后面是混合了文字说明和可执行代码的教学内容。
GitHub 网页端可以直接打开 .ipynb 文件，浏览器渲染效果接近 Jupyter Notebook。不需要本地装 Python 环境就能阅读。想运行代码需要本地配好环境，或者用 GitHub Codespaces（但仓库没有提供自带的 devcontainer 配置）。
学习路径：先读后跑，API Key 是第一道坎
README 没提 API 密钥，但每个 notebook 开头都有 os.environ["AZURE_OPENAI_API_KEY"] 或 OPENAI_API_KEY 的占位符。你没有自己的 OpenAI / Azure AI 服务密钥和 endpoint 就无法执行代码。课程不提供公共演示 key，也没有免费云运行环境。
我的建议：前三个 notebook 只阅读，不运行。代码量不超过 100 行，逻辑都写在注释里，脑子模拟一遍就能理解。想实际跑代码再去注册 API 账户，成本约十几分钟注册和几毛钱额度（如果只是跑前几个 notebook 的示例，花费不到 0.1 美元）。如果你连 LLM API 都没用过，建议先花 30 分钟读完 OpenAI 的“Quickstart”文档，再回来看这个课程。
多语言翻译：可读，但代码仍是英文
仓库支持 50+ 种语言翻译（阿拉伯语、孟加拉语、简体中文、繁体中文、日语、韩语等），由 GitHub Action 自动生成。我打开简体中文版读了一段：概念翻译基本到位，但代码块里的注释、变量名、函数参数保持英文。偶尔有机器翻译的生硬句子（比如“此操作将允许代理执行工具调用”），不影响理解。
如果你英文阅读速度慢，可以用中文版本看文字部分，然后切回英文原版 notebook 看代码细节。翻译可能落后原版几个版本，但核心内容变化不大。
社区：Issues 里能搜到常见坑
项目近期还有 commit。Issues 模板分 bug report 和 feature request。我搜了“API key”，有人问环境变量怎么设，也有人报 notebook 里某段代码因为 API 版本更新报错。维护者会回应是代码问题还是 API 变更。如果你跑代码遇到报错，先搜 Issues 再提新问题，效率更高。
README 还有一个链接指向 makeapullrequest.com，是教你怎么提 PR 的第三方教程。翻译修正、文档改进都在欢迎范围内。想练手 PR 的可以从这里开始。
适合谁不适合谁
- 适合：想理解 Agent 底层原理的初学者；能接受 Python 和 API 成本；愿意先看文档再提问的人。
- 不适合：希望直接拿框架开箱即用的开发者（建议直接学 LangChain / AutoGen）；没有 API key 预算的人（免费额度用完就要付费）；英文阅读困难且不能忍受机器翻译的人。
63k star 不保证每个 notebook 完美，但作为微软官方课程，内容质量高于大部分个人博客。如果你想搞清楚“AI Agent 到底怎么自己写”，打开第一个 notebook 读 15 分钟，比搜 10 篇推荐文章管用。