nicobailon/pi-intercom

해결하는 문제

Pi-intercom은 동일한 머신에서 실행 중인 여러 활성 AI 세션 간에 직접적인 1:1 통신을 가능하게 합니다. 예를 들어 연구용, 실행용, 검토용 세션을 병렬로 운영할 때 발생하는 컨텍스트 분산 문제를 해결하여, 사용자와 에이전트가 정보를 수동으로 복사-붙여넣기 하지 않고도 발견 공유, 결정 요청, 작업 조율이 가능하게 합니다.

작동 방식

각 활성 세션은 IPC 전송을 통해 로컬 브로커에 연결됩니다. 브로커는 연결된 세션을 추적하고 세션 이름 또는 ID 기반으로 메시지를 라우팅합니다.

• 사용자용: Alt+M 또는 /intercom로 접근 가능한 오버레이 UI를 통해 대상 세션을 선택하고 메시지를 작성할 수 있습니다.
• 에이전트용: 전용 intercom 도구를 통해 활성 세션 목록을 확인하고, 비차단 메시지(send)를 전송하거나, 응답을 받을 때까지 에이전트의 턴을 일시 정지하는 차단 요청(ask)을 보낼 수 있습니다.
• 서브에이전트 통합: pi-subagents와 함께 사용 시, 자식 에이전트는 감독자에게 의사결정을 요청하거나 구조화된 인터뷰를 요청하거나 진행 상황을 보고할 수 있는 특화된 contact_supervisor 도구를 받게 됩니다.

대상 사용자

복잡한 다단계 워크플로우를 처리하거나, 단일 머신에서 전문적인 에이전트 팀을 오케스트레이션하기 위해 여러 동시 AI 세션을 운영하는 Pi 생태계의 개발자 및 고급 사용자.

주요 특징

• 차단 vs 비차단: send로 알림을 전송하고, ask로 동기 요청을 수행하여 응답을 도구 결과로 반환.
• 세션 인식: 에이전트는 모든 활성 세션을 목록화하거나 동일한 디렉터리에서 작업 중인 피어를 필터링할 수 있음.
• 서브에이전트 에스컬레이션: need_decision 또는 interview_request와 같은 특정 이유로 자식 에이전트가 감독자와 소통할 수 있는 전용 도구 제공.
• 문맥 기반 응답: 수신 메시지에는 응답에 필요한 정확한 도구 호출이 포함된 "응답 힌트"가 포함되어 에이전트의 워크플로우를 간소화.
• 로컬 브로커 아키텍처: 경량 로컬 브로커를 사용하여 라우팅을 관리하고, 일시적으로 연결이 끊긴 이름付き 세션을 위한 제한된 메모리 내 메일박스 제공.