# 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` 查看详细代码注释。