Pi Agent 工具架构设计：三层类型 + 五步管道 + 并行调度 + 错误处理
在 Pi Agent 的工具系统中，工具的抽象和执行机制是整个架构的核心。本文系统梳理工具定义的三层类型、调用时的五步管道、并行执行策略，以及错误处理的特殊设计。
一、三层类型：为什么”一个工具”要分三层来定义？
在 Pi Agent 里，一个完整的工具定义被拆成了三层，目的是让不同层职责清晰、扩展性强：
第一层：Tool（一张”名片”）
这是最基础的一层，只定义工具的基本信息：
tool...
Pi Agent 工具架构设计：Operations 抽象与 Workspace 切换
在 Pi Agent 的工具系统中，Operations 抽象 是核心设计之一。它把工具的执行逻辑与具体文件系统实现解耦，让 Agent 可以在本地、SSH、Docker 等不同环境中灵活切换。
本文主要分享工具架构的核心设计思路，包括抽象接口、依赖注入、闭包固定实例，以及 Workspace 切换机制。
为什么不直接使用 Node.js fs？
很多人第一反应是直接调用 fs/promis...