Copilot使用状況メトリックで使用可能なデータ

Copilot使用状況メトリックダッシュボードと API では、一貫性のある一連のフィールドを使用してデータが表示およびエクスポートされます。このリファレンスでは、使用可能なすべてのメトリックの一覧を示し、ダッシュボードビジュアルと NDJSON または API エクスポートの両方で値を解釈する方法について説明します。

Copilot使用状況メトリックダッシュボードは、エンタープライズ レベルと組織レベルで使用できます。
Copilot使用状況メトリック API は、エンタープライズまたは組織のスコープでレポートを返し、集計、リポジトリレベル、および個々のユーザーレベルのレポートの細分性を持ちます。図形は、スコープと細分性によって異なります。
チームレベルのメトリックは事前に集計されません。ユーザーチームレポートとユーザーごとの使用状況メトリックレポートを結合して作成します。「チームレベルのCopilot使用状況メトリック」を参照してください。
リポジトリレベルのレポートには、要求された日の pull request アクティビティを含むリポジトリごとに 1 つのレコードが含まれます。この記事で後述するリポジトリレベルのフィールド (API のみ) を参照してください。

これらのメトリックを読み取って解釈する方法のガイダンスについては、 GitHub Copilot 使用状況メトリクスを参照してください。

Copilot 使用状況ダッシュボードの指標

これらのメトリックは、 Copilot 使用状況ダッシュボードに直接表示されます。これらのグラフには、**** の使用は含Copilot CLI (コパイロット CLI)。

メトリック	Description
エージェントの導入	現在のカレンダー月にエージェントを試した Copilotライセンスを持つアクティブユーザーの割合。
アクティブユーザーあたりの平均チャット要求数	アクティブユーザーあたりのチャット要求の平均数。
コード補完 (推奨/受け入れ済み)	表示され、受け入れられたインラインコード候補の合計数。
コード補完の受け入れ率	ユーザーが受け入れた提案の割合。
1 日当たりのアクティブユーザー	特定の日に Copilot を使用した一意のユーザーの数。
週間アクティブユーザー	7 日間に Copilot を使用した一意のユーザーの数。
アクティブなユーザーの合計数	現在のカレンダー月にアクティブなライセンスユーザー。
言語の使用方法
Copilotで使用されるプログラミング言語の配布。
1 日あたりの言語使用量	使用されている言語の毎日の内訳。
モデルの使用法	チャットに使用される AI モデルの配布。
1 日あたりのモデル使用量	チャットモデルの使用状況の毎日の内訳。
チャットモードごとのモデルの使用状況
Copilot機能 (質問、編集、計画、エージェント) によるモデルの使用状況。
言語ごとのモデルの使用	モデル別に分類された言語の分布。
最もよく使用されるチャットモデル	過去 28 日間で最もよく使用されるチャットモデル。
チャットモードあたりの要求数	モード別のチャット要求の数 (ask、edit、plan、agent)。

インパクトダッシュボードの指標

これらのメトリックは、ユーザーを導入コーホートにグループ化し、その導入をプル要求出力に接続する影響ダッシュボードに表示されます。導入コーホートの解釈に関するガイダンスについては、 AUTOTITLE を参照してください。

メトリック	Description
エンゲージメントの傾向	組織の導入コーホートの組み合わせとプル要求のスループット (1 か月あたりにマージされたプル要求の合計) が過去 6 か月間に変更された方法。
導入コーホート分布	各導入フェーズ (パッシブユーザー、フェーズ 1、フェーズ 2、フェーズ 3) にグループ化されたライセンスユーザーの共有。パッシブユーザーは、API の `No Cohort` 値に対応します。
導入促進要因	積極的なユーザー（フェーズ 1、2、または 3）と受動的なユーザーを、出荷されたコード（ユーザー 1 人あたり月ごとにマージされたプルリクエスト数）およびプルリクエストがマージされるまでの時間で比較し、Copilot のより深い導入による相対的な影響を示します。
推奨事項	組織の現在のコーホート配布に基づいて、 Copilot クラウドエージェントの構成や Copilotコードレビューの有効化などの推奨されるアクション。

コード生成ダッシュボードのメトリック

これらのメトリックは、コード生成ダッシュボードに表示され、ユーザーが開始したアクティビティとエージェントによって開始されたアクティビティ全体でコードがどのように生成されているかの内訳を示します。すべての値は、IDE で追加または削除されたコード行 (LoC) から派生します。

メトリック	Description
AI で変更されたコード行	過去 28 日間のすべてのモードで追加および削除されたコードの合計行数。
エージェントのコントリビューション	過去 28 日間にエージェント (編集、エージェント、カスタムモードを含む) によって追加および削除されたコード行の割合。
エージェントによって削除された平均行数	現在のカレンダー月のアクティブユーザーに代わってエージェントによって自動的に削除された行の平均数。
追加および削除された行の 1 日あたりの合計	各日のすべてのモードで、コードベースに対して追加および削除された行の合計数。
ユーザーによるコード変更	コード補完とチャットパネルアクション (挿入、コピー、または適用) を通じてユーザーが提案または手動で追加した行。
エージェントによって開始されるコードの変更	編集モード、エージェントモード、およびカスタムモード全体で、ユーザーに代わってエージェントによってコードベースに自動的に追加または削除された行。
モデルごとのユーザーによって開始されたコードの変更	IDE で使用されるモデル別にグループ化された、ユーザーが開始するコード行。
モデルごとにエージェントが開始するコード変更	エージェントによって開始されるコード行。エージェントアクションを実行するモデル別にグループ化されます。
言語ごとのユーザー開始コードの変更	プログラミング言語別にグループ化された、ユーザーが開始するコード行。
言語ごとのエージェントによって開始されるコードの変更	エージェントによって開始されるコード行。プログラミング言語別にグループ化されます。

