tintinweb/pi-subagents

해결하는 문제

pi-subagents는 pi 플랫폼용 확장 기능으로, 자율적인 하위 에이전트의 생성과 오케스트레이션을 가능하게 합니다. 사용자는 전용 도구, 시스템 프롬프트, 모델을 갖춘 전문 에이전트를 생성하여 복잡한 작업을 백그라운드 또는 병렬로 처리함으로써 단일 메인 에이전트의 인지 부담을 줄일 수 있습니다.

작동 방식

이 확장 기능은 메인 모델이 하위 에이전트를 생성할 수 있는 Agent 도구를 도입합니다. 이러한 에이전트는 고립된 세션에서 실행되며, 기본적으로 백그라운드에서 실행되거나 메인 세션을 차단할 수도 있습니다. 사용자는 마크다운 파일의 YAML 프론트마터를 통해 사용자 정의 에이전트 유형을 정의하고, 시스템 프롬프트, 모델 선택, 도구 제한을 지정할 수 있습니다.

핵심 오케스트레이션 메커니즘은 다음과 같습니다:

• 스크립트 기반 워크플로우: SubagentWorkflow 도구는 parallel(), pipeline(), phase()와 같은 패턴을 사용하여 결정론적인 자바스크립트 스크립트를 실행하여 에이전트를 관리합니다.
• 에이전트 언급: 프롬프트에서 @handle 구문을 사용하여 메인 대화의 턴을 소비하지 않고 에이전트와 통신하거나 재개, 시작할 수 있습니다.
• FleetView: 에디터 아래에 있는 탐색 가능한 UI 목록을 통해 실시간으로 실행 중인 에이전트 대화를 모니터링하고 이동할 수 있습니다.
• Git 고립: 에이전트를 고립된 리포지토리 복사본에서 실행할 수 있으며, 완료 시 변경 사항이 자동으로 브랜치에 커밋됩니다.

대상 사용자

복잡한 소프트웨어 엔지니어링 작업을 위해 여러 전문 AI 에이전트를 관리해야 하는 pi 플랫폼 사용자. 특히, 자율적인 하위 에이전트 오케스트레이션의 Claude Code 스타일 경험을 원하는 사용자에게 적합합니다.

주요 기능

• 병렬 실행: 구성 가능한 동시성 제한을 가진 여러 백그라운드 에이전트를 생성할 수 있습니다.
• 사용자 정의 에이전트 유형: 프로젝트 또는 글로벌 설정 파일을 통해 사용자 정의 프롬프트와 도구 세트를 가진 전문 에이전트를 정의할 수 있습니다.
• 결정론적 워크플로우: Claude Code의 Workflow 도구와 호환되는 자바스크립트 기반 오케스트레이션 스크립트를 실행할 수 있습니다.
• 실시간 모니터링: 토큰 수, 도구 활동, 에이전트 상태를 실시간으로 추적할 수 있는 지속적인 위젯과 FleetView가 있습니다.
• 실행 중 조정: 에이전트를 재시작하지 않고도 실행 중인 에이전트에 메시지를 주입하여 작업 방향을 변경할 수 있습니다.
• 세션 재개: 전체 대화 컨텍스트를 보존하여 에이전트가 중단된 지점에서 다시 시작할 수 있습니다.
• 스케줄링: cron, 인터벌, 한 번만 실행하는 스케줄링을 지원합니다.