Skip to content

Commit 4d8c883

Browse files
authored
add ai_credits_used and update schema output
1 parent c9bd77a commit 4d8c883

2 files changed

Lines changed: 13 additions & 11 deletions

File tree

content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -111,6 +111,9 @@ Per-user reports contain one record per user for the reporting period. The 28-da
111111
| `used_copilot_code_review_active` | `boolean` | Yes | Whether the user actively engaged with {% data variables.copilot.copilot_code-review_short %} that day. A user is considered active if they manually requested a {% data variables.product.prodname_copilot_short %} review, or applied a {% data variables.product.prodname_copilot_short %} review suggestion. Null when there is no {% data variables.copilot.copilot_code-review_short %} signal for the user that day. |
112112
| `used_copilot_code_review_passive` | `boolean` | Yes | Whether the user had {% data variables.product.prodname_copilot_short %} automatically assigned to review their pull request that day, without actively engaging with the review. Null when there is no {% data variables.copilot.copilot_code-review_short %} signal for the user that day. |
113113
| `ai_adoption_phase` | `object` | No | The user's AI adoption phase for the day. Always present; defaults to the "No Cohort" phase. See [AI adoption phase fields](#ai-adoption-phase-fields). |
114+
| `ai_credits_used` | `number` | No | Total AI credits consumed by the user on this day. |
115+
| `used_copilot_cloud_agent` | `boolean` | No | Whether the user used Copilot cloud agent that day. |
116+
| `used_copilot_coding_agent` | `boolean` | No | Whether the user used Copilot cloud agent that day. Carries the same value as `used_copilot_cloud_agent`; both names are retained for backward compatibility. |
114117
| `totals_by_cli` | `object` | Yes | CLI-specific metrics for the user. Omitted when the user had no {% data variables.copilot.copilot_cli_short %} usage that day. See [{% data variables.copilot.copilot_cli_short %} metrics fields](#copilot-cli-metrics-fields). |
115118
| `totals_by_ide` | `array` | No | Per-IDE breakdown of the user's activity. See [Activity breakdown objects](#activity-breakdown-objects). |
116119
| `totals_by_feature` | `array` | No | Per-feature breakdown of the user's activity. See [Activity breakdown objects](#activity-breakdown-objects). |

content/copilot/reference/copilot-usage-metrics/example-schema.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -85,12 +85,17 @@ The following are example schemas for the user-level and enterprise-level data r
8585
"used_agent": false,
8686
"used_chat": false,
8787
"used_cli": true,
88+
"used_copilot_coding_agent": false,
89+
"used_copilot_cloud_agent": false,
90+
"ai_adoption_phase": {
91+
"phase_number": 2,
92+
"phase": "Phase 2",
93+
"version": "v1"
94+
},
8895
"user_id": 1,
8996
"user_login": "login1",
9097
"user_initiated_interaction_count": 0,
91-
"etl_id": "green",
92-
"day_partition": "2025-10-01",
93-
"entity_id_partition": 1
98+
"ai_credits_used": 500
9499
}]
95100
```
96101

@@ -175,10 +180,7 @@ The following are example schemas for the user-level and enterprise-level data r
175180
} ],
176181
"enterprise_id" : "1",
177182
"report_end_day" : "2025-10-01",
178-
"report_start_day" : "2025-09-04",
179-
"etl_id" : "green",
180-
"day_partition" : "2025-10-01",
181-
"entity_id_partition" : 1
183+
"report_start_day" : "2025-09-04"
182184
}, {
183185
"day_totals" : [ {
184186
"code_acceptance_activity_count" : 1,
@@ -243,10 +245,7 @@ The following are example schemas for the user-level and enterprise-level data r
243245
} ],
244246
"enterprise_id" : "2",
245247
"report_end_day" : "2025-10-01",
246-
"report_start_day" : "2025-09-04",
247-
"etl_id" : "green",
248-
"day_partition" : "2025-10-01",
249-
"entity_id_partition" : 2
248+
"report_start_day" : "2025-09-04"
250249
} ]
251250
```
252251

0 commit comments

Comments
 (0)