# 第一幕：認識你的 AI 研究助理 🤖

![lab1](../../../../translated_images/zh-TW/lab1.1dd5210a7d114e2e.webp)

## 挑戰

你正在啟動「未來元件」，你的新科技播客。第一集主題是最新的 AI 突破，但你只有 24 小時來：
1. 研究主題
2. 找到可信的資訊來源
3. 撰寫引人入勝的腳本
4. 讓它聽起來自然流暢

**劇情轉折**：你不必獨自完成這些任務。你即將建造你的第一個 AI 助理，可以幫助你完成所有這些工作。讓我們稱他為 Alex —— 你不需睡眠的勤奮研究夥伴。

## 為什麼選擇小型語言模型？（劇透：它們超讚）

把小型語言模型（SLMs）想像成住在*你*電腦裡的個人 AI。沒有雲端、沒有每月費用、沒有可疑的資料共享。

**SLMs 的優點：**
- **🏠 在你本機運行**：筆電、桌機，甚至是性能不錯的 Raspberry Pi
- **💸 無持續成本**：不用擔心 API 費用吃掉你的午餐錢
- **🔒 隱私至上**：你的資料絕不會離開你的設備
- **⚡ 速度極快**：沒有網路延遲，即時回應
- **🪦 輕量級**：1B-10B 參數，對比大模型的 100B 以上

**熱門 SLMs**：Qwen 3、Phi-4、Gemma 3（本工作坊使用的是 Qwen）

## 你的工具箱

### Ollama：你的 AI 模型管理器