API フィールドとエクスポートフィールド

これらのフィールドは、エクスポートされた NDJSON レポートと、 Copilot 使用状況メトリック API に表示されます。以下のほとんどの表は、フィールド名、その JSON 型、値を null にできるかどうか、および説明を示しています。

レポートの形状は範囲と粒度によって異なるため、レコードで使用できるフィールドは、レポートの取得元によって異なります。

ユーザーごとのレポート (*-users-1-day と *-users-28-day) には、 user_id、 user_login、 ai_credits_used、 used_* インジケーター、 ai_adoption_phaseなど、ユーザーごとに 1 つのレコードが含まれます。アクティブユーザーの数、 pull_requests、または totals_by_ai_adoption_phaseは含まれません。
集計レポート (enterprise-1-day と org-1-day) には、アクティブユーザー数、 pull_requests、 totals_by_ai_adoption_phaseなど、企業または組織ごとに 1 つの集計レコードが含まれます。 user_id、user_login、またはused_*インジケーターは含まれません。
28 日間のレポート (enterprise-28-day と org-28-day) は、 day_totals フィールド内の日次集計レコードの配列をラップし、レポートウィンドウを最上位に表示します。
ユーザーチームレポート (*-user-teams-1-day) は、所属するチームにユーザーをマップするため、チームレベルのメトリックを構築できます。
リポジトリレベルのレポート (*-repos-1-day) には、 Copilot クラウドエージェントによって作成され、 Copilotコードレビューによってレビューされたプル要求など、その日の pull request アクティビティを含むリポジトリごとに 1 つのレコードが含まれます。

組織範囲のレポートには、organization_idと共にenterprise_idも含まれます。 API によって返されるデータのスキーマの例については、 Copilot使用状況メトリックのスキーマの例を参照してください。

Type 列では、JSON スキーマの種類 (string、integer、number、boolean、array、およびobject) が使用されます。 Nullable 列は、そのフィールドの値が null であるか、あるいは本来適用されるべきレコードからその値が欠落している可能性があるかどうかを示します。アクティビティの内訳配列は常に存在しますが、空 ([]) にすることができます。省略可能な配列は null 許容としてマークされ、存在しない場合があります。

レポート識別フィールドとパーティションフィールド

これらのフィールドは、各レコードのスコープ、日付、および (エクスポート用) パーティションを識別します。存在する正確なセットは、レポートの図形によって異なります。

フィールド	タイプ	ヌラブル	Description
`day`	`string`	いいえ	このレコードが表すカレンダーの日付 ( `YYYY-MM-DD` 形式)。 28 日間のレポートでは、 `day` は最上位ではなく、各 `day_totals` エントリ内に表示されます。
`enterprise_id`	`string`	いいえ	企業の一意の ID。エンタープライズスコープレポートと組織スコープレポートの両方に含まれます。
`organization_id`	`string`	イエス	組織の一意の ID。組織範囲のレポートにのみ含まれます。はエンタープライズスコープのレポートから省略されます。
`etl_id` / `day_partition`	`string`	いいえ	ハウスキーピングに使用されるパーティションフィールド。エクスポートされた NDJSON ファイルに含まれており、使用状況メトリック API によって返されます。
`entity_id_partition`	`integer`	いいえ	ハウスキーピングに使用されるエンティティパーティション。エクスポートされた NDJSON ファイルに含まれており、使用状況メトリック API によって返されます。

ユーザーごとのレポートフィールド

ユーザーごとのレポートには、レポート期間のユーザーごとに 1 つのレコードが含まれます。ユーザーごとの 28 日間のレポートには、レポートウィンドウをマークする report_start_day と report_end_day も含まれます。

