2026.08.24

GitHub Copilotのusage metrics APIでagent app activityは何を確認すべき?8月7日公開のtotals_by_3rd_party_agent・agent_id・28日レポート差分を整理する運用ガイド【2026年速報】

GitHub Copilotのusage metrics APIでagent app activityは何を確認すべき?8月7日公開のtotals_by_3rd_party_agent・agent_id・28日レポート差分を整理する運用ガイド【2026年速報】

GitHub Copilotのusage metrics APIに、2026年8月7日からagent app activityの内訳が追加されました。これでClaudeやCodexのような外部agent appの利用状況を、Copilot本体の利用と切り分けて追えるようになります。複数のagentを併用している企業では、どのagentが実際に使われているか、誰が使っているか、導入判断が当たっているかを数字で見直しやすくなりました。

GitHub Copilotのusage metrics APIで何が変わったのか

公式changelogによると、新しく optional な totals_by_3rd_party_agent 配列が追加され、認識されたagent appごとに利用状況を確認できます。各要素には agent_name、agent_id、user_initiated_interaction_count が含まれ、集計レポートでは session_count も確認できます。display nameは将来変わる可能性があるため、継続比較では agent_name ではなく agent_id で集計するのが前提です。

どのレポートで見られるのか

GitHub公式では、この追加は enterprise、organization、enterprise-user、organization-user の1-dayと28-dayレポートで利用できると案内されています。つまり、全体傾向を見る用途と、個人単位で浸透を見る用途の両方に使えます。一方で、per-user entry には session_count が含まれず、aggregated report 側だけに入る点は見落としやすい注意点です。チーム別に見たい場合は、従来どおり user-teams report と per-user report を結合して読む必要があります。

GitHub Copilot、Claude、Codexを横断して運用設計や可視化を整えたい企業は、 AI活用設計の相談はこちら 。導入判断と計測設計を同時に整えると、ライセンス費用の説明がかなりしやすくなります。

管理者が最初に確認すべき3つの論点

1つ目は、Copilot usage metrics policy が enterprise で Enabled everywhere になっているかです。これが無効だとAPI自体が使えません。2つ目は、誰に View Copilot Metrics 権限を渡すかです。enterprise owner や billing manager だけでなく、custom roleでも閲覧できます。3つ目は、導入効果を agentごとに比較する設計です。Claudeをレビュー用途、Codexを実装用途のように使い分けているなら、agent_id 単位で利用者数と job starts の推移を見ると、想定どおりの役割分担になっているかを判断しやすくなります。

運用でハマりやすい注意点

今回の user_initiated_interaction_count は、agent app の job starts を数える別物です。トップレベルにも同名フィールドがありますが、GitHub公式はこの2つを合算しないよう明記しています。さらに、識別できないagentの活動は totals_by_3rd_party_agent に含まれません。つまり、数値がゼロだから利用がないとは限らず、認識対象外の統合や命名揺れがないかも確認が必要です。agent app activity は agent単位で集約され、同じagentに属する複数アプリは1つに畳み込まれる点も、現場説明で誤解されやすいポイントです。

既存のusage report記事とどう使い分けるべきか

8月11日に公開されたモデル別token内訳の記事は、Copilot本体の請求やcache read/writeをどう読むかが中心でした。今回の更新はそこに「どのagentに投資が流れているか」を足す変更です。請求最適化だけを見たいなら従来の usage report、マルチagent運用の実態や新規導入agentの浸透を見たいなら今回の agent app activity が向いています。特に、Slack連携やTeams連携のようにagent接点が増えた組織では、表面上のアクティブ率だけでなく、どのagent経由で行動が始まっているかを追う意味が大きくなります。

よくある質問

Q. 個人別にsession_countは見られますか? A. いいえ。GitHub公式では session_count は aggregated enterprise / organization reports のみで、per-user entries には含まれません。Q. agent_nameで継続比較してよいですか? A. 非推奨です。display name は変わり得るため、agent_idで追うのが公式推奨です。Q. まず何から着手すべきですか? A. metrics policyの有効化、権限整理、agent_id別ダッシュボード化の順が現実的です。

GitHub Copilotの可視化を、単なる利用率ではなく「どのagentがどの業務で効いているか」まで見える形にしたいなら、 問い合わせフォームから相談 してください。導入設計、権限設計、計測設計をまとめて見直すと、マルチagent運用の説明責任を作りやすくなります。