Pi实战 04：多智能体与高级工作流篇-北京尧图网络

Pi实战 04多智能体与高级工作流篇来源Pi 作者 Mario Zechner 博客、ruizrica2 开源项目 “agent”、HN 讨论、Reddit r/PiCodingAgent、cmux 演示。Pi没有内置子代理sub-agents、没有 plan mode、没有后台 bash。官方态度很明确“Ask Pi to build what you want, or install a package that does it your way.” 但正因如此社区玩出了花。这一篇讲三件事用 bash 自举子代理作者 Mario Zechner 的做法多代理编排ruizrica2 的 28 个扩展tmux 并行会话树一、经验 1让 Pi 自己跑自己做子代理Mario Zechner 在博客里说得很直白“If you need pi to spawn itself, just ask it to run itself via bash. You could even have it spawn itself inside a tmux session for full observability.”他的典型场景是代码审查写一个自定义斜杠命令让主 Agent 通过 bash 再启动一个 Pi 进程去跑审查主进程拿到输出即可。他给出的子代理命令 frontmatter 骨架description: Run a code review sub-agent--- description: Run a code review sub-agent --- pi --print \ --provider provider \ --model model \ --tools read,grep,find,ls \ -p Review the current diff for correctness and security issues.怎么用把这个做成一个 prompt template见第 02 篇比如/review-pr。用简单提示词选具体要 review 什么、用哪个模型甚至设思考等级。可以存成临时会话ephemeral不落盘或存盘后跳进那个会话继续看。这一切最终被翻译成一个 prompt主 Agent 读完后通过 bash 再次执行自己。虽然不如原生子代理那样全 observable但足够用而且模型/工具/思考等级都能按需指定。关键点Pi 没有task工具所以多代理本质是你用 bash/tmux 把它编排出来的。这恰恰是 Pi 的哲学——能力给你怎么组你自己定。二、经验 2多代理编排——ruizrica2 的 “agent”一位开发者ruizrica2把 Pi 改造成了一个多代理系统并开源。他的原话“One turned into five, five turned into 28, and at some point the whole thing became its own project: agent.”核心做法全是扩展配置文件不 fork、不打补丁全部通过 Pi 的扩展 API 和一个settings.json加载 → 可移植、Pi 升级时好更新。Agent 定义是带 YAML frontmatter 的 Markdown 文件。加一个专家角色写一个.md文件并在配置里引用--- name: backend-reviewer model: anthropic/claude-sonnet-4-20250514 thinking: high tools: read,grep,bash mcp: github --- You review backend code for security and correctness. Focus on SQL injection, auth, and error handling.生命周期钩子持久化 UI他们 hook 进生命周期事件在需要时更新 UI让主 Agent 收到子 Agent 回复这种交互可视化。安全层他早期就加了因为不敢让 Agent 无人监督跑命令pre-tool-hook危险命令执行前拦截。content scanner检查工具返回里有没有提示词注入。session start 时加固系统提示词。一个/secure命令能审计项目并安装基础防护。“It’s not bulletproof, but it gives me peace of mind.”配套还有个叫Commander的 companion 项目充当 dashboard / Kanban / spec wizard / Jira 集成“agent” 通过 MCP 和它双向同步任务。两者独立可分开用。三、经验 3tmux 并行跑多个 Pi既然 Pi 不做后台 bash官方建议就是两个字tmux。Mario Zechner让 Pi 在 tmux session 里启动自己获得完全可观测能直接和子代理交互的能力。Reddit 有开发者晒四屏4 个 pane多代理setup还做了个 Pi package 管理这些 tmux session。更进阶的用cmux这类工具编排一个just命令一键拉起一支agent 小队每个 pane 一个 agent完成后通知你。演示里甚至同时开 Claude Code、Codex、Pi配 MiniMax 和 GLM组成安全小队扫仓库漏洞。最小可用做法不用任何编排工具# 开一个 tmux 会话里面并排放两个 Pitmux new-session-d-spi-nmainpitmux split-window-h-tpipi --model gpt-5-codextmux attach-tpi左边用便宜模型跑探索右边用强模型收尾一个屏幕看两个 agent 干活。四、经验 4会话树——对话的版本控制这是 HN 用户一致好评的功能vorticalbox“Sessions are stored as trees, that is actually really nice.”。Pi 的会话不是线性列表是一棵树底层就是按位置存的.jsonl文件每条消息 append 一行极易文档化。实战命令命令作用/tree把会话历史画成树跳到任意节点继续/fork从当前某条消息分支开一条新工作线/clone把当前活跃分支复制成一个新会话/resume捡起之前的会话继续/new开全新会话典型用法探索复杂问题时用/fork试方案 A不满意再回到分叉点/fork试方案 B——不同解法互不污染。还能rewind to any prior message, branch from there and share the entire session with others回退到任意消息、从那里分支、把整条会话分享给别人。五、实战一套计划-实现-验证流水线结合前面几篇一个可落地的多步工作流计划用一个/planprompt template让 Agent 把计划写进PLAN.mdPi 没有 plan mode就自己写文件。实现主 Agent 跑需要审查时/review-pr起一个只读子代理第一节。并行把子代理丢进 tmux pane 跑主进程继续干别的第三节。分支复盘对结果不满意/tree回到分叉点重来不丢上下文第四节。安全全程有 permission-gate 拦危险命令第 03 篇。社区现成的包能直接给你这套流水线比如pi-dynamic-workflow灵感来自 Claude Code 的 dynamic workflows、TrailStep把过程编码成 TS 工作流每步有独立 scoped agent session失败可续跑。六、小结Pi 没有原生子代理 → 用bash 自举或tmux 并行自己编排。多代理一堆扩展 settings.json Markdown 定义的专家角色。安全层要自己加pre-tool-hook 拦命令、content scanner 防注入、/secure审计。会话树是 Pi 的隐藏神器把对话变成可分支、可回退、可分享的版本历史。参考资料Hacker News 讨论《Pi – A minimal terminal coding harness》https://news.ycombinator.com/item?id47143754Ricardo Ruizruizrica2《How I Turned Pi Into a Multi-Agent Coding Assistant》https://medium.com/ruizrica2/how-i-turned-pi-into-a-multi-agent-coding-assistant-cb1c2f1c8145jasonzhou1993《Pi agent 101 — How to extend and build your own harness》https://x.com/jasonzhou1993/article/2074471761715077153Reddit r/PiCodingAgenthttps://www.reddit.com/r/PiCodingAgent/Pi 官方pi-multiagent/pi-crew包https://pi.dev/packages/pi-multiagent https://pi.dev/packages/pi-crew上一篇03 · 扩展篇下一篇05 · 本地模型 · MCP · 安全沙箱篇

Pi实战 04：多智能体与高级工作流篇

相关推荐

从零搭建AI工程：提示词、Agent与RAG实战指南

2026本地部署大模型完全指南：工具选型、量化部署与生产加固

开源模型一键部署成 OpenAI 兼容 API：四种推理引擎路线

更多资讯

YOLOv7打电话检测实战：从数据集构建到模型训练与部署

C语言单链表全面解析：从原理到插入删除逆序的完整实现

Kafka与MongoDB协作架构：从数据采集到文档落库的实战指南

UE到Unity资产迁移插件实战：跨引擎资源搬运的自动化转换逻辑

ai软件开发公司怎么选？看这3个维度不踩坑

G120变频器DDS驱动数据组配置与切换实战指南

今日更新

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

本周精选

如何彻底离线使用 Laya-CoreML：Hugging Face 下载、缓存机制与 local_files_only 详解

基于1Panel 部署MySQL MCP 服务：TaoToken 统一 Key 接入与 config.toml 配置实战

崇州园区营销网站建设避坑指南：5大注意事项保备案安全

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？