nicobailon/pi-intercom

Pi Intercom – 概览

它是什么 – 一个用于 Pi AI 代理平台的轻量级扩展，允许在同一台计算机上运行的独立 Pi 会话进行一对一的对话。它添加了一个小型 UI (Alt + M 或 /intercom 命令) 和一个可编程工具 (intercom)，以便用户或自主代理可以列出会话、发送消息、提出问题（阻塞直到回复）、回复、移交工作或取消消息。

为什么它很重要 – 当你将复杂任务拆分到多个 Pi 代理（例如，规划者和执行者，或子代理及其主管）时，你需要一种可靠的方式来传递上下文、请求澄清或移交会话状态。Pi-intercom 提供了这种能力，无需离开本地机器或依赖外部聊天服务，保持了通信的快速、私密，并与 Pi 的基于轮次的执行模型紧密集成。

主要功能

• 本地代理 – 每个会话连接到一个微型 IPC 代理，该代理跟踪会话 ID、别名并直接路由消息。
• 别名与 ID – 会话可以命名 (/alias <name>) 或获得防冲突的后备别名，使定位变得容易。
• 工具操作 – list, list-cwd, send, ask, reply, handover, cancel, status 等，均可从 Pi 脚本调用。
• 内联渲染 – 传入的消息出现在转录中，可以触发立即轮次，并作为扩展条目存储。
• 阻塞式询问 – ask 会阻塞发送者（默认 10 分钟超时）直到接收者回复，从而实现真正的来回交互而不丢失上下文。
• 安全控制 – inboundTrigger, busyDelivery, confirmSend 和超时设置允许你控制消息何时中断正在运行的轮次。
• 离线邮箱 – 短期会话在重新连接后仍可接收回复；未命名的会话仅获得运行时别名。
• 与 pi-subagents 集成 – 子代理获得一个 contact_supervisor 工具，用于仅限主管的升级。

典型工作流

1. 启动两个 Pi 终端 并给它们分配别名，例如 planner 和 worker。
2. 规划者 send 任务描述给执行者。
3. 执行者 ask 请求澄清；规划者的回复被注入回同一轮次。
4. 执行者通过另一个 ask 报告完成情况；规划者可以发布下一个任务。

安装

pi install npm:pi-intercom   # registers the extension and skill
# restart Pi to auto-connect to the broker

在 AGENTS.md 中添加简短描述（如 README 所示），以帮助其他代理知道何时使用该工具。

使用场景

• 在同一代码库上协调多个代理。
• 将工作从高级规划者委派给专业执行者。
• 将子代理的问题升级给其主管。
• 将会话移交给另一个 Pi 进程（例如，从本地运行移动到远程适配器）。

不需要的情况

• 简单的单会话工作。
• 跨机器通信（Pi-intercom 仅限本地；请为此使用其他网络工具）。

总而言之，Pi-intercom 是一个专注、低开销的解决方案，用于 Pi AI 代理会话之间的机器内一对一消息传递，无需离开 Pi 生态系统即可实现更丰富的多代理编排。