Copilot usage metrics API が返す enterprise / organization 向け 1 日・28 日レポート（ユーザー単位と集計）に、bring your own key（BYOK）と enterprise custom models の内訳が載る。課金管理者や Copilot 利用ポリシー担当が、自社キー・ローカルモデル・enterprise 設定のカスタムモデル利用を Copilot ホスト型と切り分けて集計する用途向け。新規の REST エンドポイントは追加されず、ダウンロード JSON のフィールド拡張のみ。

#Local BYOK

開発者が Copilot CLI または GitHub Copilot アプリ側で設定する local BYOK。リクエストはクライアントから利用者のプロバイダキーまたはローカルモデルへ直接送られる。Ollama、Foundry Local、LM Studio、llama-server などのローカル提供も対象。

  • used_local_byok: 当該日に local BYOK リクエストが 1 回以上あったか。ユーザー単位レポート。
  • totals_by_local_byok: セッション・リクエスト・プロンプト・トークン数。byok_kind（local_managed / local_user / local_auto / remote_user）と surface（copilot_cli / copilot_app）で内訳。ユーザー単位と集計レポート。
  • daily_active_local_byok_users / weekly_active_local_byok_users / monthly_active_local_byok_users: 日・暦週・暦月の local BYOK アクティブユーザー数。集計レポート。

local BYOK はもともと totals_by_cli と totals_by_copilot_app の部分集合として計上済み。集計フィールドの合計値は従来どおり。

#Enterprise custom models

管理者が GitHub 設定で登録し、GitHub 経由でプロバイダへルーティングするカスタムモデル。

  • is_custom_enterprise_model: totals_by_client[].totals_by_model[] 各要素の boolean。enterprise または organization 向けカスタムモデル経由のリクエストでは true。サーバー側観測のため IDE など全クライアントをカバー。
  • 同一モデル名が Copilot ホスト型とカスタムモデルの両方で使われる場合、エントリは 2 行に分かれ、件数は重ね合わせない。
  • カスタムモデル行には実リクエスト数とトークン数が入る。カスタムモデル利用は従来から totals_by_client に含まれ、合計定義は不変。

#読み取り上の注意

  • is_custom_enterprise_model は今回のリリース以降のレポート日のみ。過去日へのバックフィルなし。
  • local BYOK はクライアントテレメトリ依存のため、テレメトリ無効時は過小計上。トークンもローカルプロバイダが報告しない場合がある。enterprise custom models はサーバー観測でこの制約なし。
  • カスタムモデル名は既存の正規化ルールに従い、未認識名は unknown。local BYOK はモデル名別の内訳なし。
  • 利用権: enterprise owner、enterprise billing manager、organization owner、または View Copilot Metrics を付与したカスタム enterprise / organization ロール。enterprise 全体で Copilot usage metrics ポリシーが Enabled であること。

#参考文献