API を通じてチームレベルの Copilot 利用状況メトリクスが公開されました
本文の状態
日本語全文を表示中
詳細モードで約3分の本文を読めます。
同じ出来事の情報源
この情報源を基点に整理
GitHub Changelog
Microsoft は、Copilot のライセンスを持つユーザーと所属チームを紐付ける新レポート機能を API に追加しました。これにより、企業管理者は組織内の任意のチームにおけるアクティブユーザー数や完了数、チャット数などを言語や IDE 別に分析できるようになります。
Source Article
元記事を日本語で読む
本文に関係しない購読案内、埋め込み通知、サイト内プロモーションは除いています。
Copilot 使用状況メトリクス API に、各 Copilot ライセンス保有ユーザーを所属チームにマッピングする新しいユーザー・チームレポートが追加されました。このユーザー・チームレポートと既存のユーザー別使用状況レポートを結合することで、企業管理者や組織オーナーは、自らの組織または企業内の任意のチームに対するチームレベルの Copilot 使用状況メトリクス（アクティブユーザー数、完了数、チャット数など）を生成できるようになります。また、言語、IDE、機能、モデルごとの内訳も含まれます。
仕組み
2 つの新規エンドポイントが、NDJSON レポートへの署名付きダウンロード URL を返します:
GET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day
GET /orgs/{org}/copilot/metrics/reports/user-teams-1-day
ユーザー・チームレポートの各行は、特定の日のチーム所属を表しており、そのチームの企業 ID または組織 ID、チームスラッグ、およびユーザー ID とログイン名が含まれます。チームレベルのメトリクスを生成するには、user_id と day をキーとしてユーザー・チームレポートをユーザー別使用状況レポートに結合し、集計を行います。
今回のリリースでは、ドキュメントにおいて、結合処理、日次集計、および多日レポート用のローリングウィンドウパターンに関するステップバイステップのガイダンスも新たに追加されました。
この機能の利用対象者
これらのメトリクスは、REST API を通じて、企業管理者、組織オーナー、請求管理担当者、および「View Enterprise Copilot Metrics」権限を持つ企業カスタムロールのユーザーが利用できます。
主な利点
チーム別スライス指標：組織または企業全体の合計から、外部のチーム帰属情報を構築することなく、任意の組織または企業のチーム単位まで Copilot の採用状況、アクティブユーザー数、コード生成活動をピボット表示できます。
チャンピオンとギャップの特定：どのチームが採用を推進しているか、どのチームに支援が必要かを把握し、キャンペーンや展開投資をターゲット化できるようにします。
機能カバレッジの完全性：IDE 補完、チャット、Copilot CLI、コードレビュー、Copilot クラウドエージェント活動に関するチーム別内訳が利用可能です。言語、IDE、機能、モデルごとに切り分けが可能です。
重要な注意事項
ユーザー・チームレポートは REST API を通じてのみ利用可能です。今回のリリースでは、チームレベルの指標に対するダッシュボード画面は用意されていません。
Copilot のライセンスを保有するユーザーが 5 名未満のチームは、ユーザー・チームレポートから除外されますが、そのメンバー個々の活動は、ユーザー別使用状況レポートでは引き続き確認できます。
複数のチームに所属しているユーザーの場合、その活動は各チームの集計値に含まれるため、チームごとの合計を単純に加算しても組織全体または企業全体の合計を再現することはできません。
結合レシピやローリングウィンドウ集計を含むステップバイステップガイドについては、「Team-level Copilot usage metrics」をご覧ください。
GitHub Community 内のディスカッションに参加してください。
「Team-level Copilot usage metrics now available via API」という投稿は、The GitHub Blog で最初に公開されました。
原文を表示
The Copilot usage metrics API now exposes a new user-teams report that maps each Copilot-licensed user to the teams they belong to. By joining the user-teams report with the existing per-user usage report, enterprise administrators and organization owners can produce team-level Copilot usage metrics for any team in their organization or enterprise. This includes elements such as active users, completions, chats, as well as breakdowns by language, IDE, feature, and model.
How it works
Two new endpoints return signed download URLs to NDJSON reports:
GET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day
GET /orgs/{org}/copilot/metrics/reports/user-teams-1-day
Each row in the user-teams report represents a team membership for a given day, including the team’s enterprise or organization id, team slug, and the user’s ID and login. To produce team-level metrics, join the user-teams report to the per-user usage report on user_id and day, then aggregate.
This release also introduces step-by-step guidance in the docs covering the join, day-level aggregation, and a rolling-window pattern for multi-day reporting.
Who can use this feature
These metrics are available through the REST API to enterprise administrators, organization owners, billing managers, and people with an enterprise custom role with the View Enterprise Copilot Metrics permission.
Key benefits
Slice metrics by team: Pivot Copilot adoption, active users, and code generation activity from org/enterprise totals down to any organization or enterprise team without building external team attribution.
Identify champions and gaps: See which teams are driving adoption and which need enablement, so you can target campaigns and rollout investments.
Full feature coverage: Team-level breakdowns are available across IDE completions, chat, Copilot CLI, code review, and Copilot cloud agent activity. They can be cut by language, IDE, feature, or model.
Important notes
User-teams reports are available through the REST API only. There is no dashboard surface for team-level metrics in this release.
Teams with fewer than five Copilot-seated users are excluded from the user-teams report, though their members’ individual activity remains visible in the per-user usage report.
Users who belong to multiple teams will have their activity counted in each team’s aggregate, so team totals cannot be summed to reproduce an organization or enterprise total.
For step-by-step guidance, including the join recipe and rolling-window aggregation, see Team-level Copilot usage metrics.
Join the discussion within GitHub Community.
The post Team-level Copilot usage metrics now available via API appeared first on The GitHub Blog.
関連記事
今日のまとめ
AIデイリーブリーフで今日の重要ニュースをまとめ読み