You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/copilot/concepts/agents/copilot-cli/rubber-duck.md
-3Lines changed: 0 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,9 +20,6 @@ Rubber duck is a built-in agent in {% data variables.copilot.copilot_cli %} that
20
20
21
21
The rubber duck agent is designed to review proposed changes, not to make file changes itself. The main agent for the session decides what to do with the feedback.
22
22
23
-
> [!NOTE]
24
-
> The rubber duck agent is currently only available if the main agent is using a Claude or GPT large language model.
25
-
26
23
## Why "rubber duck"?
27
24
28
25
The name comes from a long-standing technique in software engineering called **rubber ducking** in which you explain your code, or proposed solution, to an inanimate object—traditionally a rubber duck. The idea is that by articulating your thinking, you often uncover mistakes, misunderstandings, or logical flaws.
Copy file name to clipboardExpand all lines: content/copilot/concepts/agents/copilot-memory.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ We typically refer to these repository-level facts and user-level preferences as
33
33
34
34
## Feature availability
35
35
36
-
{% data variables.copilot.copilot_memory %} is currently used by {% data variables.copilot.copilot_cloud_agent %}, {% data variables.copilot.copilot_code-review_short %}, and {% data variables.copilot.copilot_cli_short %}.
36
+
{% data variables.copilot.copilot_memory %} is currently used by {% data variables.copilot.copilot_cloud_agent %}, {% data variables.copilot.copilot_code-review_short %}, {% data variables.copilot.copilot_cli_short %}, and agentic autofix.
37
37
38
38
Facts and preferences captured by one {% data variables.product.prodname_copilot_short %} feature can be used by another. For example, if {% data variables.copilot.copilot_cloud_agent %} discovers how your repository handles database connections, {% data variables.copilot.copilot_code-review_short %} can later apply that knowledge to spot inconsistent patterns in a pull request. Similarly, if {% data variables.copilot.copilot_code-review_short %} learns that certain settings must stay synchronized across two files, {% data variables.copilot.copilot_cloud_agent %} will know to update both files when changing one.
Copy file name to clipboardExpand all lines: content/copilot/how-tos/github-copilot-app/agent-sessions.md
-3Lines changed: 0 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -91,9 +91,6 @@ The rubber duck agent is a built-in agent that acts as a constructive critic, re
91
91
92
92
When rubber duck is enabled, {% data variables.product.prodname_copilot_short %} can consult it automatically at key points while it works. The main session agent passes work to the rubber duck agent, receives the critique, then decides how to apply that feedback before continuing.
93
93
94
-
> [!NOTE]
95
-
> The rubber duck agent is currently only available if the main agent is using a Claude or GPT large language model.
96
-
97
94
You can also manually ask {% data variables.product.prodname_copilot_short %} to get a review from the rubber duck agent.
Copy file name to clipboardExpand all lines: content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md
+26-4Lines changed: 26 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -90,17 +90,15 @@ Organization-scope reports also include `organization_id` alongside `enterprise_
90
90
91
91
The **Type** column uses JSON Schema types: `string`, `integer`, `number`, `boolean`, `array`, and `object`. The **Nullable** column indicates whether a field's value can be `null` or absent from a record where it would otherwise apply. Activity breakdown arrays are always present but can be empty (`[]`). Optional arrays are marked as nullable and can be absent.
92
92
93
-
### Report identification and partition fields
93
+
### Report identification fields
94
94
95
-
These fields identify the scope, date, and (for exports) partition of each record. The exact set present depends on the report shape.
95
+
These fields identify the scopeand date of each record. The exact set present depends on the report shape.
96
96
97
97
| Field | Type | Nullable | Description |
98
98
|:--|:--|:--|:--|
99
99
|`day`|`string`| No | Calendar day this record represents, in `YYYY-MM-DD` format. In 28-day reports, `day` appears within each `day_totals` entry rather than at the top level. |
100
100
|`enterprise_id`|`string`| No | Unique ID of the enterprise. Included in both enterprise- and organization-scope reports. |
101
101
|`organization_id`|`string`| Yes | Unique ID of the organization. Included in organization-scope reports only; omitted from enterprise-scope reports. |
102
-
|`etl_id` / `day_partition`|`string`| No | Partition fields used for housekeeping. Included in exported NDJSON files and returned by the usage metrics APIs. |
103
-
|`entity_id_partition`|`integer`| No | Entity partition used for housekeeping. Included in exported NDJSON files and returned by the usage metrics APIs. |
104
102
105
103
### Per-user report fields
106
104
@@ -126,6 +124,7 @@ Per-user reports contain one record per user for the reporting period. The 28-da
126
124
|`used_copilot_cloud_agent`|`boolean`| No | Whether the user used {% data variables.copilot.copilot_cloud_agent %} that day. Carries the same value as `used_copilot_coding_agent`; both names are retained for backward compatibility. |
127
125
|`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. |
128
126
|`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. |
127
+
|`used_vscode_agent`|`boolean`| Yes | Whether the user used the dedicated {% data variables.product.prodname_vscode_shortname %} Agents window during the reporting period. Omitted when no dedicated Agents-window data is available for the user. |
129
128
|`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). |
130
129
|`distinct_skill_use_count`|`integer`| Yes | Number of different skill identifiers with recorded activity for the user. See [{% data variables.copilot.copilot_cli_short %} customization fields](#copilot-cli-customization-fields-api-only). |
131
130
|`distinct_custom_agent_use_count`|`integer`| Yes | Number of different custom agent identifiers with recorded activity for the user. See [{% data variables.copilot.copilot_cli_short %} customization fields](#copilot-cli-customization-fields-api-only). |
@@ -140,6 +139,7 @@ Per-user reports contain one record per user for the reporting period. The 28-da
140
139
|`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). |
141
140
|`totals_by_copilot_app`|`object`| Yes | {% data variables.copilot.github_copilot_app_short %} metrics for the user. Omitted when the user had no {% data variables.copilot.github_copilot_app_short %} usage that day. See [{% data variables.copilot.github_copilot_app_short %} metrics fields](#copilot-app-metrics-fields). |
142
141
|`totals_by_3rd_party_agent`|`array`| Yes | Per-agent usage metrics for recognized {% data variables.copilot.agent_apps %}. Omitted when the user had no recognized {% data variables.copilot.agent_app %} activity during the reporting period. See [{% data variables.copilot.agent_apps_caps %} metrics fields](#agent-apps-metrics-fields). |
142
+
|`totals_by_vscode_agent`|`object`| Yes | Dedicated {% data variables.product.prodname_vscode_shortname %} Agents-window metrics for the user. Omitted when both required counts are not available. See [{% data variables.product.prodname_vscode_shortname %} Agents-window metrics fields](#vs-code-agents-window-metrics-fields). |
143
143
|`totals_by_ide`|`array`| No | Per-IDE breakdown of the user's activity. See [Activity breakdown objects](#activity-breakdown-objects). |
144
144
|`totals_by_feature`|`array`| No | Per-feature breakdown of the user's activity. See [Activity breakdown objects](#activity-breakdown-objects). |
145
145
|`totals_by_language_feature`|`array`| No | Breakdown combining language and feature dimensions. See [Activity breakdown objects](#activity-breakdown-objects). |
@@ -156,7 +156,9 @@ Active-user counts:
156
156
|:--|:--|:--|:--|
157
157
|`daily_active_users`|`integer`| No | Number of unique users who used {% data variables.product.prodname_copilot_short %} on a given day. |
158
158
|`weekly_active_users`|`integer`| No | Number of unique users who used {% data variables.product.prodname_copilot_short %} during a trailing seven-day window. |
159
+
|`weekly_active_vscode_agent_users`|`integer`| Yes | Number of unique users who used the dedicated {% data variables.product.prodname_vscode_shortname %} Agents window from Sunday through the report day, inclusive. This calendar-to-date count is not a trailing seven-day window. |
159
160
|`monthly_active_users`|`integer`| No | Number of unique users who used {% data variables.product.prodname_copilot_short %} during a trailing 28-day window. |
161
+
|`monthly_active_vscode_agent_users`|`integer`| Yes | Number of unique users who used the dedicated {% data variables.product.prodname_vscode_shortname %} Agents window from the first day of the calendar month through the report day, inclusive. This calendar-to-date count is not a trailing 28-day window. |
160
162
|`monthly_active_chat_users`|`integer`| No | Number of unique users who used chat during a trailing 28-day window. |
161
163
|`monthly_active_agent_users`|`integer`| No | Number of unique users who used agent mode during a trailing 28-day window. |
162
164
|`daily_active_copilot_cloud_agent_users`|`integer`| No | Number of unique users who used {% data variables.copilot.copilot_cloud_agent %} on a given day. |
@@ -170,6 +172,7 @@ Active-user counts:
170
172
|`monthly_passive_copilot_code_review_users`|`integer`| No | Number of unique users who had {% data variables.copilot.copilot_code-review_short %} automatically assigned to review their pull request during a trailing 28-day window, with no active engagement. |
171
173
|`daily_active_cli_users`|`integer`| Yes | Number of unique users who used {% data variables.copilot.copilot_cli_short %} on a given day. This count is **independent** of IDE active-user counts and is **not** included in IDE-based active-user definitions. Omitted for enterprises or organizations with no CLI usage that day. |
172
174
|`daily_active_copilot_app_users`|`integer`| Yes | Number of unique users who used the {% data variables.copilot.github_copilot_app_short %} on a given day. Null when the enterprise or organization has no {% data variables.copilot.github_copilot_app_short %} activity that day. |
175
+
|`daily_active_vscode_agent_users`|`integer`| Yes | Number of unique users who used the dedicated {% data variables.product.prodname_vscode_shortname %} Agents window on a given day. Omitted when no dedicated Agents-window data is available for the enterprise or organization. |
173
176
174
177
Activity totals and breakdowns:
175
178
@@ -200,6 +203,7 @@ Activity totals and breakdowns:
200
203
|`totals_by_cli`|`object`| Yes | Aggregated {% data variables.copilot.copilot_cli_short %} metrics for the day. Omitted when there is no CLI usage that day. Unlike the per-user form, it does not include `last_known_cli_version`. See [{% data variables.copilot.copilot_cli_short %} metrics fields](#copilot-cli-metrics-fields). |
201
204
|`totals_by_copilot_app`|`object`| Yes | Aggregated {% data variables.copilot.github_copilot_app_short %} metrics for the day. Null when the enterprise or organization has no {% data variables.copilot.github_copilot_app_short %} activity that day. See [{% data variables.copilot.github_copilot_app_short %} metrics fields](#copilot-app-metrics-fields). |
202
205
|`totals_by_3rd_party_agent`|`array`| Yes | Aggregated per-agent usage metrics for recognized {% data variables.copilot.agent_apps %}. Omitted when the enterprise or organization had no recognized {% data variables.copilot.agent_app %} activity that day. See [{% data variables.copilot.agent_apps_caps %} metrics fields](#agent-apps-metrics-fields). |
206
+
|`totals_by_vscode_agent`|`object`| Yes | Aggregated dedicated {% data variables.product.prodname_vscode_shortname %} Agents-window metrics for the day. Omitted when both required counts are not available. See [{% data variables.product.prodname_vscode_shortname %} Agents-window metrics fields](#vs-code-agents-window-metrics-fields). |
203
207
|`totals_by_ai_adoption_phase`|`array`| Yes | Per-phase aggregates of users and their average activity. Omitted when no adoption-phase data is available. See [AI adoption phase fields](#ai-adoption-phase-fields). |
204
208
|`pull_requests`|`object`| No | Daily pull request activity for the enterprise or organization. See [Pull request activity fields](#pull-request-activity-fields). |
205
209
@@ -353,6 +357,24 @@ The `totals_by_copilot_app` object contains the following nested fields when {%
353
357
|`totals_by_copilot_app.token_usage.prompt_tokens_sum`|`integer`| No | Total prompt tokens sent across all {% data variables.copilot.github_copilot_app_short %} requests on this day. |
354
358
|`totals_by_copilot_app.token_usage.avg_tokens_per_request`|`number`| Yes | Average of output and prompt tokens per {% data variables.copilot.github_copilot_app_short %} request, computed as `(output_tokens_sum + prompt_tokens_sum) ÷ request_count`. Null when there were no requests that day. |
355
359
360
+
### {% data variables.product.prodname_vscode_shortname %} Agents-window metrics fields
361
+
362
+
The dedicated {% data variables.product.prodname_vscode_shortname %} Agents-window fields appear in enterprise, organization, enterprise-user, and organization-user 1-day and 28-day reports. In aggregated 28-day reports, they appear within each applicable `day_totals` entry, and weekly and monthly counts are calculated relative to the `day` of each entry. In per-user 28-day reports, they appear at the top level of each user record.
363
+
364
+
These fields are distinct from editor-window agent mode, including `used_agent`, `monthly_active_agent_users`, and the `chat_panel_agent_mode` and `agent_edit` feature values. Dedicated Agents-window activity is not included in generic top-level activity totals or dimensional breakdowns such as `totals_by_feature`, `totals_by_model_feature`, or `totals_by_ai_adoption_phase`.
365
+
366
+
The daily count and per-user fields can be omitted when no dedicated Agents-window data is available. The weekly and monthly fields are both omitted when there is no qualifying activity in either period. If one period has qualifying activity and the other does not, the inactive period has a value of `0`. The `totals_by_vscode_agent` object appears only when both nested counts are available, including when both counts are zero.
367
+
368
+
| Field | Type | Nullable | Description |
369
+
|:--|:--|:--|:--|
370
+
|`daily_active_vscode_agent_users`|`integer`| Yes | Number of unique users who used the dedicated {% data variables.product.prodname_vscode_shortname %} Agents window on the day. Aggregated enterprise and organization reports only. |
371
+
|`weekly_active_vscode_agent_users`|`integer`| Yes | Number of unique users who used the dedicated Agents window from Sunday through the report day, inclusive. Aggregated enterprise and organization reports only. |
372
+
|`monthly_active_vscode_agent_users`|`integer`| Yes | Number of unique users who used the dedicated Agents window from the first day of the calendar month through the report day, inclusive. Aggregated enterprise and organization reports only. |
373
+
|`used_vscode_agent`|`boolean`| Yes | Whether the user used the dedicated {% data variables.product.prodname_vscode_shortname %} Agents window during the reporting period. Enterprise-user and organization-user reports only. |
374
+
|`totals_by_vscode_agent`|`object`| Yes | Session and user-message totals for the dedicated {% data variables.product.prodname_vscode_shortname %} Agents window. |
375
+
|`totals_by_vscode_agent.session_count`|`integer`| No | Number of distinct Agents-window sessions represented in the record. Required when `totals_by_vscode_agent` is present. |
376
+
|`totals_by_vscode_agent.total_user_messages`|`integer`| No | Number of user messages sent in the Agents window represented in the record. Required when `totals_by_vscode_agent` is present. |
377
+
356
378
### {% data variables.copilot.agent_apps_caps %} metrics fields
0 commit comments