Skip to content

Commit fad4137

Browse files
authored
Merge pull request #39986 from github/repo-sync
Repo sync
2 parents ee679cb + 35eb000 commit fad4137

File tree

18 files changed

+134
-196
lines changed

18 files changed

+134
-196
lines changed

content/billing/concepts/product-billing/github-copilot.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -79,10 +79,12 @@ For more information about {% data variables.copilot.copilot_coding_agent %}, se
7979

8080
### What happens if you have used up your monthly quota?
8181

82-
If you run out of free Actions minutes or free premium requests, and you have set up a payment method for billing, you will be charged at the normal rates for additional minutes and premium requests. See [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions) and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests#additional-premium-requests).
82+
If you run out of free Actions minutes or free premium requests, and you have set up a payment method and are not limited by a budget, you will be charged at the normal rates for additional minutes and premium requests. See [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions) and [AUTOTITLE](/copilot/concepts/billing/copilot-requests#what-if-i-run-out-of-premium-requests).
8383

8484
If you run out of free minutes or premium requests, and you have _not_ set up billing, a message is displayed explaining why {% data variables.product.prodname_copilot_short %} cannot work on the task.
8585

86+
{% data reusables.copilot.zero-budget-changes %} See [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).
87+
8688
### Monitoring your use of Actions minutes and premium requests
8789

8890
You can track your monthly usage of {% data variables.product.prodname_actions %} minutes and premium requests, to help you get the most value from your {% data variables.product.prodname_copilot_short %} plan. See [AUTOTITLE](/enterprise-cloud@latest/billing/managing-billing-for-your-products/managing-billing-for-github-actions/viewing-your-github-actions-usage) and [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/understanding-and-managing-copilot-usage/monitoring-your-copilot-usage-and-entitlements).

content/billing/tutorials/set-up-budgets.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ As the owner of an enterprise or organization account, or as a billing manager,
104104

105105
### Editing or deleting a budget
106106

107-
>[!IMPORTANT] Deleting a budget may remove any limits on spending, depending on your other existing budgets. For example, deleting the only budget that limits {% data variables.product.prodname_copilot_short %} premium requests allows for unlimited usage.
107+
>[!IMPORTANT] Deleting a budget may remove any limits on spending, depending on your other existing budgets.
108108
109109
You can edit or delete a budget at any time, but you cannot change the scope of a budget after creating it.
110110

content/copilot/concepts/billing/billing-for-spark.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ contentType: concepts
1919
2020
## Billing for {% data variables.product.prodname_spark_short %} app creation
2121

22-
Each prompt consumes 4 premium requests, which draw from your plan's premium request allowance. If you or an administrator has set a budget for premium requests over your plan's allowance, additional premium requests beyond your plan’s included amount are billed at {% data variables.copilot.additional_premium_requests %} per request, meaning that one prompt to {% data variables.product.prodname_spark_short %} would cost **$0.16**. See [AUTOTITLE](/copilot/concepts/copilot-billing/understanding-and-managing-requests-in-copilot).
22+
Each prompt consumes 4 premium requests, which draw from your plan's premium request allowance. If you have enabled premium requests over your plan's allowance, additional premium requests beyond your plan’s included amount are billed at {% data variables.copilot.additional_premium_requests %} per request, meaning that one prompt to {% data variables.product.prodname_spark_short %} would cost **$0.16**. See [AUTOTITLE](/copilot/concepts/copilot-billing/understanding-and-managing-requests-in-copilot).
2323

2424
## Billing and limits for {% data variables.product.prodname_spark_short %} app deployment
2525

content/copilot/concepts/billing/copilot-requests.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -68,15 +68,12 @@ Unused requests for the previous month do not carry over to the following month.
6868
6969
If you're on a **paid plan** and use all of your premium requests, you can still use {% data variables.product.prodname_copilot_short %} with one of the included models for the rest of the month. This is subject to change. Response times for the included models may vary during periods of high usage. Requests to the included models may be subject to rate limiting. See [AUTOTITLE](/copilot/concepts/rate-limits).
7070

71-
If you need more premium requests beyond your monthly allowance, you can:
71+
If you need more premium requests beyond your monthly allowance:
7272

73-
* Set a spending limit for additional premium requests. See [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending).
74-
* Upgrade your individual subscription to a higher plan.
75-
* 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).
73+
* For an individual subscription, set a budget for additional premium requests or upgrade to a higher plan. See [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending).
74+
* If you're an enterprise or organization owner, ensure that the "Premium request paid usage" policy is enabled and that extra spending is not prevented by a budget. See [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).
7675

