AI 에이전트 Pi, 자연어 요청으로 하위 에이전트에 작업 위임한다

개발자 nicobailon이 AI 에이전트 'Pi'용 오픈소스 확장 'pi-subagents'를 공개했다. 이 확장은 Pi가 코드 리뷰, 코드베이스 정찰, 구현, 병렬 감사, 저장된 워크플로, 백그라운드 작업 등 한 번 더 검토가 필요한 일을 집중형 하위 에이전트에게 맡길 수 있게 해준다.

설치는 'pi install npm:pi-subagents' 한 줄이면 끝나며, 이것이 유일한 필수 단계다. 에이전트를 따로 만들거나 설정 파일을 작성하거나 슬래시 명령을 배울 필요 없이, 설치 후 평범한 말로 위임을 요청하면 된다. 예컨대 "이 diff를 reviewer로 검토해줘"처럼 요청하면 된다.

Pi는 부모 세션이고, 하위 에이전트는 각자 맡은 일을 처리하는 집중형 자식 Pi 세션이다. 하위 에이전트를 요청하면 Pi가 자식 세션을 시작해 작업을 넘기고 결과를 다시 가져온다. 포그라운드 실행은 대화 안에서 진행 상황이 실시간으로 표시되고, 백그라운드 실행은 제어권이 돌아온 뒤에도 계속 동작하며 나중에 확인할 수 있다.

확장을 설치한다고 해서 백그라운드에 자동 리뷰어가 켜지는 것은 아니다. 설치는 Pi에게 위임 도구를 제공할 뿐이며, 모든 구현을 검토하게 하려면 프롬프트나 프로젝트 지침에 "구현을 마치면 요약 전에 reviewer 하위 에이전트를 실행하라"처럼 명시해야 한다.

확장에는 바로 쓸 수 있는 기본 에이전트가 들어 있다. 코드베이스를 빠르게 정찰하는 scout, 출처와 함께 웹·문서를 조사하는 researcher, 기존 맥락에서 구현 계획을 세우는 planner, 실제로 파일을 수정하고 검증하는 worker, 구현을 점검하고 작은 수정을 하는 reviewer, 계획 전 맥락을 더 탄탄히 수집하는 context-builder, 행동 전에 가정을 의심하며 두 번째 의견을 주는 oracle, 부모 세션에 가깝게 동작하는 범용 delegate다.

기본 에이전트는 별도 지정이 없으면 현재 Pi의 기본 모델을 그대로 물려받는다. 특정 역할에 다른 모델을 쓰고 싶으면 한 번만 적용되는 명령에 모델을 지정하거나, 설정 파일의 agentOverrides 블록에서 모델·사고 수준·장애 대비 대체 모델을 영구적으로 지정할 수 있다. 설정은 사용자 단위나 프로젝트 단위 파일로 둘 수 있다.

개발 작업에서 권장하는 흐름은 '명확화 → planner → worker → 새 맥락의 reviewer → worker'다. 패키지에는 같은 형태를 반복해서 쓸 수 있도록 /parallel-review 같은 재사용 가능한 프롬프트 템플릿도 함께 들어 있다.

자식 세션에는 안전 경계가 런타임에서 적용된다. 생성된 자식 세션은 pi-subagents 스킬을 받지 못하고, 기본적으로 위임 도구를 등록하지 않으며, 자신이 부모 오케스트레이터가 아니므로 하위 에이전트를 제안하거나 실행해서는 안 된다는 지침을 받는다. 다만 도구 목록에 위임 기능이 포함되도록 명시된 에이전트만 예외적으로 자식 안전 버전의 위임 도구를 받아, 부모가 맡긴 범위 안에서 작업을 펼칠 수 있다.