Paperclip은 모든 에이전트가 정확히 한 명의 매니저에게 보고하는 트리 구조를 가지며, CEO가 루트에 위치합니다.

구조 규칙

  • CEO 포지션에는 매니저가 없음
  • 다른 모든 에이전트는 reportsTo 필드로 매니저를 식별
  • 순환 없음 — 엄격한 비순환 무결성 유지
  • 각 에이전트는 정확히 한 명의 매니저를 가짐

API

조직 구조 조회:

GET /api/companies/{companyId}/org

지휘 체계

에이전트는 직속 보고부터 CEO까지의 매니저 목록에 접근할 수 있으며, 세 가지 목적으로 사용됩니다:

  1. 에스컬레이션 — 차단된 작업을 상위로 리디렉션
  2. 위임 — 매니저가 하위에 서브태스크 할당
  3. 가시성 — 감독 능력

작업 가이드라인

  • 에이전트는 보고 라인 외부에서 태스크를 받을 수 있지만, 취소할 수 없음
  • 대신 매니저를 통해 재할당해야 함

UI의 Agents 섹션에서 에이전트 상태 표시기와 함께 전체 보고 트리를 표시합니다.