# 初学者的 AI 代理 — 一门课程
## 一门教授构建 AI 代理所需全部知识的课程
[](https://github.com/microsoft/ai-agents-for-beginners/blob/master/LICENSE?WT.mc_id=academic-105485-koreyst)
[](https://GitHub.com/microsoft/ai-agents-for-beginners/graphs/contributors/?WT.mc_id=academic-105485-koreyst)
[](https://GitHub.com/microsoft/ai-agents-for-beginners/issues/?WT.mc_id=academic-105485-koreyst)
[](https://GitHub.com/microsoft/ai-agents-for-beginners/pulls/?WT.mc_id=academic-105485-koreyst)
[](http://makeapullrequest.com?WT.mc_id=academic-105485-koreyst)
### 🌐 多语言支持
#### 通过 GitHub Action 支持（自动且始终最新）
[阿拉伯语](../ar/README.md) | [孟加拉语](../bn/README.md) | [保加利亚语](../bg/README.md) | [缅甸语 (Myanmar)](../my/README.md) | [简体中文](./README.md) | [繁体中文 (香港)](../zh-HK/README.md) | [繁体中文 (澳门)](../zh-MO/README.md) | [繁体中文 (台湾)](../zh-TW/README.md) | [克罗地亚语](../hr/README.md) | [捷克语](../cs/README.md) | [丹麦语](../da/README.md) | [荷兰语](../nl/README.md) | [爱沙尼亚语](../et/README.md) | [芬兰语](../fi/README.md) | [法语](../fr/README.md) | [德语](../de/README.md) | [希腊语](../el/README.md) | [希伯来语](../he/README.md) | [印地语](../hi/README.md) | [匈牙利语](../hu/README.md) | [印尼语](../id/README.md) | [意大利语](../it/README.md) | [日语](../ja/README.md) | [坎纳达语](../kn/README.md) | [高棉语](../km/README.md) | [韩语](../ko/README.md) | [立陶宛语](../lt/README.md) | [马来语](../ms/README.md) | [马拉雅拉姆语](../ml/README.md) | [马拉地语](../mr/README.md) | [尼泊尔语](../ne/README.md) | [尼日利亚皮钦语](../pcm/README.md) | [挪威语](../no/README.md) | [波斯语 (Farsi)](../fa/README.md) | [波兰语](../pl/README.md) | [葡萄牙语 (巴西)](../pt-BR/README.md) | [葡萄牙语 (葡萄牙)](../pt-PT/README.md) | [旁遮普语 (Gurmukhi)](../pa/README.md) | [罗马尼亚语](../ro/README.md) | [俄语](../ru/README.md) | [塞尔维亚语 (西里尔)](../sr/README.md) | [斯洛伐克语](../sk/README.md) | [斯洛文尼亚语](../sl/README.md) | [西班牙语](../es/README.md) | [斯瓦希里语](../sw/README.md) | [瑞典语](../sv/README.md) | [他加禄语 (菲律宾语)](../tl/README.md) | [泰米尔语](../ta/README.md) | [泰卢固语](../te/README.md) | [泰语](../th/README.md) | [土耳其语](../tr/README.md) | [乌克兰语](../uk/README.md) | [乌尔都语](../ur/README.md) | [越南语](../vi/README.md)
> **更喜欢本地克隆？**
>
> 本仓库包含50多种语言的翻译，这显著增加了下载大小。要不带翻译克隆，请使用稀疏检出：
>
> **Bash / macOS / Linux:**
> ```bash
> git clone --filter=blob:none --sparse https://github.com/microsoft/ai-agents-for-beginners.git
> cd ai-agents-for-beginners
> git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'
> ```
>
> **CMD (Windows):**
> ```cmd
> git clone --filter=blob:none --sparse https://github.com/microsoft/ai-agents-for-beginners.git
> cd ai-agents-for-beginners
> git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
> ```
>
> 这样可以更快地下载，获取完成课程所需的所有内容。
**如果您希望支持更多翻译语言，可查看[这里](https://github.com/Azure/co-op-translator/blob/main/getting_started/supported-languages.md)。**
[](https://GitHub.com/microsoft/ai-agents-for-beginners/watchers/?WT.mc_id=academic-105485-koreyst)
[](https://GitHub.com/microsoft/ai-agents-for-beginners/network/?WT.mc_id=academic-105485-koreyst)
[](https://GitHub.com/microsoft/ai-agents-for-beginners/stargazers/?WT.mc_id=academic-105485-koreyst)
[](https://discord.com/invite/ATgtXmAS5D)
## 🌱 入门指南
本课程涵盖构建 AI 代理的基础知识。每节课专注于一个主题，您可以从任何地方开始学习！
本课程支持多语言。请前往我们[可用语言这里](#-multi-language-support)。
如果这是您第一次使用生成式 AI 模型构建，推荐查看我们的[生成式 AI 初学者课程](https://aka.ms/genai-beginners)，其中包含21个构建生成式 AI 的课程。
别忘了[为此仓库点星 (🌟)](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-koreyst)并[分叉此仓库](https://github.com/microsoft/ai-agents-for-beginners/fork)以运行代码。
### 认识其他学习者，获得问题解答
如果您在构建 AI 代理时遇到困难或有任何问题，请加入我们的专用 Discord 频道：[Microsoft Foundry Discord](https://aka.ms/ai-agents/discord)。
### 您需要准备的内容
本课程的每节课都包含代码示例，保存在 code_samples 文件夹中。您可以[分叉此仓库](https://github.com/microsoft/ai-agents-for-beginners/fork)以创建您自己的副本。
这些练习的代码示例使用 Microsoft Agent Framework 和 Microsoft Foundry Agent Service V2：
- [Microsoft Foundry](https://aka.ms/ai-agents-beginners/ai-foundry) - 需要 Azure 账户
本课程使用 Microsoft 提供的以下 AI 代理框架和服务：
- [Microsoft Agent Framework (MAF)](https://learn.microsoft.com/agent-framework/overview/)
- [Microsoft Foundry Agent Service V2](https://aka.ms/ai-agents-beginners/ai-agent-service)
部分代码示例也支持兼容 OpenAI 的替代提供商，如[MiniMax](https://platform.minimaxi.com/)，它提供大上下文模型（最高支持 204K 令牌）。详情请参见[课程设置](./00-course-setup/README.md)。
有关运行本课程代码的更多信息，请访问[课程设置](./00-course-setup/README.md)。
## 🙏 想要帮忙吗？
您有建议或发现拼写或代码错误吗？请[提交问题](https://github.com/microsoft/ai-agents-for-beginners/issues?WT.mc_id=academic-105485-koreyst)或[创建拉取请求](https://github.com/microsoft/ai-agents-for-beginners/pulls?WT.mc_id=academic-105485-koreyst)
## 📂 每节课包含
- 书面课程，位于 README 中，附带短视频
- 使用 Microsoft Agent Framework 和 Microsoft Foundry 的 Python 代码示例
- 继续学习的额外资源链接
## 🗃️ 课程列表
| 课程 | 文本与代码 | 视频 | 额外学习 |
|----------------------------------------------|----------------------------------------------------|------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
| AI 代理简介及代理用例 | [链接](./01-intro-to-ai-agents/README.md) | [视频](https://youtu.be/3zgm60bXmQk?si=z8QygFvYQv-9WtO1) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| 探索 AI Agentic 框架 | [链接](./02-explore-agentic-frameworks/README.md) | [视频](https://youtu.be/ODwF-EZo_O8?si=Vawth4hzVaHv-u0H) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| 了解 AI Agentic 设计模式 | [链接](./03-agentic-design-patterns/README.md) | [视频](https://youtu.be/m9lM8qqoOEA?si=BIzHwzstTPL8o9GF) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| 工具使用设计模式 | [链接](./04-tool-use/README.md) | [视频](https://youtu.be/vieRiPRx-gI?si=2z6O2Xu2cu_Jz46N) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| Agentic RAG | [链接](./05-agentic-rag/README.md) | [视频](https://youtu.be/WcjAARvdL7I?si=gKPWsQpKiIlDH9A3) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| 构建值得信赖的 AI 代理 | [链接](./06-building-trustworthy-agents/README.md) | [视频](https://youtu.be/iZKkMEGBCUQ?si=jZjpiMnGFOE9L8OK ) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| 规划设计模式 | [链接](./07-planning-design/README.md) | [视频](https://youtu.be/kPfJ2BrBCMY?si=6SC_iv_E5-mzucnC) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| 多代理设计模式 | [链接](./08-multi-agent/README.md) | [视频](https://youtu.be/V6HpE9hZEx0?si=rMgDhEu7wXo2uo6g) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| 元认知设计模式 | [链接](./09-metacognition/README.md) | [视频](https://youtu.be/His9R6gw6Ec?si=8gck6vvdSNCt6OcF) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| 生产环境中的 AI 代理 | [链接](./10-ai-agents-production/README.md) | [视频](https://youtu.be/l4TP6IyJxmQ?si=31dnhexRo6yLRJDl) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| 使用 Agentic 协议（MCP、A2A 和 NLWeb） | [链接](./11-agentic-protocols/README.md) | [视频](https://youtu.be/X-Dh9R3Opn8) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| AI 代理的上下文工程 | [链接](./12-context-engineering/README.md) | [视频](https://youtu.be/F5zqRV7gEag) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
| 管理 Agentic 记忆 | [链接](./13-agent-memory/README.md) | [视频](https://youtu.be/QrYbHesIxpw?si=vZkVwKrQ4ieCcIPx) | |
| 探索微软 Agent 框架 | [链接](./14-microsoft-agent-framework/README.md) | | |
| 构建计算机使用代理（CUA） | [链接](./15-browser-use/README.md) | | [链接](https://docs.browser-use.com/examples/templates/playwright-integration) |
| 部署可扩展代理 | [链接](./16-deploying-scalable-agents/README.md) | | [链接](https://learn.microsoft.com/azure/ai-foundry/agents/overview) |
| 创建本地 AI 代理 | [链接](./17-creating-local-ai-agents/README.md) | | [链接](https://learn.microsoft.com/azure/ai-foundry/foundry-local/) |
| 保障 AI 代理安全 | [链接](./18-securing-ai-agents/README.md) | | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) |
## 🎒 其他课程
我们团队还制作了其他课程！查看：
### LangChain
[](https://aka.ms/langchain4j-for-beginners)
[](https://aka.ms/langchainjs-for-beginners?WT.mc_id=m365-94501-dwahlin)
[](https://github.com/microsoft/langchain-for-beginners?WT.mc_id=m365-94501-dwahlin)
---
### Azure / Edge / MCP / 代理
[](https://github.com/microsoft/AZD-for-beginners?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/edgeai-for-beginners?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/mcp-for-beginners?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/ai-agents-for-beginners?WT.mc_id=academic-105485-koreyst)
---
### 生成式 AI 系列
[](https://github.com/microsoft/generative-ai-for-beginners?WT.mc_id=academic-105485-koreyst)
[-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA)](https://github.com/microsoft/Generative-AI-for-beginners-dotnet?WT.mc_id=academic-105485-koreyst)
[-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC)](https://github.com/microsoft/generative-ai-for-beginners-java?WT.mc_id=academic-105485-koreyst)
[-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9)](https://github.com/microsoft/generative-ai-with-javascript?WT.mc_id=academic-105485-koreyst)
---
### 核心学习
[](https://aka.ms/ml-beginners?WT.mc_id=academic-105485-koreyst)
[](https://aka.ms/datascience-beginners?WT.mc_id=academic-105485-koreyst)
[](https://aka.ms/ai-beginners?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/Security-101?WT.mc_id=academic-96948-sayoung)
[](https://aka.ms/webdev-beginners?WT.mc_id=academic-105485-koreyst)
[](https://aka.ms/iot-beginners?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/xr-development-for-beginners?WT.mc_id=academic-105485-koreyst)
---
### Copilot 系列
[](https://aka.ms/GitHubCopilotAI?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers?WT.mc_id=academic-105485-koreyst)
[](https://github.com/microsoft/CopilotAdventures?WT.mc_id=academic-105485-koreyst)
## 🌟 社区感谢
感谢 [Shivam Goyal](https://www.linkedin.com/in/shivam2003/) 贡献了演示 Agentic RAG 的重要代码示例。
## 贡献
欢迎对本项目进行贡献和提出建议。大多数贡献需要您同意
贡献者许可协议（CLA），声明您有权利，并且实际授予我们
使用您贡献内容的权利。详情请访问 。
当您提交拉取请求时，CLA 机器人将自动确定您是否需要提供
CLA 并相应地标记 PR（例如，状态检查、评论）。只需按照机器人提供的指示操作即可。
在使用我们的 CLA 的所有仓库中，您只需执行此操作一次。
本项目采用了 [Microsoft 开源行为准则](https://opensource.microsoft.com/codeofconduct/)。
更多信息请参见 [行为准则常见问题](https://opensource.microsoft.com/codeofconduct/faq/) 或
通过邮箱联系 [opencode@microsoft.com](mailto:opencode@microsoft.com) 提问或反馈。
## 商标
本项目可能包含项目、产品或服务的商标或徽标。授权使用微软商标
或徽标须遵循
[微软商标及品牌指南](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general)。
修改本项目时使用微软商标或徽标不得引起混淆或暗示微软赞助。
任何第三方商标或徽标的使用均须遵守相应第三方的政策。
## 获取帮助
如果遇到困难或对构建 AI 应用有任何问题，请加入：
[](https://aka.ms/foundry/discord)
如果在构建过程中有产品反馈或出现错误，请访问：
[](https://aka.ms/foundry/forum)
---
**免责声明**：
本文件由 AI 翻译服务 [Co-op Translator](https://github.com/Azure/co-op-translator) 翻译完成。尽管我们力求准确，但请注意，自动翻译可能包含错误或不准确之处。原始语言版文件应视为权威来源。对于重要信息，建议使用专业人工翻译。我们对因使用本翻译而产生的任何误解或误释不承担责任。