Initial commit: jaspersoft-agent-learn teaching project

2026-05-29 23:22:18 +08:00
commit 05bb511aab
20 changed files with 4476 additions and 0 deletions
@@ -0,0 +1,54 @@
+# 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` 查看详细代码注释。