# 第一幕：认识你的 AI 研究助手 🤖

![lab1](../../imgs/lab1.png)

## 挑战

你正在推出「未来字节」，你的新科技播客。第一集是关于最新的 AI 突破，但你只有 24 小时来：
1. 研究主题
2. 找到可信来源
3. 写一个引人入胜的脚本
4. 让它听起来自然

**剧情转折**：你不必独自完成。你即将构建你的第一个 AI 助手，它可以帮助完成所有这些。让我们叫它 Alex —— 你永不疲倦的研究伙伴，永远不需要睡觉。

## 为什么选择小型语言模型？（剧透：它们很棒）

把小型语言模型（SLM）想象成运行在*你的*计算机上的个人 AI。没有云，没有月费，没有可疑的数据共享。

**为什么 SLM 这么🔥：**
- **🏠 在你的机器上运行**：笔记本电脑、台式机，甚至是性能强劲的树莓派
- **💸 零持续成本**：没有 API 费用吃掉你的零花钱
- **🔒 隐私优先**：你的数据永远不会离开你的设备
- **⚡ 闪电般快速**：没有网络延迟，即时响应
- **🪦 轻量级**：10 亿-100 亿参数 vs 大模型的 1000 亿+

**流行的 SLM**：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 个任务

### 任务 1:创建你的第一个智能体

📓 [打开 Notebook](../../code/01.BasicAgent/00.BasicAgent-agent.ipynb)

**任务**:构建 Alex,你的播客脚本编写 AI。Alex 需要生成两个主持人讨论科技话题的对话。

**你将学到:**
- 如何唤醒 AI 智能体(比周一起床容易)
- 给它个性和指令
- 让它生成真实的播客脚本
- 理解它回复给你的内容

**胜利条件**：Alex 为你的「未来字节」关于 AI 的试播集创建脚本！🎯

### 任务 2：给 Alex 超能力（工具！）

📓 [打开 Notebook](../../code/01.BasicAgent/01.BasicAgent-tools.ipynb)

**任务**：Alex 很聪明，但它不知道今天的天气或现在几点。让我们通过给它工具来解决这个问题！

**你将学到：**
- 创建自定义 Python 函数作为"工具"
- 让 Alex 自己决定*何时*使用哪个工具
- 观察它自主解决问题
- 组合多个工具完成复杂任务

**胜利条件**：问"东京的天气怎么样？"Alex 会自己找出答案！☁️

### 任务 3：教 Alex 思考

📓 [打开 Notebook](../../code/01.BasicAgent/02.BasicAgent-reasoning.ipynb)

**任务**：让 Alex 展示它的工作过程。在解决问题时，你想看到它*如何*思考，而不仅仅是答案。

**你将学到：**
- 激活"推理模式"（就像数学课上展示你的工作）
- 看到 Alex 的逐步思考过程
- 理解思维链提示
- 当 Alex 困惑时进行调试

**胜利条件**：问一个棘手的数学问题，看 Alex 思考它！🧠

### 任务 4：将 Alex 连接到互联网

📓 [打开 Notebook](../../code/01.BasicAgent/03.BasicAgent-websearch.ipynb)

**任务**：Alex 的知识有截止日期。让我们将它连接到网络以获取实时信息！

**你将学到：**
- 构建自定义网络搜索工具
- 集成外部 API
- 优雅地处理网络错误
- 获取超出 Alex 训练数据的信息

**胜利条件**：询问今天的科技新闻并获得最新结果！📰

## 开始之前 🚀

**必需装备**：
- 已安装 Python 3.10+
- Ollama 正在运行（使用 `ollama --version` 检查）
- 带有 Python 扩展的 VS Code
- 至少 8GB 内存（如果你想要流畅体验，需要 16GB）

## 任务顺序

按顺序完成 notebook 以获得完整体验：

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 内存是最低要求。

### "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)

---

**卡住了？** 在工作坊期间提问。我们一起学习！🙌