> [!NOTE] > 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 > [English](./README.en.md) · [原始项目](https://github.com/microsoft/ai-agents-for-beginners) · [上游 README](https://github.com/microsoft/ai-agents-for-beginners/blob/HEAD/README.md) > 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 # AI Agents for Beginners - 入门课程  ## 一门教你从零开始构建 AI Agents 所需全部知识的课程 [](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 支持（自动化且始终保持最新） [Arabic](./translations/ar/README.md) | [Bengali](./translations/bn/README.md) | [Bulgarian](./translations/bg/README.md) | [Burmese (Myanmar)](./translations/my/README.md) | [Chinese (Simplified)](./translations/zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](./translations/zh-HK/README.md) | [Chinese (Traditional, Macau)](./translations/zh-MO/README.md) | [Chinese (Traditional, Taiwan)](./translations/zh-TW/README.md) | [Croatian](./translations/hr/README.md) | [Czech](./translations/cs/README.md) | [Danish](./translations/da/README.md) | [Dutch](./translations/nl/README.md) | [Estonian](./translations/et/README.md) | [Finnish](./translations/fi/README.md) | [French](./translations/fr/README.md) | [German](./translations/de/README.md) | [Greek](./translations/el/README.md) | [Hebrew](./translations/he/README.md) | [Hindi](./translations/hi/README.md) | [Hungarian](./translations/hu/README.md) | [Indonesian](./translations/id/README.md) | [Italian](./translations/it/README.md) | [Japanese](./translations/ja/README.md) | [Kannada](./translations/kn/README.md) | [Khmer](./translations/km/README.md) | [Korean](./translations/ko/README.md) | [Lithuanian](./translations/lt/README.md) | [Malay](./translations/ms/README.md) | [Malayalam](./translations/ml/README.md) | [Marathi](./translations/mr/README.md) | [Nepali](./translations/ne/README.md) | [Nigerian Pidgin](./translations/pcm/README.md) | [Norwegian](./translations/no/README.md) | [Persian (Farsi)](./translations/fa/README.md) | [Polish](./translations/pl/README.md) | [Portuguese (Brazil)](./translations/pt-BR/README.md) | [Portuguese (Portugal)](./translations/pt-PT/README.md) | [Punjabi (Gurmukhi)](./translations/pa/README.md) | [Romanian](./translations/ro/README.md) | [Russian](./translations/ru/README.md) | [Serbian (Cyrillic)](./translations/sr/README.md) | [Slovak](./translations/sk/README.md) | [Slovenian](./translations/sl/README.md) | [Spanish](./translations/es/README.md) | [Swahili](./translations/sw/README.md) | [Swedish](./translations/sv/README.md) | [Tagalog (Filipino)](./translations/tl/README.md) | [Tamil](./translations/ta/README.md) | [Telugu](./translations/te/README.md) | [Thai](./translations/th/README.md) | [Turkish](./translations/tr/README.md) | [Ukrainian](./translations/uk/README.md) | [Urdu](./translations/ur/README.md) | [Vietnamese](./translations/vi/README.md) > **更想在本地克隆？** > > 本仓库包含 50 多种语言的翻译，会显著增大下载体积。若要在不包含翻译的情况下克隆，请使用 sparse checkout： > > **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 Agents 基础知识的各课时。每节课对应独立主题，可按你喜欢的顺序开始学习！ 本课程提供多语言支持。请前往我们的[可用语言列表](#-multi-language-support)。 如果你是第一次使用生成式 AI（Generative AI）模型进行构建，请查看我们的 [Generative AI For Beginners](https://aka.ms/genai-beginners) 课程，其中包含 21 节关于使用 GenAI 构建应用的课程。 别忘了[为这个仓库加星（🌟）](https://docs.github.com/en/get-started/exploring-projects-on-github/saving-repositories-with-stars?WT.mc_id=academic-105485-koreyst) 并[Fork 本仓库](https://github.com/microsoft/ai-agents-for-beginners/fork) 以便运行代码。 ### 结识其他学员，解答你的疑问 如果在构建 AI Agents 时遇到困难或有任何问题，请加入 [Microsoft Foundry Discord](https://aka.ms/ai-agents/discord). 中的专用频道。 ### 你需要准备什么 本课程的每节课都包含代码示例，可在 code_samples 文件夹中找到。你可以[Fork 本仓库](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 Agent 框架与服务： - [Microsoft Agent Framework (MAF)](https://aka.ms/ai-agents-beginners/agent-framework) - [Microsoft Foundry Agent Service V2](https://aka.ms/ai-agents-beginners/ai-agent-service) 部分代码示例还支持其他兼容 OpenAI 的提供方，例如 [MiniMax](https://platform.minimaxi.com/),，其提供大上下文模型（最高 204K tokens）。配置详情请参阅[课程设置](./00-course-setup/README.md)。 有关运行本课程代码的更多信息，请前往[课程设置](./00-course-setup/README.md)。 ## 🙏 想要贡献？ 有建议，或发现拼写、代码错误？请[提交 Issue](https://github.com/microsoft/ai-agents-for-beginners/issues?WT.mc_id=academic-105485-koreyst) 或[创建 Pull Request](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 智能体框架 | [链接](./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 智能体设计模式 | [链接](./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) | | 智能体 RAG（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) | | 使用智能体协议（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 智能体的上下文工程（Context Engineering） | [链接](./12-context-engineering/README.md) | [视频](https://youtu.be/F5zqRV7gEag) | [链接](https://aka.ms/ai-agents-beginners/collection?WT.mc_id=academic-105485-koreyst) | | 管理智能体记忆 | [链接](./13-agent-memory/README.md) | [视频](https://youtu.be/QrYbHesIxpw?si=vZkVwKrQ4ieCcIPx) | | | 探索 Microsoft Agent Framework | [链接](./14-microsoft-agent-framework/README.md) | | | | 构建计算机使用智能体（CUA） | [链接](./15-browser-use/README.md) | | [链接](https://docs.browser-use.com/examples/templates/playwright-integration) | | 部署可扩展的智能体 | 即将推出 | | | | 创建本地 AI 智能体 | 即将推出 | | | | 保障 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 / Agents [](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 的重要代码示例。 ## 参与贡献 本项目欢迎贡献与建议。 大多数贡献需要你同意贡献者许可协议（Contributor License Agreement，CLA），声明你有权且确实授予我们使用你贡献内容的权利。详情请访问 。 当你提交拉取请求时，CLA 机器人会自动判断你是否需要提供 CLA，并适当地标注该 PR（例如状态检查、评论）。只需按照机器人提供的说明操作即可。在我们使用同一 CLA 的所有仓库中，你只需完成一次。 本项目已采用 [Microsoft 开源行为准则](https://opensource.microsoft.com/codeofconduct/). 更多信息请参阅 [行为准则常见问题](https://opensource.microsoft.com/codeofconduct/faq/) 或 如有其他问题或意见，请联系 [opencode@microsoft.com](mailto:opencode@microsoft.com)。 ## 商标 本项目可能包含项目、产品或服务的商标或标识。经授权使用 Microsoft 商标或标识须遵守并遵循 [Microsoft 商标与品牌指南](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general). 在本项目的修改版本中使用 Microsoft 商标或标识，不得造成混淆或暗示 Microsoft 赞助。任何第三方商标或标识的使用均须遵守相关第三方的政策。 ## 获取帮助 如果你在构建 AI 应用时遇到困难或有任何疑问，欢迎加入： [](https://aka.ms/foundry/discord) 如果你在构建过程中有产品反馈或遇到错误，请访问： [](https://aka.ms/foundry/forum)