wehub-resource-sync
195 lines
20 KiB
Markdown
195 lines
20 KiB
Markdown
<!-- WEHUB_ZH_README -->
|
||
> [!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 支持（自动化且始终保持最新）
|
||
|
||
<!-- CO-OP TRANSLATOR LANGUAGES TABLE START -->
|
||
[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"
|
||
> ```
|
||
>
|
||
> 这样即可获得完成课程所需的全部内容，同时下载速度更快。
|
||
<!-- CO-OP TRANSLATOR LANGUAGES TABLE END -->
|
||
|
||
**如果希望支持更多翻译语言，相关语言列在[此处](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) |
|
||
|
||
## 🎒 其他课程
|
||
|
||
我们团队还制作了其他课程！欢迎查看：
|
||
|
||
<!-- CO-OP TRANSLATOR OTHER COURSES START -->
|
||
### 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)
|
||
<!-- CO-OP TRANSLATOR OTHER COURSES END -->
|
||
|
||
## 🌟 社区致谢
|
||
|
||
感谢 [Shivam Goyal](https://www.linkedin.com/in/shivam2003/) 贡献了展示 Agentic RAG 的重要代码示例。
|
||
|
||
## 参与贡献
|
||
|
||
本项目欢迎贡献与建议。 大多数贡献需要你同意贡献者许可协议（Contributor License Agreement，CLA），声明你有权且确实授予我们使用你贡献内容的权利。详情请访问 <https://cla.opensource.microsoft.com>。
|
||
|
||
当你提交拉取请求时，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)
|