フィールド	タイプ	ヌラブル	Description
`user_id`	`integer`	いいえ	ユーザーを表す一意の識別子です。
`user_login`	`string`	いいえ
GitHub ユーザーのユーザー名。
`ai_credits_used`	`number`	いいえ	レポート期間中にユーザーが消費した AI クレジットの合計。このフィールドはユーザーごとのレポートにのみ含まれており、機能、モデル、またはサーフェスごとに分類されません。このメトリックは、請求の合計ではなく、使用量分析用です。
`user_initiated_interaction_count`	`integer`	いいえ
Copilotに送信された明示的なプロンプトの数。モデルにアクティブに送信されたメッセージまたはプロンプトのみをカウントします。チャットパネルを開く、モードを切り替える (たとえば、質問、編集、プラン、エージェントなど)、キーボードショートカットを使用してインライン UI を開く、または構成を変更することは含まれません。
`code_generation_activity_count`	`integer`	いいえ	生成された個別の Copilot 出力イベントの数。
含む：コメントやドキュメント文字列など、生成されたすべてのコンテンツ。
複数のブロック: 1 人のユーザープロンプトからの個別のコードブロックはそれぞれ、個別の生成としてカウントされます。
手記： 1 つのプロンプトで複数の世代を生成できるため、このメトリックは `user_initiated_interaction_count`と直接比較できません。
`code_acceptance_activity_count`	`integer`	いいえ	ユーザーが受け入れる提案またはコードブロックの数。
カウント：すべての組み込みの受け入れアクション ("ファイルに適用する"、"カーソルに挿入する"、"ターミナルに挿入する"、コピーボタンの使用など)。
カウントされません。 OS クリップボードの手動操作 ( `Ctrl`+`C` など)。
粒度：最初のプロンプトによって生成されたコードブロックの数に関係なく、受け入れアクションごとにカウントが 1 回インクリメントされます。
`loc_suggested_to_add_sum`	`integer`	いいえ	追加が提案されたコード行数 Copilot（補完、インラインチャット、チャットパネルなど。エージェントによる編集は除外）
`loc_suggested_to_delete_sum`	`integer`	いいえ	コード行 Copilot 削除することをお勧めします (今後のサポートが予定されています)。
`loc_added_sum`	`integer`	いいえ	実際にエディターに追加されたコードの行数（承認された補完、適用されたコードブロック、エージェントモード、編集モード）。
`loc_deleted_sum`	`integer`	いいえ	エディターから削除されたコード行 (現在、エージェントの編集から)。
`used_agent`	`boolean`	いいえ	ユーザーがその日に IDE でエージェントモードを使用したかどうか。
Copilotコードレビューと`used_copilot_code_review_active`で個別にキャプチャされる`used_copilot_code_review_passive`アクティビティは含まれません。
`used_chat`	`boolean`	いいえ	ユーザーがその日に IDE チャットを使用したかどうか。
`used_cli`	`boolean`	いいえ	ユーザーがその日 Copilot CLI (コパイロット CLI) 使用したかどうか。
`used_copilot_app`	`boolean`	いいえ	ユーザーがその日に Copilot アプリを使用したかどうか。
`used_copilot_coding_agent`	`boolean`	いいえ	ユーザーがその日Copilot クラウドエージェント (以前はコーディングエージェントCopilot) を使用したかどうか。
`used_copilot_cloud_agent`	`boolean`	いいえ	ユーザーがその日 Copilot クラウドエージェント使用したかどうか。
`used_copilot_coding_agent`と同じ値を保持します。両方の名前は下位互換性のために保持されます。
`used_copilot_code_review_active`	`boolean`	イエス	ユーザーがその日 Copilotコードレビュー積極的に関与しているかどうか。ユーザーが手動で Copilot レビューを要求した場合、または Copilot レビューの提案を適用した場合、ユーザーはアクティブと見なされます。その日にユーザーに Copilotコードレビューシグナルがない場合は null。
`used_copilot_code_review_passive`	`boolean`	イエス	ユーザーが、その日に、自ら積極的にレビューに関与することなく、Copilot にその pull request のレビュー担当として自動的に割り当てられていたかどうか。その日にユーザーに Copilotコードレビューシグナルがない場合は null。
`ai_adoption_phase`	`object`	いいえ	その日のユーザーの AI 導入フェーズ。常に存在し、既定では「No Cohort」フェーズになります。
AI 導入フェーズのフィールドを参照してください。
`totals_by_cli`	`object`	イエス	ユーザーの CLI 固有のメトリック。ユーザーがその日 Copilot CLI (コパイロット CLI) 使用しなかった場合は省略されます。
メトリックフィールドCopilot CLI (コパイロット CLI)参照してください。
`totals_by_copilot_app`	`object`	イエス
Copilot アプリユーザーのメトリック。ユーザーがその日 Copilot アプリ使用しなかった場合は省略されます。
メトリックフィールドCopilot アプリ参照してください。
`totals_by_3rd_party_agent`	`array`	イエス	認識されたエージェントアプリのエージェントごとの使用状況メトリック。レポート期間中にユーザーが認識エージェントアプリアクティビティがない場合は省略されます。
メトリックフィールドエージェントアプリ参照してください。
`totals_by_ide`	`array`	いいえ	ユーザーのアクティビティのIDEごとの内訳。
「アクティビティの内訳オブジェクト」を参照してください。
`totals_by_feature`	`array`	いいえ	ユーザーのアクティビティの機能ごとの内訳。
「アクティビティの内訳オブジェクト」を参照してください。
`totals_by_language_feature`	`array`	いいえ	言語と特徴のディメンションを組み合わせた内訳。
「アクティビティの内訳オブジェクト」を参照してください。
`totals_by_language_model`	`array`	いいえ	チャットアクティビティの言語とモデルのディメンションを組み合わせた内訳。
「アクティビティの内訳オブジェクト」を参照してください。
`totals_by_model_feature`	`array`	いいえ	チャットアクティビティのモデルと機能のディメンションを組み合わせた内訳。
「アクティビティの内訳オブジェクト」を参照してください。

集約されたエンタープライズおよび組織のレポートフィールド

集約されたレポートには、企業または組織ごとに 1 つのレコードが含まれています。その日のすべてのユーザーが集計されます。アクティブユーザー数には、クライアント側テレメトリとサーバー側テレメトリの両方で識別されるユーザーが含まれます。サーバー側のテレメトリによってのみ表示されるユーザーは、アクティブユーザーの合計でカウントされますが、ディメンションの内訳配列 (totals_by_ide、 totals_by_featureなど) には表示されない場合があります。次の表に、アクティブユーザー数、アクティビティの合計、および内訳を示します。

アクティブユーザー数:

