第 4 章 · 实验教程：工具
文档摘要
第 4 章 · 实验教程：工具 本章对应正文：第 4 章 · 工具 核心命题：工具是 Agent 的双手——MCP 协议统一工具接口，感知/执行/协作三类工具覆盖能力边界，事件驱动让 Agent 真正异步起来。 没有工具的 Agent 只能"说"，有了工具才能"做"。这一章把工具体系拆成三类——感知（看/听/读）、执行（写/跑/调用）、协作（人机协同/通知/定时），并用 MCP 协议把它们标准化。更进一步，工具数量多了之后，Agent 还要学会主动发现和选择工具，而不是被动接受一堆 schema；执行长任务时还要能异步并行、可打断、可恢复。 本章 7 个实验先从三组 MCP 工具服务器搭起能力底座，再在它们之上构建事件驱动 Agent 与异步框架。
第 4 章 · 实验教程：工具
本章对应正文：第 4 章 · 工具
核心命题：工具是 Agent 的双手——MCP 协议统一工具接口，感知/执行/协作三类工具覆盖能力边界，事件驱动让 Agent 真正异步起来。
没有工具的 Agent 只能"说"，有了工具才能"做"。这一章把工具体系拆成三类——感知（看/听/读）、执行（写/跑/调用）、协作（人机协同/通知/定时），并用 MCP 协议把它们标准化。更进一步，工具数量多了之后，Agent 还要学会主动发现和选择工具，而不是被动接受一堆 schema；执行长任务时还要能异步并行、可打断、可恢复。
本章 7 个实验先从三组 MCP 工具服务器搭起能力底座，再在它们之上构建事件驱动 Agent 与异步框架。多数实验无需 API Key 即可起步，建议先跑 perception-tools 感受"Agent 有了眼睛和耳朵"，再深入 active-tool-discovery 和 async-agent 这两个进阶挑战。
实验列表
| 实验 | 类型 | 难度 | 说明 |
|---|---|---|---|
| perception-tools | ✅ | ★ | 感知工具 MCP：网络搜索、多模态理解、文件系统、公共数据源（DuckDuckGo/Open-Meteo 等），大多无需 API Key |
| execution-tools | ✅ | ★★ | 执行工具 MCP：文件操作、代码解释器、虚拟终端，LLM 二次审批防误操作 |
| collaboration-tools | ✅ | ★★ | 协作工具 MCP：浏览器自动化、HITL、Email/Telegram/Slack 通知、定时器，支持管理员审批 |
| agent-with-event-trigger | ✅ | ★★ | FastAPI 事件驱动 Agent，原生异步集成 42 个 MCP 工具，通过 HTTP API 接收 Web/IM/GitHub/定时器事件 |
| active-tool-selection | ✅ | ★★ | 受 MCP-Zero 启发，让 Agent 识别能力缺口、按需主动请求工具，而非被动接受预定义工具集 |
| active-tool-discovery | ✅ | ★★★ | 在 126 个工具上对比全量注入、检索预筛选、discover_tools 主动发现三种策略的 token 与准确率 |
| async-agent | ✅ | ★★★ | asyncio 事件驱动框架 Flux：并行工具执行、事件队列分派、运行中打断、长任务取消与状态查询 |
类型与难度说明
| 标记 | 含义 |
|---|---|
| ✅ | 可独立运行：自带完整代码，配好 API Key 即可跑 |
| 📖 | 复现指南：依赖需自行 git clone 的外部仓库 |
| 🚧 | 设计文档：仅含架构方案，可运行代码仍在完善 |
| ★ ~ ★★★ | 从易到难，★ 为入门级、★★★ 为进阶挑战 |
阅读建议
- 入门读者：从 perception-tools 开始，无需 API Key 就能体验"Agent 有了感知能力"；再看 execution-tools 了解 LLM 审批如何防止误操作。
- 想搭完整 Agent：agent-with-event-trigger 把三组 MCP 工具集成进事件驱动 Agent，是理解"工具如何被调度"的最佳示范。
- 进阶挑战：active-tool-discovery 回答"工具太多怎么办"，async-agent 回答"长任务如何并行与打断"，两个 ★★★ 实验展示了工具工程的深水区。
← 返回总目录 · 📖 读本章正文 · 📑 本章索引