Copilot usage metrics API が返す enterprise / organization 向けレポート（ユーザー単位の 1 日・28 日、集計 1 日、28 日集計の各 day_totals）で、組織が用意した custom skill、custom agent、Model Context Protocol（MCP）サーバー、slash command、plugin が other や custom に潰れず、設定した名称ごとに読める。9 月の agentic CLI カスタマイズ指標の延長。新規 REST エンドポイントはなく、ダウンロード JSON の配列内容の拡張のみ。

#totals_by_* 配列

各要素は名称フィールドと interaction_count（整数）。

  • totals_by_skill[] … skill。skill 呼び出し回数。
  • totals_by_custom_agent[] … custom_agent。custom agent 開始回数。
  • totals_by_mcp[] … mcp。MCP サーバー接続・再接続試行（成功・失敗を含む。接続済みサーバー経由の tool 呼び出しは加算しない）。
  • totals_by_slash_cmd[] … slash_cmd。slash command 呼び出し回数。
  • totals_by_plugin[] … plugin。plugin に紐づく skill 呼び出し（skill 全体の部分集合。plugin と skill の interaction_count は足し合わせない）。

interaction_count の高い順に、レコードあたり名前付きエントリを最大 25 件保持（従来 5 件）。26 件目以降は末尾の other に合算。slash command で名称が取れない行は custom（other とは別）。

対応する distinct 系は distinct_skill_use_count、distinct_custom_agent_use_count、distinct_mcp_use_count、distinct_slash_cmd_use_count、distinct_plugin_use_count。名称表示の追加でも算出方法は不変。配列に名前が載らない識別子も distinct には含まれる。

#名称が載るクライアントと制約

名称は Copilot usage metrics ポリシーが有効な enterprise で、次のクライアントから送られる。

  • Copilot CLI（対話セッションと prompt mode -p）
  • GitHub Copilot アプリ
  • Copilot SDK 上のクライアント（VS Code、JetBrains IDE など）
  • Agent Client Protocol（ACP）連携

prompt mode・アプリ・ACP は Copilot CLI 1.0.97 以上。Copilot SDK クライアントは SDK 1.0.21 以上（SDK 同梱 CLI を差し替える場合も CLI 1.0.97 以上）。Copilot SDK 非ベースの IDE 連携は名称を報告しない。

設定名は trim 後 128 文字まで。ファイルパスに見える名称は従来どおり other または custom。名称対応デプロイ後に処理されたレポート日から反映され、過去日は自動バックフィルなし。

値はイベント回数でありユーザー数ではない。クライアントテレメトリ依存のため古いクライアントやテレメトリ遮断では過小計上。トレンドと採用の把握向けで、完全な監査用途には向かない。

#取得権限

enterprise owner、billing manager、organization owner、または View Copilot Metrics を付与したカスタム enterprise / organization ロール。enterprise 全体で Copilot usage metrics ポリシーが Enabled であること。

#参考文献