Initial commit: jaspersoft-agent-learn teaching project

step_01_tools/README.md

@@ -0,0 +1,82 @@
+# Step 01: 理解 Tool - 工具系统基础
+
+## 🎯 学习目标
+
+- 理解什么是 Tool（工具）
+- 理解为什么 Agent 需要 Tool
+- 学会设计一个可扩展的工具系统
+- 理解 Tool 的核心要素：name、description、execute
+
+---
+
+## 📖 概念讲解
+
+### 什么是 Tool？
+
+在 AI Agent 系统中，**Tool（工具）** 是 Agent 与外部世界交互的方式。
+
+```
+没有 Tool 的 LLM：
+┌──────────────┐
+│   用户输入    │
+└──────┬───────┘
+       │
+       ▼
+┌──────────────┐
+│     LLM       │  ← LLM 只能"想"，不能"做"
+│  (只能思考)   │
+└──────┬───────┘
+       │
+       ▼
+┌──────────────┐
+│   返回答案    │  ← 答案可能不准确，没有执行能力
+└──────────────┘
+
+有 Tool 的 Agent：
+┌──────────────┐
+│   用户输入    │
+└──────┬───────┘
+       │
+       ▼
+┌──────────────┐
+│     LLM       │
+│  (思考 + 决策) │
+└──────┬───────┘
+       │
+       ▼
+┌──────────────┐
+│  需要执行工具?  │──── 是 ──▶ 调用 Tool
+└──────┬───────┘              │
+       │                      ▼
+       │ 否              ┌──────────┐
+       ▼              │  执行 Tool │
+┌──────────────┐      │ (访问外部) │
+│   返回答案    │      └─────┬─────┘
+└──────────────┘            │
+                            ▼
+                       把执行结果反馈给 LLM
+```
+
+### 为什么需要 Tool？
+
+1. **LLM 不知道最新信息**：Tool 可以搜索网页、查数据库
+2. **LLM 不能执行操作**：Tool 可以写文件、调用 API
+3. **LLM 可能有幻觉**：Tool 可以验证信息
+4. **LLM 需要精确计算**：Tool 可以调用计算器
+
+### Tool 的核心要素
+
+每个 Tool 都有三个核心要素：
+
+```python
+class Tool:
+    name: str           # 工具名称（LLM 通过名字选择工具）
+    description: str    # 工具描述（LLM 通过描述理解何时使用）
+    execute: function   # 执行函数（实际做事的代码）
+```
+
+---
+
+## 💻 代码实现
+
+请打开 `concept.py` 查看详细代码注释。