フィールド	タイプ	ヌラブル	Description
`daily_active_users`	`integer`	いいえ	特定の日に Copilot を使用した一意のユーザーの数 ( Copilot アプリでのみアクティブなユーザーを含む)。
`weekly_active_users`	`integer`	いいえ	末尾の 7 日間に Copilot を使用した一意のユーザーの数 ( Copilot アプリでのみアクティブなユーザーを含む)。
`monthly_active_users`	`integer`	いいえ	後続の 28 日間に Copilot を使用した一意のユーザーの数 ( Copilot アプリでのみアクティブなユーザーを含む)。
`monthly_active_chat_users`	`integer`	いいえ	末尾の 28 日間にチャットを使用した一意のユーザーの数。
`monthly_active_agent_users`	`integer`	いいえ	後続の 28 日間にエージェントモードを使用した一意のユーザーの数。
`daily_active_copilot_cloud_agent_users`	`integer`	いいえ	特定の日に Copilot クラウドエージェントを使用した一意のユーザーの数。
`weekly_active_copilot_cloud_agent_users`	`integer`	いいえ	末尾の 7 日間に Copilot クラウドエージェントを使用した一意のユーザーの数。
`monthly_active_copilot_cloud_agent_users`	`integer`	いいえ	末尾の 28 日間に Copilot クラウドエージェントを使用した一意のユーザーの数。
`daily_active_copilot_code_review_users`	`integer`	いいえ	特定の日に Copilotコードレビューをアクティブに使用した一意のユーザーの数。アクティブな使用とは、レビューを手動で要求するか、提案を適用することを意味します。ユーザーが同じ期間にアクティブ信号とパッシブ信号の両方を持っている場合、それらはアクティブのみとしてカウントされます。
`weekly_active_copilot_code_review_users`	`integer`	いいえ	末尾の 7 日間に Copilotコードレビューをアクティブに使用した一意のユーザーの数。ユーザーが同じ期間にアクティブ信号とパッシブ信号の両方を持っている場合、それらはアクティブのみとしてカウントされます。
`monthly_active_copilot_code_review_users`	`integer`	いいえ	後続の 28 日間に Copilotコードレビューをアクティブに使用した一意のユーザーの数。ユーザーが同じ期間にアクティブ信号とパッシブ信号の両方を持っている場合、それらはアクティブのみとしてカウントされます。
`daily_passive_copilot_code_review_users`	`integer`	いいえ	特定の日に、プルリクエストのレビュー担当として自動的に Copilotコードレビューが割り当てられたものの、実際にレビューを行わなかったユニークユーザー数。
`weekly_passive_copilot_code_review_users`	`integer`	いいえ	過去 7 日間の期間中に、プルリクエストのレビュー担当として自動的に Copilotコードレビューが割り当てられたものの、実際の活動が見られないユニークユーザー数。
`monthly_passive_copilot_code_review_users`	`integer`	いいえ	過去 28 日間の期間中に、プルリクエストのレビュー担当として自動的に Copilotコードレビューが割り当てられたものの、実際の活動が見られないユニークユーザー数。
`daily_active_cli_users`	`integer`	イエス	特定の日に Copilot CLI (コパイロット CLI) を使用した一意のユーザーの数。この数は IDE のアクティブユーザー数に依存せず、IDE ベースのアクティブユーザー定義には含まれません。その日に CLI を使用しない企業または組織では省略されます。
`daily_active_copilot_app_users`	`integer`	イエス	特定の日に Copilot アプリを使用した一意のユーザーの数。エンタープライズレポートのみ。その日に企業に Copilot アプリアクティビティがない場合は null。

アクティビティの合計と内訳:

フィールド	タイプ	ヌラブル	Description
`user_initiated_interaction_count`	`integer`	いいえ	1 日のすべてのユーザーに対して Copilot に送信された明示的なプロンプトの合計数。
`code_generation_activity_count`	`integer`	いいえ	その日のすべてのユーザーに対して生成された個別の Copilot 出力イベントの合計数。
`code_acceptance_activity_count`	`integer`	いいえ	1 日のすべてのユーザーに対して受け入れられた提案またはコードブロックの合計数。
`loc_suggested_to_add_sum`	`integer`	いいえ	その日に追加が提案されたコード行数の合計。ユーザーごとのフィールドと同じ定義。
`loc_suggested_to_delete_sum`	`integer`	いいえ	その日の削除が推奨される、集計されたコード行。ユーザーごとのフィールドと同じ定義。
`loc_added_sum`	`integer`	いいえ	その日の追加コード行数の合計ユーザーごとのフィールドと同じ定義。
`loc_deleted_sum`	`integer`	いいえ	当日に削除されたコード行数の合計。ユーザーごとのフィールドと同じ定義。
`totals_by_ide`	`array`	いいえ	IDE ごとのアクティビティの内訳の集計。
「アクティビティの内訳オブジェクト」を参照してください。
`totals_by_feature`	`array`	いいえ	機能ごとのアクティビティの内訳の集計。
「アクティビティの内訳オブジェクト」を参照してください。
`totals_by_language_feature`	`array`	いいえ	集計された言語と機能のアクティビティの内訳。
「アクティビティの内訳オブジェクト」を参照してください。
`totals_by_language_model`	`array`	いいえ	集計された言語とモデルのアクティビティの内訳。
「アクティビティの内訳オブジェクト」を参照してください。
`totals_by_model_feature`	`array`	いいえ	集計されたモデルと機能の活動内訳。
「アクティビティの内訳オブジェクト」を参照してください。
`totals_by_cli`	`object`	イエス	その日の集計された Copilot CLI (コパイロット CLI) メトリック。その日に CLI の使用がない場合は省略されます。ユーザーごとのフォームとは異なり、 `last_known_cli_version`は含まれません。
メトリックフィールドCopilot CLI (コパイロット CLI)参照してください。
`totals_by_copilot_app`	`object`	イエス	その日の集計された Copilot アプリメトリック。エンタープライズレポートのみ。その日に企業に Copilot アプリアクティビティがない場合は null。
メトリックフィールドCopilot アプリ参照してください。
`totals_by_3rd_party_agent`	`array`	イエス	認識されたエージェントアプリのエージェントごとの使用状況メトリックの集計。その日、企業または組織が認識エージェントアプリアクティビティがない場合は省略されます。
メトリックフィールドエージェントアプリ参照してください。
`totals_by_ai_adoption_phase`	`array`	イエス	ユーザーとその平均アクティビティのフェーズごとの集計。導入フェーズのデータが使用できない場合は省略されます。
AI 導入フェーズのフィールドを参照してください。
`pull_requests`	`object`	いいえ	企業または組織の毎日のプルリクエスト活動。
Pull request アクティビティフィールドを参照してください。

28日間レポートのフィールド

28 日間のレポート (enterprise-28-day と org-28-day) はラッパーであり、最上位レベルのレポートウィンドウと、毎日集計されたレコードの配列を保持します。