77-
These actions can be taken by enterprise owners, organization owners, billing managers, and personal account users.
78-
79-
> [!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.
76+
{% data reusables.copilot.zero-budget-changes %}
8077

8178
## Model multipliers
8279

content/copilot/get-started/choose-enterprise-plan.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ Each {% data variables.product.prodname_copilot_short %} plan includes a per-use
7070

7171
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.
7272

73-
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.
73+
Regardless of your plan, you can enable or disable 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.
7474

7575
## Making a decision
7676

content/copilot/how-tos/manage-and-track-spending/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ topics:
88
- Copilot
99
children:
1010
- /monitor-premium-requests
11-
- /manage-for-your-enterprise
11+
- /manage-request-allowances
1212
- /manage-company-spending
1313
redirect_from:
1414
- /copilot/how-tos/premium-requests

content/copilot/how-tos/manage-and-track-spending/manage-company-spending.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,9 @@ This report includes all premium request usage by user, both within and beyond t
3939

4040
### Granting more premium requests to members
4141

42-
By default, enterprises have a $0 budget for the Premium Request SKU. This means that when users exhaust their allowance, they cannot make any more premium requests for the rest of the month. Deleting this budget allows for **unlimited spending**.
42+
Your organization or enterprise's policies and budgets determine whether users can use premium requests over their included allowance. See [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).
4343

44-
To change the default budget or increase members' base allowance, see [AUTOTITLE](/copilot/how-tos/premium-requests/manage-for-enterprise).
44+
{% data reusables.copilot.zero-budget-changes %}
4545

4646
## Mapping spending to groups of users
4747

@@ -56,7 +56,7 @@ For more information, see [AUTOTITLE](/billing/tutorials/use-cost-centers).
5656
You can set a monthly budget on {% data variables.product.prodname_copilot %} spending.
5757

5858
* For {% data variables.product.prodname_copilot_short %} **licenses**, a budget is for monitoring purposes only and will not prevent usage beyond the budgeted amount. However, you will receive notifications by email when spending exceeds certain percentages of the budget you've set.
59-
* For {% data variables.product.prodname_copilot_short %} **premium requests**, you can choose to stop usage once the budget amount is reached. The default $0 budget for enterprises already does this.
59+
* For {% data variables.product.prodname_copilot_short %} **premium requests**, you can choose to stop usage once the budget amount is reached.
6060

6161
To create a budget, see [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending#editing-or-deleting-a-budget).
6262

Lines changed: 27 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
2-
title: Managing the premium request allowance for users in your enterprise
3-
shortTitle: Manage for your enterprise
4-
intro: 'Change the default spending limit or upgrade users to {% data variables.copilot.copilot_enterprise_short %}.'
5-
permissions: Enterprise owners
2+
title: Managing the premium request allowance for your organization or enterprise
3+
shortTitle: Manage request allowances
4+
intro: 'Configure policies and budgets for premium requests, or upgrade users to {% data variables.copilot.copilot_enterprise_short %}.'
5+
permissions: Enterprise owners and organization owners
66
versions:
77
feature: copilot
88
topics:
@@ -13,38 +13,47 @@ redirect_from:
1313
- /copilot/how-tos/premium-requests/manage-for-enterprise
1414
- /copilot/how-tos/spending/manage-for-enterprise
1515
- /copilot/how-tos/spending/manage-for-your-enterprise
16+
- /copilot/how-tos/manage-and-track-spending/manage-for-your-enterprise
1617
contentType: how-tos
1718
---
1819

19-
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/requests-in-github-copilot). For allowances per plan, see [AUTOTITLE](/copilot/get-started/plans-for-github-copilot#comparing-copilot-plans).
20+
Each {% data variables.product.prodname_copilot_short %} plan includes a per-user allowance for premium requests. If enabled, requests over the allowance are billed to your organization or enterprise. To learn more about premium requests, see [AUTOTITLE](/copilot/concepts/copilot-billing/requests-in-github-copilot). For allowances per plan, see [AUTOTITLE](/copilot/get-started/plans-for-github-copilot#comparing-copilot-plans).
2021

21-
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.
22+
Your organization or enterprise's policies and budgets determine whether users can use premium requests over their included allowance:
2223

23-
![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)
24+
* The **Premium request paid usage** policy determines whether users can surpass their included allowance. This policy is enabled by default.
25+
* If your enterprise or organization has a budget that caps usage of the **Premium Request SKU**, additional requests are blocked once the budget amount is reached for the billing period.
2426

25-
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 %}.
27+
You can increase the allowance for users by ensuring the policy is enabled, editing your budgets, or upgrading users to {% data variables.copilot.copilot_enterprise_short %}.
28+
29+
{% data reusables.copilot.zero-budget-changes %}
2630

2731
## Prerequisites
2832

2933
* 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).
3034
* 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).
3135