[Ollama](https://ollama.com/) 就像 AI 模型界的 Steam。用簡單指令下載、執行及管理模型。

**特色：**
- 一條指令即可下載並執行任意模型
- 支援 Mac、Windows、Linux
- 有 GPU 的話會自動使用
- 超級節省記憶體

### Microsoft Agent Framework：魔法發生的地方

[Microsoft Agent Framework](https://github.com/microsoft/agent-framework) 是你打造 AI 代理的遊樂場，他們可以：

- 💬 聊天且記得你們的對話內容
- 🛠️ 使用自訂工具（像是網路搜尋或查天氣）
- 🧠 一步步思考複雜問題
- 🤝 與其他代理合作組隊
- 🔌 連接不同 AI 供應商（OpenAI、Ollama、Azure）

**構建基石：**
- **Agents**：有特定任務的 AI 助理
- **Tools**：你賦予的特殊能力
- **Memory**：讓它們不忘對話內容
- **Reasoning**：教它們不只是回應，還能思考

## 你的訓練場景：4 個任務

### 任務一：創建你的第一個代理

📓 [開啟筆記本](../code/01.BasicAgent/00.BasicAgent-agent.ipynb)

**任務目標**：建立 Alex，你的播客腳本撰寫 AI。Alex 需要生成兩位主持人討論科技議題的對話。

**你將學習：**
- 如何喚醒 AI 代理（比週一早晨起床容易多了）
- 賦予它性格和指令
- 讓它生成真正的播客腳本
- 理解它的回覆內容

**勝利條件**：Alex 為你的「未來元件」試播集寫出 AI 主題腳本！🎯

### 任務二：賦予 Alex 超能力（工具！）

📓 [開啟筆記本](../code/01.BasicAgent/01.BasicAgent-tools.ipynb)

**任務目標**：Alex 很聰明，但不知道今天天氣和現在時間。讓我們透過工具補強！

**你將學習：**
- 創建自訂 Python 函數作為「工具」
- 讓 Alex 決定 *何時* 使用哪個工具
- 觀看它自主解決問題
- 組合多種工具完成複雜任務

**勝利條件**：問「東京今天天氣怎樣？」Alex 能自己查出答案！☁️

### 任務三：教 Alex 思考

📓 [開啟筆記本](../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb)

**任務目標**：讓 Alex 展示它的思考過程。當解決問題時，你想看到它*怎麼想*，而不只是結果。

**你將學習：**
- 啟動「推理模式」（就像數學課展示解題過程）
- 看到 Alex 的逐步思考
- 理解鏈式思考提示法
- 調試當 Alex 感到困惑的時候

**勝利條件**：問一道複雜數學題，看 Alex 思考解決！🧠

### 任務四：讓 Alex 上網查資料

📓 [開啟筆記本](../code/01.BasicAgent/03.BasicAgent-websearch.ipynb)

**任務目標**：Alex 的知識有截止日期。讓它連上網路，取得即時資訊！

**你將學習：**
- 建立自訂網路搜尋工具
- 整合外部 API
- 優雅處理網路錯誤
- 得到超越 Alex 訓練資料的資訊

**勝利條件**：問今天的科技新聞，馬上拿到最新結果！📰

## 開始之前 🚀

**必備裝備**：
- 安裝 Python 3.10+
- Ollama 運行中（用 `ollama --version` 檢查）
- VS Code 安裝 Python 擴充
- 至少 8GB 記憶體（想要順暢就 16GB）

## 任務執行順序

按筆記本順序進行，體驗完整故事：

1. [00.BasicAgent-agent.ipynb](../code/01.BasicAgent/00.BasicAgent-agent.ipynb) — 認識 Alex（你的第一個代理）
2. [01.BasicAgent-tools.ipynb](../code/01.BasicAgent/01.BasicAgent-tools.ipynb) — 加強武裝！
3. [02.BasicAgent-reasoning.ipynb](../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb) — 教 Alex 思考
4. [03.BasicAgent-websearch.ipynb](../code/01.BasicAgent/03.BasicAgent-websearch.ipynb) — 上網時間到！

## 你將掌握的技能

完成第一幕後，你能夠：

- ✅ 在自己硬體上運行 AI 模型（不依賴雲端！）
- ✅ 建立具備個性和技能的代理
- ✅ 給代理工具，用來解決實際問題
- ✅ 讓代理展示其推理過程
- ✅ 連接代理到外部數據來源
- ✅ 出錯時如何調試

## 出問題了該怎麼辦 🔧

### 「Alex 無法啟動！記憶體不足！」
**解決辦法**：電腦負擔過重。試著關閉其他應用，或換用較小的模型。8GB RAM 是最低標準。

### 「Alex 好慢」
**解決辦法**：在 Ollama 設定中啟用 GPU 加速。或縮小上下文視窗大小。超速模式啟動！🏎️

### 「工具沒反應！」
**解決辦法**：確認你的函數簽名。Alex 需要正確的型別提示才能理解工具功能，就像給它清楚的指令。

## 有用的連結 🔗

- [Agent Framework 文件](https://github.com/microsoft/agent-framework) — 官方指南和範例
- [Ollama 模型庫](https://ollama.com/library) — 瀏覽所有可用模型
- [Qwen 模型](https://ollama.com/library/qwen3) — 認識你的 AI 大腦
- [程式碼範例](https://github.com/microsoft/agent-framework/tree/main/python/samples) — 偷師學藝

## 下一篇：第二幕 🎬

你已有一位代理。但如果有一個*團隊*的代理一起合作呢？第二幕，你將打造完整播客製作團隊：
- **研究員代理**：搜尋最佳資訊來源
- **撰稿人代理**：撰寫完美腳本  
- **編輯（你！）**：審核或要求修改

來一起編排 AI 魔法吧！→ [第二幕：組建你的製作團隊](02.AIAgentOrchestrationAndWorkflows.md)

---

**卡住了？** 隨時在工作坊提問。我們一起學習！🙌

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**免責聲明**：  
本文件由 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 翻譯而成。雖然我們致力於確保準確性，但請注意自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應被視為權威來源。對於重要資訊，建議採用專業人工翻譯。因使用本翻譯所造成的任何誤解或誤釋，我們概不負責。
<!-- CO-OP TRANSLATOR DISCLAIMER END -->