# 初學者的 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) | [緬甸語](../my/README.md) | [中文（簡體）](../zh-CN/README.md) | [中文（繁體，香港）](../zh-HK/README.md) | [中文（繁體，澳門）](./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) | [波斯語 (法爾西語)](../fa/README.md) | [波蘭語](../pl/README.md) | [葡萄牙語（巴西）](../pt-BR/README.md) | [葡萄牙語（葡萄牙）](../pt-PT/README.md) | [旁遮普語（古魯穆奇文）](../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 代理框架搭配 Microsoft Foundry 代理服務 V2：
- [Microsoft Foundry](https://aka.ms/ai-agents-beginners/ai-foundry) - 需要 Azure 帳戶
本課程使用下列 Microsoft AI 代理框架與服務：
- [Microsoft 代理框架 (MAF)](https://learn.microsoft.com/agent-framework/overview/)
- [Microsoft Foundry 代理服務 V2](https://aka.ms/ai-agents-beginners/ai-agent-service)
部分示範代碼同時支援替代的 OpenAI 兼容提供者，如提供大上下文模型（最高可達 204K 代幣）的 [MiniMax](https://platform.minimaxi.com/)。配置細節請參閱 [課程設置](./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 代理框架結合 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 | [連結](./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 代理的上下文工程 | [連結](./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 代理框架 | [連結](./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) 提出任何其他問題或意見。
## 商標
本專案可能包含專案、產品或服務的商標或標誌。授權使用 Microsoft
商標或標誌須遵守並遵循
[Microsoft 的商標和品牌指南](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general)。
在修改版本的專案中使用 Microsoft 商標或標誌，不得造成混淆或暗示 Microsoft 贊助。
對第三方商標或標誌的任何使用，須遵守該第三方的政策。
## 尋求協助
若遇到困難或有任何關於建立 AI 應用程式的問題，歡迎加入：
[](https://aka.ms/foundry/discord)
若在開發過程中有產品反饋或錯誤，請造訪：
[](https://aka.ms/foundry/forum)
---
**免責聲明**：
本文件使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。雖然我們力求準確，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應被視為權威來源。對於重要資訊，建議尋求專業人工翻譯。我們不對因使用本翻譯而引起的任何誤解或曲解承擔責任。