zy187
55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
# Step 02: 理解 State - 状态管理
|
||
|
||
## 🎯 学习目标
|
||
|
||
- 理解什么是 Agent State（代理状态）
|
||
- 理解为什么 Agent 需要状态
|
||
- 学会设计合理的状态结构
|
||
- 理解状态在多步骤任务中的作用
|
||
|
||
---
|
||
|
||
## 📖 概念讲解
|
||
|
||
### 什么是 State？
|
||
|
||
State（状态）是 Agent 的"记忆"——它记录了：
|
||
|
||
1. **当前任务进展**：完成了多少，还剩多少
|
||
2. **历史数据**：用户说过什么，生成过什么
|
||
3. **中间结果**：每个步骤的输出是什么
|
||
4. **工具调用结果**：工具返回了什么
|
||
|
||
```
|
||
没有 State 的 Agent：
|
||
用户: "生成报表"
|
||
Agent: 生成报表
|
||
用户: "把标题改成黑色"
|
||
Agent: ??? 我不记得你刚才生成的是什么报表
|
||
|
||
有 State 的 Agent：
|
||
用户: "生成报表"
|
||
Agent: 生成报表，记录到 state
|
||
state = {current_jrxml: "..."}
|
||
|
||
用户: "把标题改成黑色"
|
||
Agent: 从 state 读取 current_jrxml
|
||
修改标题
|
||
更新 state = {current_jrxml: "新报表"}
|
||
```
|
||
|
||
### 为什么需要精心设计 State？
|
||
|
||
一个好的 State 设计应该：
|
||
|
||
1. **包含所有必要信息**：不遗漏关键数据
|
||
2. **避免信息冗余**：不要重复存储相同数据
|
||
3. **结构清晰**：易于读取和更新
|
||
4. **类型安全**：有类型提示，减少 bug
|
||
|
||
---
|
||
|
||
## 💻 代码实现
|
||
|
||
请打开 `concept.py` 查看详细代码注释。
|