Skip to content

Commit 68a6ecd

Browse files
authored
Merge pull request #39326 from github/repo-sync
Repo sync
2 parents 1679638 + bc36811 commit 68a6ecd

File tree

15 files changed

+167
-97
lines changed

15 files changed

+167
-97
lines changed
Loading

content/billing/managing-your-billing/gathering-insights-on-your-spending.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -82,9 +82,9 @@ You can view the usage of your {% data variables.enterprise.enterprise_or_org %}
8282
1. To request a CSV usage report, select **Get usage report** in the upper-right corner of the page.
8383

8484
* For a breakdown of all metered usage, click **Metered billing usage report**.
85-
* For a per user breakdown of additional premium requests, click **{% data variables.product.prodname_copilot_short %} premium requests usage report**.
85+
* For a per user breakdown of premium requests for the last 45 days, click **{% data variables.product.prodname_copilot_short %} premium requests usage report**.
8686

87-
You can choose a pre-selected option or use the "Custom range" option to specify a date range of up to 31 days.
87+
>[!TIP] The premium request usage report includes all premium requests, both within and beyond the allowance. By contrast, the metered billing usage report only reflects costs for requests beyond the allowance.
8888
8989
## Viewing license usage
9090

content/billing/managing-your-billing/using-budgets-control-spending.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,6 @@ As the owner of an enterprise or organization account, or as a billing manager,
132132
133133
You can edit or delete a budget at any time, but you cannot change the scope of a budget after creating it.
134134