フィールド	タイプ	ヌラブル	Description
`report_start_day`	`string`	いいえ	28 日間のレポート期間の最初の暦日（`YYYY-MM-DD`形式）。
`report_end_day`	`string`	いいえ	28 日間のレポートウィンドウの最後のカレンダー日 ( `YYYY-MM-DD` 形式)。
`created_at`	`string`	いいえ	レポートが生成されたときのタイムスタンプ (ISO 8601)。
`day_totals`	`array`	いいえ	日次集計レコードの配列。各エントリには、集計された 1 日レポートと同じフィールドがあります。
集約されたエンタープライズおよび組織のレポートフィールドを参照してください。

ユーザーチームのフィールド

これらのフィールドは、毎日のユーザーチームレポート (組織およびエンタープライズスコープの REST API を介して利用可能) に表示され、ユーザーごとの使用状況メトリックレポートと結合してチームレベルのメトリックを構築するために使用されます。完全な結合レシピとエンドポイント URL については、チームレベルのCopilot使用状況メトリックを参照してください。

特定の日に座っている Copilot ユーザーが 5 人未満のチームは、ユーザーチームレポートから除外されます。

フィールド	タイプ	ヌラブル	Description
`user_id`	`integer`	いいえ	ユーザーを表す一意の識別子です。
`user_login`	`string`	いいえ
GitHub ユーザーのユーザー名。
`day`	`string`	いいえ	このレコードが表すカレンダーの日。
`organization_id`	`string`	いいえ	チームが属している組織の一意の ID。組織の範囲のみ。
`enterprise_id`	`string`	いいえ	チームが属している企業の一意の ID。エンタープライズスコープのみ。エンタープライズスコープのレポートには、エンタープライズチームとビジネスチームの両方が含まれます。
`team_id`	`integer`	いいえ	ユーザーが属しているチームの一意の ID。
`slug`	`string`	いいえ	チームの URL フレンドリ識別子。

リポジトリレベルのフィールド (API のみ)

リポジトリレベルのレポートには、組織または企業のリポジトリの毎日のプル要求の作成、レビュー、マージ、および提案アクティビティが表示されます。これには、 Copilot クラウドエージェントによって作成され、 Copilotコードレビューによってレビューされた pull request が含まれます。各行は、要求された日にプル要求アクティビティを行った 1 つのリポジトリを表します。アクティビティのないリポジトリは省略されます。これらのレポートは、プル要求のライフサイクルアクティビティに重点を置き、IDE の使用状況メトリックがない場合でもデータを含めることができます。

これらのフィールドは、組織およびエンタープライズスコープの REST API を介して使用できる日次リポジトリレベルのレポート (repos-1-day) によって返されます。エンドポイント URL、応答エンベロープ、アクセス許可、ダウンロードワークフローについては、 Copilot使用状況メトリックの REST API エンドポイントを参照してください。行の例については、 AUTOTITLE を参照してください。

フィールド	タイプ	ヌラブル	Description
`day`	`string`	いいえ	このレコードが表すカレンダーの日付 ( `YYYY-MM-DD` 形式)。
`enterprise_id`	`string`	いいえ	企業の一意の ID。エンタープライズスコープのレポート、そのエンタープライズが所有する組織の組織スコープのレポートに反映されます。企業が所有していない組織の場合は空です。
`organization_id`	`string`	いいえ	リポジトリを所有する組織の一意の ID。エンタープライズスコープレポートと組織スコープレポートの両方に含まれます。
`repo_id`	`integer`	いいえ	リポジトリの一意の ID。
`repo_owner_name`	`string`	いいえ	リポジトリ所有者のログイン。
`repo_name`	`string`	いいえ	リポジトリ名。
`repo_visibility`	`string`	いいえ	リポジトリの可視性。指定できる値は、`PRIVATE`、`INTERNAL`、`PUBLIC` です。
`pull_requests`	`object`	いいえ	リポジトリの毎日のプル要求アクティビティ。
Pull request アクティビティフィールドを参照してください。

アクティビティの内訳オブジェクト

totals_by_*フィールドは、ブレークダウンオブジェクトの配列です。配列は常に存在しますが、空にすることができます。各オブジェクト内で、メトリックフィールド (*_count と loc_*_sum) は、ユーザーごとの最上位レベルのフィールドと同じ定義に従い、ディメンションフィールドには内訳ディメンションの値に記載されている値が含まれます。

オブジェクト	ディメンションフィールド	Description
`totals_by_ide[]`	`ide`	IDE 別の内訳。ユーザーごとのレポートでは、各エントリには `last_known_ide_version` と `last_known_plugin_version`も含まれます。
`totals_by_feature[]`	`feature`
Copilot機能別の内訳 (インラインチャットやチャットパネルなど)。
`totals_by_language_feature[]`
`language`、`feature`	言語と機能を組み合わせた内訳。
`user_initiated_interaction_count`は含まれません。
`totals_by_language_model[]`
`language`、`model`	チャットアクティビティの言語とモデルを組み合わせた内訳（コンプリーションではありません）。
`totals_by_model_feature[]`
`model`、`feature`	チャットアクティビティの、モデルと機能の組み合わせによる内訳（completions ではありません）。

ユーザーごとのレポートでは、各 totals_by_ide[] エントリは、ユーザーに対して最近検出された IDE とコパイロットチャット拡張機能のバージョンも報告します。

フィールド	タイプ	ヌラブル	Description
`last_known_ide_version`	`object`	イエス	ユーザーに対して検出された最新の IDE バージョン ( `{ ide_version, sampled_at }`)。上限が設定された「その他」のI DE バケットなど、集計された内訳行については省略されます。
`last_known_ide_version.ide_version`	`string`	いいえ	IDE バージョン文字列。
`last_known_ide_version`が存在する場合に表示されます。
`last_known_ide_version.sampled_at`	`string`	イエス	バージョンのサンプリング時のタイムスタンプ (ISO 8601)。
`last_known_plugin_version`	`object`	イエス	このユーザーについて検出された最新の Copilot 拡張機能は、`{ plugin, plugin_version, sampled_at }` です。集計された内訳行の場合は省略されます。
`last_known_plugin_version.plugin`	`string`	いいえ	拡張機能の名前 ( `copilot` や `copilot-chat`など)。
`last_known_plugin_version`が存在する場合に表示されます。
`last_known_plugin_version.plugin_version`	`string`	いいえ	拡張機能のバージョン文字列。
`last_known_plugin_version`が存在する場合に表示されます。
`last_known_plugin_version.sampled_at`	`string`	イエス	バージョンのサンプリング時のタイムスタンプ (ISO 8601)。

