AI Agents for Beginners —— 微软 18 节 AI 智能体入门课程
微软开源的 AI 智能体入门课程仓库，包含 18 节课程，每节配有 README 书面教程、短视频、使用 Microsoft Agent Framework 与 Microsoft Foundry 的 Python 代码示例以及延伸学习链接，覆盖智能体基础、设计模式、Agentic RAG、MCP/A2A/NLWeb 协议、上下文工程、记忆管理、计算机使用型智能体、本地智能体、部署与安全等主题，并提供 50 多种语言的翻译。
社区作者 · zZz
它解决什么问题
本项目是微软推出的《AI Agents for Beginners》课程仓库，目标是教会学习者从零开始构建 AI 智能体（AI Agents）。仓库标题标明为 18 节课程（18 Lessons）。
【课程定位】 课程覆盖构建 AI 智能体的基础知识，每节课程自成主题，学习者可以从任意一节开始学习。如果此前没有使用生成式 AI 模型的经验，正文建议先学习同一团队的《Generative AI For Beginners》（21 节课程）。正文同时建议为仓库加星（🌟）并 Fork 以运行代码。
【配图】 配图 1（AI Agents for Beginners）为课程仓库的缩略示意图（repo-thumbnailv3.png）。
【多语言支持】 课程通过 GitHub Action 自动生成并持续更新翻译，支持阿拉伯语、孟加拉语、保加利亚语、缅甸语、简体中文、繁体中文（香港/澳门/台湾）、克罗地亚语、捷克语、丹麦语、荷兰语、爱沙尼亚语、芬兰语、法语、德语、希腊语、希伯来语、印地语、匈牙利语、印尼语、意大利语、日语、卡纳达语、高棉语、韩语、立陶宛语、马来语、马拉雅拉姆语、马拉地语、尼泊尔语、尼日利亚皮钦语、挪威语、波斯语、波兰语、葡萄牙语（巴西/葡萄牙）、旁遮普语、罗马尼亚语、俄语、塞尔维亚语（西里尔）、斯洛伐克语、斯洛文尼亚语、西班牙语、斯瓦希里语、瑞典语、他加禄语、泰米尔语、泰卢固语、泰语、土耳其语、乌克兰语、乌尔都语、越南语等 50 多种语言。
【技术栈与依赖】 课程中的代码示例使用 Microsoft Agent Framework 搭配 Microsoft Foundry Agent Service V2，需要 Azure 账号（Microsoft Foundry）。课程使用的微软 AI 智能体框架与服务包括：Microsoft Agent Framework（MAF）、Microsoft Foundry Agent Service V2。
部分代码示例还支持 OpenAI 兼容的替代提供商，例如 MiniMax，其提供最高 204K tokens 的大上下文模型，具体配置见 Course Setup。运行课程的说明同样指向 Course Setup。
【每节课包含的内容】 1）位于 README 的书面课程与一段短视频；2）使用 Microsoft Agent Framework 与 Microsoft Foundry 的 Python 代码示例（位于 code_samples 文件夹）；3）继续学习的延伸资源链接。
【课程表（节选主题）】 AI 智能体与智能体用例简介、探索 AI 智能体框架、理解 AI 智能体设计模式、工具使用设计模式、Agentic RAG、构建可信 AI 智能体、规划（Planning）设计模式、多智能体设计模式、元认知（Metacognition）设计模式、生产环境中的 AI 智能体、使用智能体协议（MCP、A2A 与 NLWeb）、AI 智能体的上下文工程、管理智能体记忆、探索 Microsoft Agent Framework、构建计算机使用智能体（CUA）、部署可扩展智能体、创建本地 AI 智能体、保护 AI 智能体。
其中 Agentic RAG 部分的重要代码示例由社区贡献者 Shivam Goyal 贡献。
【社区与反馈】 如在学习中遇到问题，可加入 Microsoft Foundry Discord 的专属频道（Discord Channel）提问；如发现拼写或代码错误，可提交 Issue 或创建 Pull Request。项目欢迎贡献，大部分贡献需要同意 Contributor License Agreement（CLA），提交 PR 时 CLA 机器人会自动判断是否需要提供 CLA 并标记该 PR，同一 CLA 在所有仓库中只需签署一次。项目采用 Microsoft Open Source Code of Conduct。
【商标说明】 项目可能包含 Microsoft 及第三方商标或徽标，授权使用须遵守 Microsoft 的商标与品牌准则；修改版本中使用 Microsoft 商标或徽标不得引起混淆或暗示微软背书，第三方商标遵循第三方的政策。
【许可证情况】 来源正文未明确标注具体的开源许可证名称，仅说明贡献需同意 Microsoft CLA、项目采用 Microsoft 开源行为准则并包含商标条款，具体许可证类型待核验。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
【准备环境】
- 准备 Git 客户端与可访问 GitHub 的网络环境。
- 运行课程代码需要一个 Azure 账号（课程使用 Microsoft Foundry，需 Azure 账号）。
- 课程代码示例位于仓库的 code_samples 文件夹；正文建议 Fork 本仓库以创建自己的副本后再运行代码。
- 注意：仓库包含 50+ 语言翻译，会显著增大下载体积（正文明确提示 "This repository includes 50+ language translations which significantly increases the download size"）。若只想要完成课程所需内容并获得更快的下载速度，使用 sparse checkout 排除翻译目录。
【克隆方式一
Bash / macOS / Linux（不含翻译）】按以下顺序执行：
git clone --filter=blob:none --sparse https://github.com/microsoft/ai-agents-for-beginners.gitcd ai-agents-for-beginnersgit sparse-checkout set --no-cone '/*' '!translations' '!translated_images'【克隆方式二：CMD（Windows，不含翻译）】 按以下顺序执行：
git clone --filter=blob:none --sparse https://github.com/microsoft/ai-agents-for-beginners.gitcd ai-agents-for-beginnersgit sparse-checkout set --no-cone "/*" "!translations" "!translated_images"【课程配置与首次运行】
- 转到 Course Setup（课程设置）页面，按其说明完成运行课程代码所需的配置。
- 代码示例基于 Microsoft Agent Framework 搭配 Microsoft Foundry Agent Service V2；使用前需准备 Azure 账号与 Microsoft Foundry。
- 部分代码示例支持 OpenAI 兼容的替代提供商，例如 MiniMax（提供最高 204K tokens 的大上下文模型），具体配置同样见 Course Setup。
- 每节课都包含书面教程、短视频与 Python 代码示例，可按任意顺序从任意一节开始学习。
【常见问题】
- 若在构建 AI 智能体时卡住或有疑问，可加入 Microsoft Foundry Discord 中的专属 Discord Channel 提问。
- 若发现拼写或代码错误，可提交 Issue 或创建 Pull Request。
- 提交 PR 时，CLA 机器人会自动判断是否需要提供 CLA 并相应地标记该 PR（例如状态检查、评论），按照机器人给出的说明操作即可；在所有使用该 CLA 的仓库中只需签署一次。
- 若需要更多翻译语言，正文说明可在其语言列表中查看已支持语言与新增方式（链接见原文 "they are listed here"）。
来源教程配图
