zy187
83 lines
2.5 KiB
Markdown
83 lines
2.5 KiB
Markdown
# 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` 查看详细代码注释。
|