作者分享刚上手 Pi Agent 的初步体验,称其极简且高度自由。
最近刚用 Pi,真的挺喜欢它的极简和高度自由,能让我随心搭配
由于刚上手,带着初步体验和查阅了文档
我简单整理了一下Pi Agent 到底提供了哪些最基础的功能👇
1、首先就是一个完整的 Agent 循环
调模型、执行工具、把结果交回模型,一直循环到任务完成
中途还能随时插话纠偏,或者直接打断
2、默认只开 4 个工具
read:读文件和图片
bash:执行命令
edit:精确修改文件
write:新建或覆盖文件
别看只有 4 个,其实已经够用了,grep、find、curl 这些都能直接通过 bash 去跑
3、还有 4 个内置工具,默认没开
grep、find、ls,以及 Windows 上的 PowerShell
需要的话一行命令就能打开:
pi --tools +grep,+find,+ls
也可以只开 read、grep、find、ls,变成一个只读 Agent,只看代码不改代码
4、MCP 现在是内置的
不用另外装插件,pi mcp add 加个mcp 服务器就能用
注意:Pi 本身没有联网搜索,想让它上网查资料,得自己接一个搜索类的 MCP或者其他的工具
5、支持 Skills
和 Claude Code 一样的 SKILL.md 格式,平时只把名字和描述给模型,用到了才加载全文,很省上下文
不过它默认不读 .claude/skills,需要在 ~/.pi/agent/settings.json 里加一行:
"skills": ["~/.claude/skills"]
6、能读 CLAUDE.md
会读当前目录和上层目录里的 AGENTS.md 或 CLAUDE.md
但同一个目录两个都有的话,只读 AGENTS.md
它也不读 ~/.claude/CLAUDE.md,全局说明要放到 ~/.pi/agent/ 下面
我看了下代码,CLAUDE.md 并没有单独处理,就是和 AGENTS.md 放在同一个文件名列表里,所以 Claude Code 里的 @ 引用这些也不支持
7、其他基础能力也都有
多模型随时切换
会话可以分叉回退
上下文快满了自动压缩
支持命令行、RPC、SDK 调用
⚠️ 默认没有的
子代理、计划模式、待办列表、权限确认,这些都没有内置
不过官方仓库的 examples 里都有对应的示例扩展,有兴趣的可以照着装,或者直接让 Pi 帮你写一个
所以我觉得 Pi 更像一个干净的 Agent 底座,该有的基础都有,剩下的按自己的习惯往上搭
这也是我最喜欢它的原因,模型能力越强,我觉得 Harness 也要月简洁,不需要那么多花里胡哨的功能
Pi 自己封装了这么多底层模块,它自己的 Pi Agent 产品到底用了哪几个? 我顺着依赖关系研究了一下 👇 【先看全貌】 Pi 开源仓库的 packages 里一共有 11 个包,每个都能单独被其他项目引用: · 10 个公开发布到了 npm · 1 个 pi-evals,内部评测用,不对外发布 Pi Agent 产品本身,对应的是 pi-coding-agent 这个包。 --- 【一、直接引用:5 个】 1、pi-ai:统一对接各家大模型,Anthropic、OpenAI、Google 等都靠它,还包括很多国模和第三方 2、pi-agent-core:Agent 循环、工具调用、状态管理 3、pi-tui:你在终端里看到的整个交互界面 4、pi-mcp:连接 MCP 服务器 5、pi-codemode:让模型写 JavaScript,在沙箱里并行调用工具 --- 【二、间接引用:1 个】 · pi-telemetry:遥测接口规范,定义数据格式和对接标准,本身不上报任何数据 Pi 产品本身没有直接用它,是 pi-ai 中依赖了它,所以相当于间接引用了进来。 另外,pi-ai 比较特殊:既被产品直接引用,又被 pi-agent-core 依赖。 整条依赖链: pi(pi-coding-agent) ├─ pi-agent-core → pi-ai → pi-telemetry ├─ pi-ai ├─ pi-tui ├─ pi-mcp └─ pi-codemode 官方安装器的锁文件里,pi 相关的包正好是这 6 个,加上 pi-coding-agent 本身一共 7 个,一个不多,一个不少。 --- 【三、没有引用:3 个】 · chord:支持热重载插件、状态同步和 RPC 的宿主运行时 · pi-durable:可持久化的会话、任务、文档运行时 · pi-env:通过 SSH 部署到远程机器上的执行环境,给 pi-durable 用 这三个自成一条线: pi-env 依赖 pi-durable 和 chord pi-durable 又依赖 chord、pi-ai、pi-codemode 它们和终端里的 Pi Agent 没关系,看功能是给远程执行、长时间运行这类场景准备的。 值得一提的是,chord 原本被 Pi 产品依赖过,在 1.2.0 版本被移除了,同时还删掉了一套没正式发布的实验性 server / client 插件栈。 说明 Pi 团队也在不断调整,产品只保留真正需要的部分。 --- 所以 Pi 这套架构好就好在: 需要什么就引什么 用着不顺手了,就自己重写那一块 对开发者来说,这种自由度真的很友好在 X 查看被引用的帖子
来源:AI少年 · x.com