本記事はAIを利用して作成した技術解説・実装例です。掲載するコードや手順は一次情報を基に構成していますが、筆者による実機での動作確認は行っていません。環境やバージョンによって動作が異なる場合があります。
GitHubの公式変更履歴（Changelog）において、Copilot impact dashboardに機能ごとの利用状況（feature engagement）を表示する機能が追加されたことが発表されました。本記事では、一次情報に示されている変更内容やAPIの仕様、権限要件、集計の定義について整理します。
本記事を読むことで、Enterprise（企業）およびOrganization（組織）の管理者がCopilotの導入効果をどのように把握できるか、またレポートAPIやCLIから取得できるデータの構造を安全かつ実用的に理解できます。
1. 変更の背景と目的
GitHub Copilotの導入が進む中で、管理者は「どの機能が実際に開発者の日常的なワークフローに定着しているか」を把握する必要がありました。一次情報によると、従来のダッシュボードやレポートでは全体の利用傾向は把握できても、個別の機能ごとのエンゲージメントを詳細に追うことは難しかったり、AI adoption phaseの内訳が日単位の活動ユーザー数に限定されていたりしました。
今回のアップデートにより、Enterprise管理者はどの体験が広く受け入れられており、どこに追加のサポートやトレーニングが必要かを素早く判断できるようになります。
2. Copilot impact dashboardの主な新機能
Copilot impact dashboardでは、主要なCopilot機能に対して、28日間の集計期間中に少なくとも2日以上利用したアクティブユーザー数が表示されるようになります。
これにより、単なる「一度触っただけのユーザー」ではなく、継続的に活用しているユーザー層を可視化できます。また、ダッシュボード上の数値だけでなく、EnterpriseおよびOrganization向けの28日間集計レポートAPIにおいても同様のデータが取得できるようになっています。
3. レポートAPIにおけるデータ構造の拡張
一次情報では、APIや集計レポートに追加された具体的なオブジェクトやフィールドが詳細に説明されています。
copilot_feature_engagement: 28日間の集計レポート（EnterpriseおよびOrganizationレベル）に、ダッシュボードのアクティブユーザー合計および機能ごとのエンゲージメント数を追加します。
totals_by_feature: 機能を以下のカテゴリに分類してエンゲージメントの内訳を示します。
code completion
agent edit
passive Copilot code review
active Copilot code review
Copilot cloud agent
Copilot CLI
Copilot app
users_in_phase_28d: 各レポート日時点における、直近28日間のローリング期間全体でのAI導入フェーズごとの人口（population）を報告します。既存の
total_engaged_usersフィールドは、その日にアクティブだったフェーズ内ユーザーのみを報告し続けます。
4. 機能およびコードレビューの定義に関する注意点
一次情報では、集計対象となる機能の定義や制限事項についていくつかの重要な注意点が挙げられています。
レポートのレベル: 機能エンゲージメントは、EnterpriseおよびOrganizationの28日間集計レポートで利用可能であり、ユーザーレベルのレポートには追加されません。
重複カウント: 1人のユーザーが複数の機能を利用している場合、それぞれの機能でカウントされるため、複数機能の合計値は重複を含む場合があります。
コードレビューの区別:
Active Copilot code review: ユーザーが手動でCopilotレビューをリクエストした、またはCopilotレビューの提案を適用した場合。
Passive Copilot code review: ユーザーが積極的に関与することなく、プルリクエストのレビューにCopilotが自動割り当てされた場合。
匿名性と欠損値:
users_in_phase_28dおよびtotal_engaged_usersは集計値であり、個別のユーザーを特定するものではありません。測定されなかった場合はusers_in_phase_28dが省略され、測定されたがユーザーがいなかった場合は0が返されます。また、計算が利用できない場合、copilot_feature_engagementオブジェクトが不在またはnullになることがあります。
5. 利用に必要な権限とポリシー
このデータにアクセスするには、適切な権限と組織のポリシー設定を満たしている必要があります。
対象ロール: Enterpriseのオーナーおよび請求マネージャー（billing managers）、Organizationのオーナー、および
View Copilot Metrics権限を付与されたカスタムOrganization/Enterpriseロールを持つユーザー。前提ポリシー: Copilot usage metrics policy（Copilot利用メトリクスポリシー）が有効化されている必要があります。
6. まとめ
、公式のChangelogをもとにCopilot impact dashboardおよびAPIにおける機能エンゲージメントの追加について整理しました。
実行・確認前に確認すべき点と制約
本記事は一次情報の解説であり、実機環境でのAPI呼び出しや画面表示の結果は【実機確認前】の状態です。
データの取得には適切なロール（Enterpriseオーナー、請求マネージャー、Organizationオーナー、または
View Copilot Metrics権限）が必要です。Copilot利用メトリクスポリシーが有効になっていることを事前に確認してください。
ユーザーレベルのレポートには機能エンゲージメントが含まれない点に注意してください。