32-
## Changing the budget for all members
36+
## Setting a policy for paid usage
37+
38+
By default, premium requests over the allowance are enabled for organizations and enterprises. This allows for uninterrupted use of premium requests, unless you have a budget that caps spending on the Premium Request SKU.
39+
40+
You can set the policy for an enterprise or a standalone organization.
3341

34-
To enable premium requests over the allowance for everyone, you can:
42+
1. Navigate to the policy settings for your enterprise or organization. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies) or [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies).
43+
1. Next to "Premium request paid usage", select the policy for your organization or enterprise.
3544

36-
* Delete the default $0 budget to allow **unlimited spending on premium requests** for all users.
37-
* Edit the "Budget amount" of the default $0 budget to set **a non-zero total spending limit** for premium requests in your enterprise.
45+
## Updating budgets
3846

39-
For instructions, see [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending#editing-or-deleting-a-budget).
47+
1. Ensure the "Premium request paid usage" policy is enabled. See [Setting a policy for paid usage](#setting-a-policy-for-paid-usage).
48+
1. Check the budgets for your enterprise or organizations, and edit or delete any budgets that "stop usage when budget limit is reached" for the Premium Request SKU. See [AUTOTITLE](/billing/managing-your-billing/using-budgets-control-spending#editing-or-deleting-a-budget).
4049

41-
>[!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.
50+
Creating new budgets without deleting an existing budget does not override the existing budget. If **any** applicable budget with "Stop usage when budget limit is reached" enabled is exhausted, additional premium requests are blocked.
4251

4352
## Upgrading users to {% data variables.copilot.copilot_enterprise_short %}
4453

45-
You can upgrade certain users to increase their base allowance of premium requests.
54+
An enterprise owner can upgrade certain users to increase their base allowance of premium requests.
4655

47-
>[!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.
56+
>[!TIP] {% data variables.copilot.copilot_business_short %} users who make more than 800 premium requests per month would save money with a {% data variables.copilot.copilot_enterprise_short %} license.
4857
4958
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).
5059
1. Add the users who need more premium requests to the new organization.
@@ -64,6 +73,7 @@ You can set a higher budget for premium requests over the allowance for specific
6473

6574
At a high level, the required steps are:
6675

67-
1. Delete the default $0 budget.
76+
1. Ensure the "Premium request paid usage" policy is enabled. See [Setting a policy for paid usage](#setting-a-policy-for-paid-usage).
77+
1. Delete the default $0 budget if it applies to your organization or enterprise.
6878
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.
6979
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/manage-and-track-spending/monitor-premium-requests.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -87,8 +87,7 @@ You can use the following strategies to maximize the value of your premium reque
8787

8888
* **Setting a budget**. Set a budget to track your overages and receive alerts when you reach 75%, 90%, or 100% of your budget. See [AUTOTITLE](/billing/managing-your-billing/preventing-overspending#managing-budgets-for-your-personal-account).
8989

90-
>[!NOTE]
91-
> By default, all budgets are set to zero and premium requests over the allowance are rejected unless a budget has been created.
90+
{% data reusables.copilot.zero-budget-changes %}
9291

9392
* **Monitor your usage regularly**. Check your usage in your {% data variables.product.github %} account settings to see how many premium requests you’ve used. This helps you plan how much you can use for the rest of the month.
9493

content/graphql/guides/forming-calls-with-graphql.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ If you access {% data variables.product.github %} at a different domain, such as
4949

5050
## Communicating with GraphQL
5151

52-
Because GraphQL operations consist of multiline JSON, GitHub recommends using the [Explorer](/graphql/guides/using-the-explorer) to make GraphQL calls. You can also use `curl` or any other HTTP-speaking library.
52+
Because GraphQL operations consist of multiline JSON, GitHub recommends using the [GraphQL Clients](/graphql/guides/using-graphql-clients) to make GraphQL calls. You can also use `curl` or any other HTTP-speaking library.
5353

5454
In REST, [HTTP verbs](/rest#http-verbs) determine the operation performed. In GraphQL, you'll provide a JSON-encoded body whether you're performing a query or a mutation, so the HTTP verb is `POST`. The exception is an [introspection query](/graphql/guides/introduction-to-graphql#discovering-the-graphql-api), which is a simple `GET` to the endpoint. For more information on GraphQL versus REST, see [AUTOTITLE](/graphql/guides/migrating-from-rest-to-graphql).
5555

0 commit comments

Comments
 (0)