Copilot CLI (コパイロット CLI) メトリックフィールド

totals_by_cli オブジェクトには、Copilot CLI (コパイロット CLI)使用が存在する場合は、次の入れ子になったフィールドが含まれます。CLI の使用がない場合、オブジェクトは省略されます。 CLI の使用は IDE メトリックとは無関係であり、**** やtotals_by_ideなどのフィールドには反映totals_by_feature。 last_known_cli_version オブジェクトは、ユーザーごとのレポートにのみ表示されます。

フィールド	タイプ	ヌラブル	Description
`totals_by_cli.session_count`	`integer`	いいえ	この日に開始された個別の CLI セッションの数。
`totals_by_cli.request_count`	`integer`	いいえ	この日に CLI を介して Copilot された要求の合計数 (ユーザーが開始したプロンプトとエージェントの自動フォローアップ呼び出しの両方を含む)。
`totals_by_cli.prompt_count`	`integer`	いいえ	セッション内で実行されたユーザープロンプト、コマンド、またはクエリの合計数。
`totals_by_cli.token_usage.output_tokens_sum`	`integer`	いいえ	この日のすべての CLI 要求で生成された出力トークンの合計数。
`totals_by_cli.token_usage.prompt_tokens_sum`	`integer`	いいえ	この日のすべての CLI 要求で送信されたプロンプトトークンの合計数。
`totals_by_cli.token_usage.avg_tokens_per_request`	`number`	イエス
**
として計算された CLI 要求あたりの出力**トークンと`(output_tokens_sum + prompt_tokens_sum) ÷ request_count` トークンの平均数。その日に要求がなかった場合は Null。
`totals_by_cli.last_known_cli_version`	`object`	いいえ	その日にそのユーザーに対して検出された最新のCopilot CLI (コパイロット CLI)バージョン（`{ cli_version, sampled_at }`として）ユーザーごとのレポートのみ。
`totals_by_cli.last_known_cli_version.cli_version`	`string`	いいえ
Copilot CLI (コパイロット CLI) バージョン文字列。バージョンが検出されなかった場合、デフォルトでは `unknown` になります。
`totals_by_cli.last_known_cli_version.sampled_at`	`string`	イエス	バージョンのサンプリング時のタイムスタンプ (ISO 8601)。

Copilot アプリメトリックフィールド

totals_by_copilot_app オブジェクトには、Copilot アプリ使用が存在する場合に、次の入れ子になったフィールドが含まれます。これは、ユーザーごとのレポートと集約されたエンタープライズレポートに表示されます。ユーザーまたは企業がその日に Copilot アプリアクティビティを持っていない場合は、省略されるか null になります。 totals_by_cliとは異なり、Copilot アプリコーディングアクティビティは、totals_by_feature機能の値の下のtotals_by_model_feature、totals_by_language_feature、totals_by_language_model、およびcopilot_app、および最上位のコードアクティビティとコード行のメトリックにも反映されます。 last_known_app_version フィールドはありません。

フィールド	タイプ	ヌラブル	Description
`totals_by_copilot_app.session_count`	`integer`	いいえ	この日に開始された個別の Copilot アプリセッションの数。
`totals_by_copilot_app.request_count`	`integer`	いいえ	ユーザーが開始したプロンプトと自動エージェントフォローアップ呼び出しの両方を含む、この日にCopilot経由でCopilot アプリされた要求の合計数。
`totals_by_copilot_app.prompt_count`	`integer`	いいえ	セッション内で実行されたユーザープロンプト、コマンド、またはクエリの合計数。
`totals_by_copilot_app.token_usage.output_tokens_sum`	`integer`	いいえ	この日のすべての Copilot アプリ要求で生成された出力トークンの合計数。
`totals_by_copilot_app.token_usage.prompt_tokens_sum`	`integer`	いいえ	この日のすべての Copilot アプリ要求に対して送信されたプロンプトトークンの合計数。
`totals_by_copilot_app.token_usage.avg_tokens_per_request`	`number`	イエス
Copilot アプリとして計算`(output_tokens_sum + prompt_tokens_sum) ÷ request_count`要求あたりの出力トークンとプロンプトトークンの平均。その日に要求がなかった場合は Null。

エージェントアプリメトリックフィールド

totals_by_3rd_party_agent配列には、レポート期間中に使用された認識されたエージェントアプリごとに 1 つのエントリが含まれています。エントリは agent_idごとにグループ化され、同じエージェントにマップされる統合が結合されます。 agent_idを安定したグループ化キーとして使用し、表示用のagent_nameとして使用します。レポート期間中に認識されたエージェントアプリアクティビティが使用できない場合、配列は省略されます。

これらのメトリックは、サーバー側のジョブアクティビティから取得されます。入れ子になった user_initiated_interaction_count は、ジョブの開始エージェントアプリカウントされ、同じ名前の最上位フィールドとは異なります。これは、サポートされている他のテレメトリからの明示的なプロンプトをカウントします。

