内置工具与自定义工具
先盯住一个动作
Pi 默认工具面很小:读取、编辑、写入、内容搜索(grep)、文件查找(find)、列目录和执行 shell;Extension 可以新增工具或按同名替换内置工具。
沿执行轨迹走
默认工具清单
CLI 文档列出的内置工具为
read、bash(Windows 为powershell)、edit、write、grep、find、ls,并允许用 allowlist、exclude 或 no-tools 控制暴露范围。[repo] [docs]
扩展接入点
Extension 可注册带参数 schema、执行函数和自定义渲染的工具;也能注册同名工具覆盖默认实现,例如把文件与 shell 操作转发到远端或微虚拟机。
[repo]
执行策略属于工具契约
Agent 支持 parallel 与 sequential 两种批次策略,并提供 before/after tool call 钩子用于阻止或改写结果。
[repo]
每一步改变了什么
最小权限应从“本轮只暴露哪些工具”开始,再由宿主沙箱限制工具即使被调用也能触及的资源。
替换内置工具时要核对所有已暴露入口,包括默认工具与 Extension 注册工具;只替换其中一个名字并不能形成完整隔离边界。
这条轨迹没有说明什么
工具 allowlist 只决定模型能看到哪些能力;文件、进程、网络和凭据的运行时边界见“默认没有沙箱”。
来源与核验
- [repo] Pi 官方源码(固定 revision)
- [docs] Pi 官方文档
Revision:853a80d26c90a14c1886f0ebb8ffaae133ca2185 · 核验日期:2026-08-31