AI 简明手册
Pi 源码解读 · 模型与工具内置工具与自定义工具

内置工具与自定义工具

先盯住一个动作

Pi 默认工具面很小:读取、编辑、写入、内容搜索(grep)、文件查找(find)、列目录和执行 shell;Extension 可以新增工具或按同名替换内置工具。

沿执行轨迹走

  1. 默认工具清单

    CLI 文档列出的内置工具为 read、bash(Windows 为 powershell)、edit、write、grep、find、ls,并允许用 allowlist、exclude 或 no-tools 控制暴露范围。

    [repo] [docs]

  2. 扩展接入点

    Extension 可注册带参数 schema、执行函数和自定义渲染的工具;也能注册同名工具覆盖默认实现,例如把文件与 shell 操作转发到远端或微虚拟机。

    [repo]

  3. 执行策略属于工具契约

    Agent 支持 parallel 与 sequential 两种批次策略,并提供 before/after tool call 钩子用于阻止或改写结果。

    [repo]

每一步改变了什么

  • 最小权限应从“本轮只暴露哪些工具”开始,再由宿主沙箱限制工具即使被调用也能触及的资源。

  • 替换内置工具时要核对所有已暴露入口,包括默认工具与 Extension 注册工具;只替换其中一个名字并不能形成完整隔离边界。

这条轨迹没有说明什么

  • 工具 allowlist 只决定模型能看到哪些能力;文件、进程、网络和凭据的运行时边界见“默认没有沙箱”。

来源与核验

  1. [repo] Pi 官方源码(固定 revision)
  2. [docs] Pi 官方文档

Revision:853a80d26c90a14c1886f0ebb8ffaae133ca2185 · 核验日期:2026-08-31