フィールド	タイプ	ヌラブル	Description
`totals_by_3rd_party_agent[].agent_name`	`string`	いいえ
エージェントアプリの表示名。名前は変更される可能性があるため、グループ化には `agent_id` を使用します。
`totals_by_3rd_party_agent[].agent_id`	`string`	いいえ
エージェントアプリの安定した識別子。
`totals_by_3rd_party_agent[].user_initiated_interaction_count`	`integer`	いいえ	レポート期間中にエージェントアプリに対して開始されたユーザー開始ジョブの数。ジョブの開始ごとにカウントが 1 回インクリメントされます。
`totals_by_3rd_party_agent[].session_count`	`integer`	いいえ	レポート期間中にエージェントにマップされた統合の個別の空でないセッション数の合計。集約された企業および組織のレポートにのみ含まれます。は、ユーザーごとのレポートから省略されます。

プル要求のアクティビティフィールド

重要

組織レベルとエンタープライズレベルのレポートでは、ユーザー重複除去と属性のタイミングの違いにより、合計が異なる場合があります。スコープ間でのプル要求メトリックの解釈に関するガイダンスについては、 GitHub Copilot 使用状況メトリクスを参照してください。

pull_requests オブジェクトは、集約されたエンタープライズレポートと組織レポート、およびリポジトリレベルのレポートに表示されます。毎日のプル要求の作成、レビュー、マージ、提案アクティビティ ( Copilot クラウドエージェントと Copilotコードレビューによって実行されたアクティビティを含む) がキャプチャされます。

フィールド	タイプ	ヌラブル	Description
`pull_requests.total_created`	`integer`	いいえ	この特定の日に作成されたプル要求の合計数。作成は 1 回限りのイベントです。各プル要求は、作成日にのみカウントされます。
`pull_requests.total_reviewed`	`integer`	いいえ	この特定の日にレビューされたプル要求の合計数。同じプル要求は、複数の日にレビューを受け取った場合、複数の日にカウントされる可能性があります。 1 日以内に、複数のレビューアクションが発生した場合でも、各プル要求が 1 回カウントされます。
`pull_requests.total_merged`	`integer`	いいえ	この特定の日にマージされたプルリクエストの合計数。マージは 1 回限りのイベントです。各プル要求は、マージされた日にのみカウントされます。
`pull_requests.median_minutes_to_merge`	`number`	イエス	この特定の日にマージされたプル要求の場合、プル要求の作成からマージまでの中央値 (分単位)。中央値は、異常に実行時間の長いプル要求からの外れ値の影響を軽減するために使用されます。その日にマージされたプル要求がない場合は、Null となります。
`pull_requests.total_suggestions`	`integer`	いいえ	作成者に関係なく、この特定の日に生成されたプル要求レビュー候補の合計数。
`pull_requests.total_applied_suggestions`	`integer`	いいえ	作成者に関係なく、この特定の日に適用されたプル要求レビュー候補の合計数。
`pull_requests.total_created_by_copilot`	`integer`	いいえ	この特定の日に Copilot クラウドエージェントによって作成されたプル要求の数。
`pull_requests.total_reviewed_by_copilot`	`integer`	いいえ	この特定の日に Copilotコードレビューによってレビューされたプル要求の数。プル要求は、 Copilotコードレビューが複数の日にレビューした場合、複数の日にカウントされる可能性があります。
`pull_requests.total_merged_created_by_copilot`	`integer`	いいえ	この特定の日にマージされた Copilot クラウドエージェントによって作成されたプル要求の数。各プル要求は、マージされた日にのみカウントされます。
`pull_requests.total_merged_reviewed_by_copilot`	`integer`	いいえ	レポート期間中に Copilotコードレビューによってマージおよびレビューされたプル要求の数。
`pull_requests.median_minutes_to_merge_copilot_authored`	`number`	イエス
Copilot クラウドエージェントによって作成され、この特定の日にマージされたプルリクエストの、作成からマージまでの中央値（分単位）。その日、そのようなプルリクエストが1件もマージされなかった場合はnullです。
`pull_requests.median_minutes_to_merge_copilot_reviewed`	`number`	イエス	プル要求の作成とマージの間の中央値 (分単位) は、 Copilotコードレビューによってレビューされたプル要求に対してのみ計算されます。その日、そのようなプルリクエストが1件もマージされなかった場合はnullです。
`pull_requests.total_copilot_suggestions`	`integer`	いいえ	この特定の日に Copilotコードレビューによって生成された pull request レビュー候補の数。
`pull_requests.total_copilot_applied_suggestions`	`integer`	いいえ	この特定の日に適用された Copilotコードレビューによって生成された pull request レビューの提案の数。
`pull_requests.copilot_suggestions_by_comment_type`	`array`	いいえ	割り当てられたコメントの種類 (Copilotコードレビューや`security`など) で分類された`bug_risk`候補の集計数。各エントリには、 `comment_type`、 `total_copilot_suggestions`、および `total_copilot_applied_suggestions`が含まれます。常に存在しますが、空にすることができます。

AI 導入フェーズの分野

Copilot は、ユーザーのアクティビティに基づいて AI 導入フェーズにユーザーをグループ化します。フェーズ情報は、ユーザーごとの ai_adoption_phase オブジェクトと集計された totals_by_ai_adoption_phase 配列の 2 つの場所に表示されます。フェーズの値については、内訳の分析コード値を参照してください。

分類ロジック

ユーザーは、後続の 28 日間の期間内に、少なくとも used_*にユーザーごとのフィールド (ユーザーごとのレポートフィールドを参照) がtrueされる**** に基づいてフェーズに分類されます。

