nicobailon/pi-intercom

Pi Intercom – 개요

설명 – Pi AI 에이전트 플랫폼을 위한 경량 확장 프로그램으로, 동일한 컴퓨터에서 실행되는 개별 Pi 세션들이 1대1로 대화할 수 있게 해줍니다. 작은 UI(Alt + M 또는 /intercom 명령어)와 프로그래밍 가능한 도구(intercom)를 추가하여, 사용자나 자율 에이전트가 세션 목록 확인, 메시지 전송, 질문(응답 시까지 차단), 응답, 작업 전달 또는 메시지 취소를 수행할 수 있습니다.

중요성 – 복잡한 작업을 여러 Pi 에이전트(예: 플래너와 워커, 또는 하위 에이전트와 관리자)로 분할할 때, 컨텍스트를 전달하거나 명확한 설명을 요청하거나 세션 상태를 넘겨줄 신뢰할 수 있는 방법이 필요합니다. Pi-intercom은 로컬 머신을 벗어나거나 외부 채팅 서비스에 의존하지 않고 이를 제공하며, 통신을 빠르고 비공개로 유지하면서 Pi의 턴 기반 실행 모델과 긴밀하게 통합됩니다.

주요 기능

• 로컬 브로커 – 각 세션은 세션 ID와 별칭을 추적하고 메시지를 직접 라우팅하는 소형 IPC 브로커에 연결됩니다.
• 별칭 및 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 에이전트 세션 간의 머신 내 1대1 메시징을 위한 집중적이고 오버헤드가 적은 솔루션으로, Pi 생태계를 벗어나지 않고도 더 풍부한 멀티 에이전트 오케스트레이션을 가능하게 합니다.