tintinweb/pi-subagents

해결하는 문제

pi-subagents는 자율 하위 에이전트의 생성 및 오케스트레이션을 가능하게 하는 pi 플랫폼용 확장 기능입니다. 단일 모델 대화를 넘어 백그라운드에서 실행되거나, 병렬로 작업하거나, 결정론적 스크립트 워크플로우를 따르는 전문 에이전트를 생성함으로써 메인 에이전트의 인지 부하를 줄이고 복잡한 작업의 효율성을 향상시킵니다.

작동 방식

이 프로젝트는 부모 에이전트가 Agent 도구를 사용하여 자식 에이전트를 생성할 수 있는 시스템을 구현합니다. 이러한 하위 에이전트에는 고유한 시스템 프롬프트, 모델 및 도구 제한을 구성할 수 있습니다. 이 확장 기능은 다음과 같은 여러 오케스트레이션 방법을 제공합니다.

• 자율 생성: 에이전트는 백그라운드(비동기) 또는 포그라운드(차단)에서 실행될 수 있습니다.
• 스크립트 워크플로우: SubagentWorkflow 도구를 사용하면 parallel(), pipeline(), phase()와 같은 패턴을 사용하여 결정론적 JavaScript 스크립트로 여러 에이전트를 오케스트레이션할 수 있습니다.
• 에이전트 멘션: 사용자는 프롬프트에서 @handle 구문을 통해 에이전트와 직접 상호 작용할 수 있으며, 메인 대화에 턴을 추가하지 않고도 에이전트를 유도, 재개 또는 시작할 수 있습니다.
• 격리: 에이전트는 격리된 Git worktrees에서 실행될 수 있어 완료 시 변경 사항이 브랜치에 커밋되도록 보장합니다.

대상 사용자

복잡하고 다단계인 AI 에이전트 워크플로우를 관리해야 하는 pi 플랫폼 개발자, 특히 자율 하위 에이전트와 백그라운드 작업 관리가 포함된 "Claude Code 스타일" 경험을 원하는 개발자에게 적합합니다.

주요 특징

• Claude Code 스타일 UI: 활성 에이전트를 위한 지속적 위젯, 실행 중인 하위 에이전트를 탐색하기 위한 "FleetView", 실시간 대화 뷰어가 포함되어 있습니다.
• 병렬 실행: 구성 가능한 병렬 제한 및 스마트 그룹 알림을 지원하는 백그라운드 에이전트를 지원합니다.
• 중첩 하위 에이전트: 에이전트가 (옵트인 방식으로) 자체 자식 에이전트를 생성할 수 있도록 허용하며, 깊이 제한이 있는 위임이 가능합니다.
• 결정론적 워크플로우: Claude Code의 Workflow 도구와 호환되는 JavaScript 기반 오케스트레이션 스크립트를 지원합니다.
• 스케줄링: cron 표현식, 간격 또는 일회성 타임스탬프를 기반으로 에이전트를 실행하도록 등록할 수 있습니다.
• 확장 기능 간 RPC: 다른 pi 확장 기능이 하위 에이전트를 생성, 중지 및 참여시킬 수 있도록 하는 이벤트 버스.