Phase	表面条件
コーホートなし (影響ダッシュボードに "パッシブユーザー" として表示されます)	ユーザーは、ウィンドウ内のどのフェーズでも 2 日間のエンゲージメントしきい値を満たしていません。
フェーズ 1: 最初にコードを記述する
`used_chat`が`true`、`code_acceptance_activity_count`が`0`より大きい、または`used_agent`が`true`されている少なくとも 2 つのアクティブな日。
フェーズ 2: エージェント優先	1 つのGitHubベースのエージェントサーフェスが使用された少なくとも 2 つのアクティブな日:`used_cli`が`true`、`used_copilot_cloud_agent`が`true`、または`used_copilot_code_review_active`が`true`。パッシブ Copilotコードレビューアクティビティ (`used_copilot_code_review_passive`) は、フェーズ分類にはカウントされません。
フェーズ 3: マルチエージェント	フェーズ 2 に記載されている 2 つ以上のGitHubベースのエージェントサーフェスが使用された少なくとも 2 つのアクティブな日。

ユーザーは、そのフェーズに到達するために、フェーズ独自の条件に対して 2 つの条件を満たす日のみを必要とします。ユーザーはフェーズ 2 またはフェーズ 3 に到達するためにフェーズ 1 の条件を個別に満たす必要はありませんが、実際には、ほとんどのエージェントサーフェスの使用は完了またはチャットアクティビティと共に発生します。

フェーズの割り当ては、末尾の 28 日間のウィンドウを使用して毎日再計算されるため、ユーザーのフェーズは、ウィンドウ内のアクティビティが変化するにつれて 1 日から次の日に変更できます。これは予期される動作であり、データエラーを示すものではありません。

ユーザーごとの ai_adoption_phase オブジェクトには、次のものが含まれます。

フィールド	タイプ	ヌラブル	Description
`ai_adoption_phase.phase_number`	`integer`	いいえ	数値フェーズ識別子 ("No Cohort" の `0` など)。
`ai_adoption_phase.phase`	`string`	いいえ	人間が判読できるフェーズ名。
`ai_adoption_phase.version`	`string`	いいえ	使用される導入フェーズモデルのバージョン (たとえば、 `v1`)。

集計された totals_by_ai_adoption_phase 配列内の各エントリには、次のものが含まれます。

フィールド	タイプ	ヌラブル	Description
`phase`	`string`	いいえ	人間が判読できるフェーズ名。
`phase_number`	`integer`	いいえ	数値フェーズ識別子。
`total_engaged_users`	`integer`	いいえ	期間にこのフェーズにグループ化されたユーザーの数。
`avg_user_initiated_interactions`	`number`	いいえ	このフェーズにおける、ユーザー1人当たりのユーザー開始インタラクションの平均回数。
`avg_code_generation_activities`	`number`	いいえ	このフェーズのユーザーあたりの平均コード生成アクティビティ。
`avg_code_acceptance_activities`	`number`	いいえ	このフェーズのユーザーあたりの平均コード受け入れアクティビティ。
`avg_loc_added`	`number`	いいえ	このフェーズでユーザーごとに追加されたコードの平均行。
`avg_loc_deleted`	`number`	いいえ	このフェーズでユーザーごとに削除されたコードの平均行数。
`avg_pull_requests_reviewed`	`number`	いいえ	このフェーズでユーザーごとに確認された平均プル要求数。
`avg_pull_requests_created`	`number`	いいえ	このフェーズでユーザーごとに作成された平均プル要求数。
`avg_pull_requests_merged`	`number`	いいえ	このフェーズにおけるユーザーごとのマージ済みプルリクエストの平均数。
`total_pull_requests_merged`	`integer`	いいえ	このフェーズでユーザーによってマージされたプル要求の合計数。組織日別およびエンタープライズ日別の集計レポートに適用されます。
`avg_pull_requests_median_minutes_to_merge`	`number`	いいえ	このフェーズの各ユーザーにおける、マージまでの時間（分）の中央値の平均。

内訳の分析コード値

上記のブレークダウンオブジェクトでは、固定セットからの値を持つディメンションフィールドが使用されます。これらはフィールド値であり、個別のフィールドではありません。たとえば、 agent_edit と chat_panel_*_mode の値は、最上位のフィールドではなく、 feature フィールドの値です。

featureディメンションは、アクティビティが属性付けされるCopilot機能またはモードを識別します。

価値	Description
`code_completion`	インラインコード補完。
`chat_inline`	エディターでのインラインチャット。
`chat_panel_ask_mode`	Ask モードを選択した状態でのチャットパネルの操作。
`chat_panel_edit_mode`	編集モードが選択されたチャットパネルの操作。
`chat_panel_agent_mode`	エージェントモードが選択されたチャットパネルの操作。
`chat_panel_plan_mode`	プランモード選択時のチャットパネルの操作。
`chat_panel_custom_mode`	選択したカスタムエージェントとのチャットパネルの操作。
`chat_panel_unknown_mode`	モードが不明なチャットパネルの操作。
`agent_edit`
Copilot (エージェントおよび編集モード) で IDE 内のファイルに変更を直接書き込むと、行が追加および削除されます。カスタムエージェントからの編集もカウントします。
`agent_edit` は提案ベースのメトリックには含まれません。また、 `user_initiated_interaction_count`など、提案スタイルのフィールドを設定することはできません。
`copilot_cli`
Copilot CLI (コパイロット CLI)に起因するアクティビティ。
`copilot_app`
Copilot アプリに起因するアクティビティ。
`others`	上記の値でカバーされていない機能。

ide ディメンションは、アクティビティが発生した IDE を識別します。これは網羅的なリストではありませんが、観察される値の例には、 vscode、 visualstudio、 intellij、 eclipse、 xcode、 neovim、 vim、 emacs、および zedが含まれます。

model ディメンションは、チャットアクティビティに使用される AI モデルを識別します。値には、特定のモデル識別子 ( gpt-5.4 や claude-sonnet-4.6など)、 auto、 unknown、 othersが含まれます。 auto値は、自動モデルの選択が使用され、要求が特定のモデルに属性付けされなかったアクティビティを表します。

phaseディメンションは、ユーザーがグループ化される AI 導入フェーズ (No Cohort、Phase 1、Phase 2、またはPhase 3) を識別します。