学习目标
今天做点有用的吧！
- 做一个有趣的英语单词学习 Agent（搞定！✅）
- 在实际应用中理解参数调优（搞定！✅）
- 学习 temperature、max_tokens 的实际用途（搞定！✅）
一、项目介绍：英语单词学习 Agent
功能设计
| 功能 | 描述 | 用到的参数 |
|---|---|---|
| 今日单词 | 学习新单词，AI 讲解 | temperature=0.3（准确讲解） |
| 单词测验 | 看中文猜英文 | temperature=0.5（鼓励准确） |
| 造句练习 | 用单词造句，AI 检查 | temperature=0.5（平衡纠正） |
| 单词故事 | 用单词编有趣故事 | temperature=1.2（创意有趣） |
| 参数调节 | 演示参数效果 | 对比不同温度 |
为什么这样设计参数？
讲解单词 → temperature 低 → 解释准确，不乱说
编故事 → temperature 高 → 故事有趣，有创意
二、参数在 Agent 中的应用
2.1 讲解单词（temperature=0.3）
# 低温度，确保讲解准确
prompt = f"请讲解单词 '{word}'，加一个记忆技巧，不超过50字。"
call_ai(prompt, temperature=0.3, max_tokens=100)
效果：AI 会给出标准、准确的解释，适合教学场景。
2.2 编故事（temperature=1.2）
# 高温度，让故事有创意
prompt = f"请用这几个单词编一个有趣的故事..."
call_ai(prompt, temperature=1.2, max_tokens=500)
效果：AI 会编出意想不到的有趣情节，吸引小朋友。
2.3 参数对比演示
在「参数调节」功能中，同一个单词用不同温度讲解：
【temperature = 0.1】
"cat 是猫，一种常见的宠物动物。"
【temperature = 0.7】
"cat 是可爱的小猫咪，它会喵喵叫，喜欢抓老鼠！"
【temperature = 1.2】
"cat 是一只神秘的小猫咪，它有漂亮的胡须，还会偷偷溜出去冒险呢！"
三、代码结构解析
3.1 单词库设计
vocabulary.py 存放三年级下册单词：
WORDS = {
"unit1": {
"cat": {"cn": "猫", "phonetic": "kæt", "example": "I have a cat."},
"dog": {"cn": "狗", "phonetic": "dɒg", "example": "The dog is cute."},
...
},
"unit2": {...},
...
}
3.2 API 调用封装
def call_ai(prompt, temperature=0.7, max_tokens=500):
"""调用 AI，可指定参数"""
data = {
"model": "glm-5",
"messages": [{"role": "user", "content": prompt}],
"temperature": temperature, # 可调节
"max_tokens": max_tokens, # 可调节
"stream": True
}
...
封装成函数后，不同功能可以传不同参数。
3.3 各功能的参数选择
| 功能 | temperature | max_tokens | 原因 |
|---|---|---|---|
| 讲解单词 | 0.3 | 100 | 准确简短 |
| 测验反馈 | 0.5-0.7 | 50 | 自然鼓励 |
| 造句检查 | 0.5 | 150 | 温和纠正 |
| 编故事 | 1.2 | 500 | 创意长文 |
四、运行体验
不错不错，还挺有意思！
python week1/04_english_agent.py
学习流程
- 选择「今日单词」→ 学习 3 个新单词
- 选择「单词测验」→ 看中文猜英文
- 选择「造句练习」→ 用单词造句，AI 帮你检查
- 选择「单词故事」→ AI 编有趣的故事
- 选择「参数调节」→ 看看不同参数的效果对比
五、参数调优总结
temperature 选择原则
| 场景 | temperature | 原因 |
|---|---|---|
| 教学、讲解 | 0.1-0.3 | 要准确，不能胡说 |
| 对话、反馈 | 0.5-0.7 | 自然，像真人聊天 |
| 创意、故事 | 1.0-1.5 | 要新奇，吸引人 |
max_tokens 选择原则
| 场景 | max_tokens |
|---|---|
| 简短回复 | 50-100 |
| 中等长度 | 100-300 |
| 长文章 | 500+ |
六、今日收获
✅ 做了一个实用的英语学习 Agent
✅ 理解了不同场景用不同参数
✅ 学会了封装 API 调用函数
调参口诀：
- 教学要准，temperature 低
- 故事要趣，temperature 高
- 回复长短，max_tokens 控制
明天干嘛：学了那么多，总结下吧
记于 2026-04-07，AI 学习第四天，参数调优实战搞定！