135-
1. In the "Budgets and alerts" view, click **New budget**.
136-
1. Click **Budgets and alerts**.
137-
1. To edit a budget, in the list of budgets, click {% octicon "kebab-horizontal" aria-label="View actions" %} next to the budget you want to edit, and click **{% octicon "pencil" aria-hidden="true" aria-label="pencil" %} Edit** or **{% octicon "trash" aria-hidden="true" aria-label="trash" %} Delete**.
135+
1. Navigate to the "Budgets and alerts" view. See [Viewing budgets](#viewing-budgets).
136+
1. In the list of budgets, click {% octicon "kebab-horizontal" aria-label="View actions" %} next to the budget you want to edit, and click **{% octicon "pencil" aria-hidden="true" aria-label="pencil" %} Edit** or **{% octicon "trash" aria-hidden="true" aria-label="trash" %} Delete**.
138137
1. Follow the prompts.

content/copilot/concepts/copilot-billing/understanding-and-managing-requests-in-copilot.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,9 +67,10 @@ If you're on a **paid plan** and use all of your premium requests, you can still
6767
If you need more premium requests beyond your monthly allowance, you can:
6868

6969
* Set a spending limit for additional premium requests. See [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending).
70-
* Upgrade to a higher plan.
70+
* Upgrade your individual subscription to a higher plan.
71+
* If you're an enterprise owner, edit the default $0 budget or upgrade members to {% data variables.copilot.copilot_enterprise_short %}. See [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).
7172

72-
These actions can be taken by organization owners, billing managers, and personal account users.
73+
These actions can be taken by enterprise owners, organization owners, billing managers, and personal account users.
7374

7475
> [!IMPORTANT] By default, all budgets are set to zero and premium requests over the allowance are rejected unless a budget has been created. Additional premium requests beyond your plan’s included amount are billed at {% data variables.copilot.additional_premium_requests %} per request.
7576

content/copilot/get-started/choosing-your-enterprises-plan-for-github-copilot.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,9 +61,12 @@ With {% data variables.copilot.copilot_code-review_short %}, {% data variables.p
6161

6262
## How much will we benefit from premium requests?
6363

64-
{% data reusables.copilot.premium-requests-for-enterprises %}
64+
Each {% data variables.product.prodname_copilot_short %} plan includes a per-user allowance for premium requests:
6565

66-
To decide if you will benefit from a higher allowance for premium requests, compare the goals of your rollout to **development tasks** that each model is specialized in. For example, the {% data variables.copilot.copilot_claude_sonnet_40 %} is designed for advanced reasoning and coding tasks. Teams who work in specialized areas may require more requests to premium models. To learn about the benefits of different models, see [AUTOTITLE](/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task).
66+
* 300 requests per user per month for {% data variables.copilot.copilot_business_short %}
67+
* 1000 requests per user per month for {% data variables.copilot.copilot_enterprise_short %}
68+
69+
By ensuring members have access to enough premium requests, you can drive real business outcomes, such as reducing your backlog with {% data variables.copilot.copilot_coding_agent %}, accelerating pull requests with {% data variables.copilot.copilot_code-review_short %}, or increasing code quality with suggestions from more specialized models.
6770

6871
Regardless of your plan, you can set a spending limit for premium requests over your plan's allowance. Premium requests over the allowance will be charged at a rate of {% data variables.copilot.additional_premium_requests %} per request, with an additional multiplier applied to certain models.
6972

content/copilot/how-tos/administer/organizations/reviewing-activity-related-to-github-copilot-in-your-organization/reviewing-user-activity-data-for-copilot-in-your-organization.md

Lines changed: 3 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -41,31 +41,11 @@ redirect_from:
4141

4242
You can use {% data variables.product.prodname_dotcom %}'s REST API to get details about the assignment of {% data variables.product.prodname_copilot %} seats in your organization. See [Get Copilot seat information and settings for an organization](/rest/copilot/copilot-user-management?apiVersion=2022-11-28#get-copilot-seat-information-and-settings-for-an-organization), [List all Copilot seat assignments for an organization](/rest/copilot/copilot-user-management?apiVersion=2022-11-28#list-all-copilot-seat-assignments-for-an-organization), and [Get Copilot seat assignment details for a user](/rest/copilot/copilot-user-management?apiVersion=2022-11-28#get-copilot-seat-assignment-details-for-a-user).
4343

44-
## Understanding the `last_activity_at` calculation
44+
## Troubleshooting `last_activity_at` data
4545

46-
> [!NOTE] This data is in {% data variables.release-phases.public_preview %} and subject to change.
46+
If you believe a user's `last_activity_at` date should be more recent than shown in the CSV or API report, wait 24 hours and check again. If their recent Copilot usage is still not reflected in their `last_activity_at` date, have the user check that telemetry is enabled in their IDE settings.
4747

48-
To align the `last_activity_at` data point with _actual usage_, the system returns the timestamp of a user's most recent interaction with Copilot functionality. These interactions are:
49-
50-
* Receiving a code suggestion in an IDE
51-
* Chatting with Copilot Chat in an IDE
52-
{%- ifversion ghec %}
53-
* Creating or updating a knowledge base
54-
* Creating a pull request summary
55-
* Interacting with Copilot Chat in GitHub
56-
{%- endif %}
57-
* Interacting with Copilot on a mobile device
58-
* Interacting with Copilot Chat for CLI
59-
60-
The `last_activity_at` date is consistent across the CSV generated via `Get Report` in Copilot Access settings as well as through {% data variables.product.prodname_dotcom %}'s REST API. The events which are tracked come from both client, and server-side telemetry. This allows the timestamp to be durable in the event that network conditions would impact client-telemetry.
61-
62-
The retention period for `last_activity_at` data is 90 days. After 90 days of no new activity, a user's `last_activity_at` value is set to `nil`. The data retention period cannot be modified. For more information, see [Updating retention period for `last_activity_at` values on the Copilot user management API to 90 days](https://github.blog/changelog/2025-01-17-updating-retention-period-for-last_activity_at-values-on-the-user-management-api-public-preview-to-90-days/) on {% data variables.product.prodname_blog %}.
63-
64-
### Troubleshooting `last_activity_at` data
65-
66-
Processing new telemetry events and updating a user's `last_activity_at` date can take up to 24 hours. Users must have telemetry enabled in their IDE for their usage to be reflected in `last_activity_at`.
67-
68-
If you believe a user's `last_activity_at` date should be more recent than shown in the CSV or API report, please wait 24 hours and check again. If their recent Copilot usage is still not reflected in their `last_activity_at` date, have the user check that telemetry is enabled in their IDE settings.
48+
For more information about this property, see [AUTOTITLE](/copilot/reference/metrics-data#last_activity_at).
6949

7050
## Further reading
7151

content/copilot/how-tos/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ children:
1616
- /custom-instructions
1717
- /content-exclusion
1818
- /github-flow
19-
- /monitoring-your-copilot-usage-and-entitlements
19+
- /premium-requests
2020
- /personal-settings
2121
- /manage-your-account
2222
- /administer
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
title: Premium requests for Copilot
3+
shortTitle: Premium requests
4+
intro: 'Manage and track premium requests for yourself or for your users.'
5+
versions:
6+
feature: copilot
7+
topics:
8+
- Copilot
9+
children:
10+
- /monitoring-your-copilot-usage-and-entitlements
11+
- /manage-for-enterprise
12+
---
13+
Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
---
2+
title: Managing the premium request allowance for users in your enterprise
3+
shortTitle: Manage allowance for members
4+
intro: 'Change the default spending limit or upgrade users to {% data variables.copilot.copilot_enterprise_short %}.'
5+
permissions: 'Enterprise owners'
6+
versions:
7+
feature: copilot
8+
topics:
9+
- Copilot
10+
allowTitleToDifferFromFilename: true
11+
product: '{% data variables.copilot.copilot_for_business %} or {% data variables.copilot.copilot_enterprise %}'
12+
---
13+
14+
Each {% data variables.product.prodname_copilot_short %} plan includes a per-user allowance for premium requests. To learn more about premium requests, see [AUTOTITLE](/copilot/concepts/copilot-billing/understanding-and-managing-requests-in-copilot). For allowances per plan, see [AUTOTITLE](/copilot/get-started/plans-for-github-copilot#comparing-copilot-plans).
15+
16+
By default, every enterprise has a $0 budget for the Premium Request SKU. Unless this budget is edited or deleted, your enterprise will have **no extra costs** for premium requests: when one of your licensed users exhausts the allowance in their plan, the user's premium requests will be rejected for the rest of the month.
17+
18+
![Screenshot of the enterprise budgets page, with the default budget: a $0 budget for the Premium Request SKU.](/assets/images/help/copilot/enterprise-premium-request-budget.png)
19+
20+
You can edit or delete this budget to grant extra requests to all your licensed members. If you want to grant extra requests to certain users only, you can upgrade those users to {% data variables.copilot.copilot_enterprise_short %}.
21+
22+
## Prerequisites
23+
24+
* Before making changes, download a usage report to see which developers are frequently hitting the limit or using a significant number of requests over the allowance. You may want to contact these users to understand their use cases and requirements. See [Downloading a monthly usage report](/copilot/how-tos/monitoring-your-copilot-usage-and-entitlements#downloading-a-monthly-usage-report).
25+
* If a user receives licenses from multiple enterprises or standalone organizations, the user must select a billing entity to use premium requests. See [Managing premium request billing with multiple {% data variables.product.prodname_copilot_short %} licenses](/copilot/managing-copilot/monitoring-usage-and-entitlements/monitoring-your-copilot-usage-and-entitlements#managing-premium-request-billing-with-multiple-copilot-licenses).
26+
27+
## Changing the budget for all members
28+
29+
To enable premium requests over the allowance for everyone, you can:
30+
31+
* Delete the default $0 budget to allow **unlimited spending on premium requests** for all users.
32+
* Edit the "Budget amount" of the default $0 budget to set **a non-zero total spending limit** for premium requests in your enterprise.
33+
34+
For instructions, see [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending#editing-or-deleting-a-budget).
35+
36+
>[!NOTE] Creating new budgets without deleting the $0 budget does not override the $0 budget. If **any** applicable budget with "Stop usage when budget limit is reached" enabled is exhausted, additional premium requests are blocked.
37+
38+
## Upgrading users to {% data variables.copilot.copilot_enterprise_short %}
39+
40+
You can upgrade certain users to increase their base allowance of premium requests.
41+
42+
>[!TIP] {% data variables.copilot.copilot_business_short %} users who make make more than 800 premium requests per month would save money with a {% data variables.copilot.copilot_enterprise_short %} license.
43+
44+
1. Create a new organization in your enterprise. See [AUTOTITLE](/enterprise-cloud@latest/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise#creating-a-new-organization).
45+
1. Add the users who need more premium requests to the new organization.
46+
1. Grant {% data variables.copilot.copilot_enterprise_short %} licenses to all users in the organization.
47+
48+
1. If needed, upgrade the enterprise to {% data variables.copilot.copilot_enterprise_short %}. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer/enterprises/managing-the-copilot-plan-for-your-enterprise/upgrading-copilot-for-your-enterprise).
49+
50+
1. Enable {% data variables.copilot.copilot_enterprise_short %} for the new organization. See [AUTOTITLE](/enterprise-cloud@latest/copilot/how-tos/administer/enterprises/managing-access-to-copilot-in-your-enterprise/enabling-copilot-for-organizations-in-your-enterprise).
51+
52+
1. Grant licenses to all users in the organization. See [AUTOTITLE](/copilot/how-tos/administer/organizations/managing-access-to-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization#granting-access-to-github-copilot-for-all-current-and-future-users-in-your-organization).
53+
54+
1. Check the usage report regularly to ensure that {% data variables.copilot.copilot_enterprise_short %} remains the most cost-effective option for these users.
55+
56+
## Setting a budget for specific members
57+
58+
You can set a higher budget for premium requests over the allowance for specific users in your enterprise. However, you must ensure that every user in your enterprise is covered by a budget. Users who are not covered by a budget will have access to unlimited spending on premium requests.
59+
60+
At a high level, the required steps are:
61+
62+
1. Delete the default $0 budget.
63+
1. Create a new budget for the users who need a higher allowance. For example, create an organization or cost center containing just these users, then create a Premium Request SKU budget for the organization or cost center.
64+
1. Create a separate, more restrictive budget that covers every other {% data variables.product.prodname_copilot_short %} user in your enterprise. You will likely need to integrate with the API to ensure that this budget covers new users as they are added to your enterprise.

content/copilot/how-tos/monitoring-your-copilot-usage-and-entitlements.md renamed to content/copilot/how-tos/premium-requests/monitoring-your-copilot-usage-and-entitlements.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ redirect_from:
1111
- /copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/monitoring-usage-and-entitlements/monitoring-your-copilot-usage-and-entitlements
1212
- /copilot/managing-copilot/monitoring-usage-and-entitlements/monitoring-your-copilot-usage-and-entitlements
1313
- /copilot/managing-copilot/understanding-and-managing-copilot-usage/monitoring-your-copilot-usage-and-entitlements
14+
- /copilot/how-tos/monitoring-your-copilot-usage-and-entitlements
1415
---
1516

1617
You can track your monthly usage of premium requests to help you get the most value from your {% data variables.product.prodname_copilot_short %} plan.
@@ -52,6 +53,8 @@ You can view your premium request usage at any time from your {% data variables.
5253

5354
### Downloading a {% data variables.product.prodname_copilot_short %} premium request usage report
5455

56+
The premium request usage report includes all premium request usage, both within and beyond the allowance. By contrast, other metered billing reports only reflect costs for premium requests beyond the allowance.
57+
5558
>[!NOTE]
5659
> For organizations and enterprises, only admins can download a usage report to understand {% data variables.product.prodname_copilot_short %} usage across their business. Individual members of the organization or enterprise cannot download the report for themselves.
5760

0 commit comments

Comments
 (0)