코파일럿(Copilot) 사용량, 이제 팀별로 분석하세요!
코파일럿(Copilot) 사용량 지표 API에 팀 레벨 리포트 기능이 추가되어, 각 팀별 사용 현황 파악(Usage Analysis) 가능
REST API를 통해 NDJSON 형식의 보고서 다운로드 URL을 제공하며, 기존 사용자별 보고서와 결합하여 사용
팀별 지표(Team-level Metrics)를 통해 코파일럿(Copilot) 도입 현황 및 활용도 분석(Adoption Analysis) 가능
5명 미만의 사용자를 가진 팀은 보고서에서 제외되며, API 전용(API-only)으로 대시보드 미제공
팀 레벨 지표(Team-level Metrics) API 작동 방식
본문에 따르면, 새로운 API는 NDJSON(Newline Delimited JSON) 형식의 보고서를 반환하며, 엔터프라이즈(Enterprise) 또는 조직(Organization) ID, 팀 슬러그(Team Slug), 사용자 ID(User ID) 및 로그인 정보를 포함한다.
GET 요청(GET Request): `/enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day` 및 `/orgs/{org}/copilot/metrics/reports/user-teams-1-day` 엔드포인트(Endpoint)를 통해 보고서 다운로드
데이터 결합(Data Joining): 사용자-팀 보고서와 사용자별 사용 보고서를 `user_id`와 `day`를 기준으로 결합
집계(Aggregation): 팀 레벨 지표 생성을 위해 데이터 집계 수행
결과적으로, 기존 API 사용자는 데이터 결합 및 집계(Data Joining & Aggregation)를 통해 팀별 코파일럿(Copilot) 사용 현황을 파악할 수 있다.
팀별 지표(Team-level Metrics) API의 주요 장점
글에 따르면, 팀 레벨 지표(Team-level Metrics) API는 조직 및 엔터프라이즈(Enterprise) 전체 사용량에서 벗어나 팀 단위의 상세 분석(Detailed Analysis)을 가능하게 한다.
팀별 사용 현황 파악: 조직/엔터프라이즈 전체 사용량에서 팀별 도입 현황(Adoption Status), 활성 사용자(Active Users), 코드 생성 활동(Code Generation Activity) 파악
챔피언 및 격차 식별: 코파일럿(Copilot) 사용을 주도하는 팀과 지원이 필요한 팀을 식별하여 맞춤형 지원(Customized Support) 제공
다양한 지표 지원: IDE(Integrated Development Environment) 완성, 채팅, Copilot CLI, 코드 리뷰, Copilot 클라우드 에이전트(Cloud Agent) 활동 등 다양한 기능별 분석(Feature-Specific Analysis) 지원
결론적으로, 팀 단위의 세분화된 지표(Granular Metrics)를 통해 코파일럿(Copilot) 활용 전략을 수립할 수 있다.
API 사용 시 주의사항
본문은 팀 레벨 지표(Team-level Metrics) API 사용 시 몇 가지 주의사항을 명시하고 있다.
API 전용: 팀 레벨 지표는 REST API를 통해서만 접근 가능하며, 별도의 대시보드(Dashboard) 미제공
제외 대상: 5명 미만의 코파일럿(Copilot) 사용자를 가진 팀은 보고서에서 제외되지만, 개별 사용자의 활동은 사용자별 보고서에서 확인 가능
중복 집계: 여러 팀에 속한 사용자의 활동은 각 팀의 집계에 포함되므로, 팀별 총계를 합산하여 조직 또는 엔터프라이즈 전체 사용량을 재현할 수 없음
결과적으로, API 사용자는 이러한 제한 사항(Limitations)을 인지하고, 데이터 분석 시 주의를 기울여야 한다.
API 활용을 위한 추가 정보
글에서는 API 사용을 위한 추가적인 정보와 가이드를 제공한다.
단계별 가이드: 데이터 결합(Data Joining), 일별 집계(Day-level Aggregation), 롤링 윈도우 패턴(Rolling-window Pattern) 등 구체적인 사용 방법(Usage Guide) 제공
GitHub Community: 깃허브 커뮤니티(GitHub Community)에서 API 관련 논의 참여 가능
REST API: REST API를 통해 NDJSON 형식의 보고서를 다운로드하여 분석
결론적으로, 깃허브(GitHub)는 API 사용을 위한 다양한 지원(Various Supports)을 제공하여, 사용자들이 팀 레벨 지표를 효과적으로 활용할 수 있도록 돕는다.
