코파일럿 API, 에이전트별 사용량 분리 집계

에이전트 활동, 이제 '한 덩어리'가 아니다

깃허브 코파일럿 사용량 메트릭 API가 서드파티 에이전트 앱 활동을 에이전트별로 분리해 보고하는 기능을 2026년 8월 7일 공개했다. 기존에는 Claude, Codex 등 파트너 에이전트의 활동이 단일 버킷으로 합산돼, 어느 에이전트가 얼마나 쓰이는지 구분할 방법이 없었다. 팀이 두 개 이상의 에이전트를 도입하기 시작하면서, 이 한계는 도입률 비교나 라이선스 결정을 어렵게 만드는 실질적인 문제로 부각됐다.

이번 업데이트는 엔터프라이즈, 조직, 엔터프라이즈 사용자, 조직 사용자 수준의 1일 및 28일 보고서 전체에 적용된다. 에이전트별 활동을 독립적으로 추적할 수 있게 됨으로써, 새로 도입한 에이전트의 채택률을 기존 에이전트와 실제 수치로 비교하는 것이 가능해졌다.

새 필드의 구조와 사용법

응답에 추가된 선택적 배열 totals_by_3rd_party_agent는 인식된 에이전트 앱당 하나의 항목을 포함한다. 각 항목에는 agent_name(표시 이름), agent_id(안정적 식별자), user_initiated_interaction_count(사용자가 시작한 에이전트 앱 잡 실행 횟수), session_count(에이전트 앱 세션 수)가 들어간다.

깃허브는 표시 이름은 변경될 수 있으므로, 보고 기간 간 데이터를 연결할 때는 agent_name이 아닌 agent_id를 키로 사용하라고 명시했다. session_count는 집계된 엔터프라이즈·조직 보고서에만 포함되며, 사용자별 항목에는 이 필드가 빠진다.

주의해야 할 수치 혼동

중요한 주의 사항이 하나 있다. 이번에 새로 추가된 중첩 필드 user_initiated_interaction_count는 에이전트 앱 잡 시작 횟수를 세는 것으로, 기존 최상위 필드에 동일한 이름으로 존재하는 항목과는 완전히 다른 값이다. 기존 최상위 필드는 다른 텔레메트리 소스의 명시적 프롬프트를 집계한다. 두 값을 합산하거나 같은 의미로 취급하면 안 된다.

또한 같은 에이전트에 속한 여러 앱은 하나의 항목으로 합산되며, 식별이 불가능한 에이전트의 활동은 보고서에서 제외된다. 이 메트릭은 엔터프라이즈 소유자, 빌링 매니저, 조직 소유자, 그리고 '코파일럿 메트릭 보기' 권한이 부여된 커스텀 역할 보유자에게만 제공된다. 이용하려면 코파일럿 사용량 메트릭 정책이 활성화돼 있어야 한다.

하위 호환성과 현재 한계

이번 변경은 하위 호환성을 유지한다. 기존 필드의 형태는 그대로이며, 해당 기간에 인식된 에이전트 앱 활동이 없으면 totals_by_3rd_party_agent 필드 자체가 보고서에서 생략된다. 기존 연동 코드를 수정하지 않아도 동작에 영향이 없다.

다만 식별되지 않는 에이전트의 활동은 집계에서 빠지기 때문에, 모든 에이전트 사용량이 완전히 포착된다는 보장은 없다. 어떤 에이전트가 인식 대상에 포함되는지에 대한 상세 기준은 소스에 공개되지 않았다.