microsoft--ai-agents-for-beginners
201 行
20 KiB
Markdown
201 行
20 KiB
Markdown
# 初學者的 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 支援(自動且永遠保持最新)
|
||
|
||
<!-- CO-OP TRANSLATOR LANGUAGES TABLE START -->
|
||
[阿拉伯語](../ar/README.md) | [孟加拉語](../bn/README.md) | [保加利亞語](../bg/README.md) | [緬甸語 (Myanmar)](../my/README.md) | [中文(簡體)](../zh-CN/README.md) | [中文(繁體,香港)](../zh-HK/README.md) | [中文(繁體,澳門)](../zh-MO/README.md) | [中文(繁體,臺灣)](./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"
|
||
> ```
|
||
>
|
||
> 這樣你就能以更快的速度取得完成課程所需的一切。
|
||
<!-- 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.gg/nTYy5BXMWG)
|
||
|
||
|
||
## 🌱 開始學習
|
||
|
||
本課程涵蓋建立 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 搭配 Azure AI Foundry Agent Service V2:
|
||
|
||
- [Microsoft Foundry](https://aka.ms/ai-agents-beginners/ai-foundry) - 需要 Azure 帳戶
|
||
|
||
本課程所用的 Microsoft AI 代理人相關框架與服務有:
|
||
|
||
- [Microsoft Agent Framework (MAF)](https://aka.ms/ai-agents-beginners/agent-framework)
|
||
- [Azure AI 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 與 Azure AI Foundry 的 Python 範例程式碼
|
||
- 延伸學習的資源連結
|
||
|
||
|
||
## 🗃️ 課程列表
|
||
|
||
| <strong>課程</strong> | <strong>文字與程式碼</strong> | <strong>影片</strong> | <strong>延伸學習</strong> |
|
||
|----------------------------------------------|----------------------------------------------------|------------------------------------------------------------|----------------------------------------------------------------------------------------|
|
||
| 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) |
|
||
| 使用 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) | |
|
||
| 探索微軟代理框架 | [連結](./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 / 代理
|
||
[](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 的重要程式碼範例。
|
||
|
||
## 貢獻
|
||
|
||
歡迎對本專案提出貢獻或建議。大多數貢獻需要您同意
|
||
貢獻者授權協議(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) 提問或反饋。
|
||
|
||
## 商標
|
||
|
||
本專案可能包含項目、產品或服務的商標或標誌。微軟商標或標誌的授權使用
|
||
須遵循並服從[微軟商標與品牌指南](https://www.microsoft.com/legal/intellectualproperty/trademarks/usage/general)。
|
||
在本專案的修改版本中使用微軟商標或標誌,不得引起混淆或暗示微軟贊助。
|
||
任何第三方商標或標誌的使用均須遵守該等第三方的政策。
|
||
|
||
## 尋求幫助
|
||
|
||
如遇到困難或有關於開發 AI 應用的問題,歡迎加入:
|
||
|
||
[](https://aka.ms/foundry/discord)
|
||
|
||
若有產品回饋或程式錯誤,請造訪:
|
||
|
||
[](https://aka.ms/foundry/forum)
|
||
|
||
---
|
||
|
||
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
|
||
**免責聲明**:
|
||
此文件已使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。雖然我們努力追求準確性,但請注意自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於關鍵資訊,建議採用專業人工翻譯。我們不對因使用此翻譯所產生的任何誤解或誤譯承擔責任。
|
||
<!-- CO-OP TRANSLATOR DISCLAIMER END --> |