Skip to content

Commit 7ac925c

Browse files
hubwriterCopilotjc-clark
authored
Add CLI tutorial: "Using Copilot CLI as your AI SME" (#61138)
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>
1 parent 5b0ae2c commit 7ac925c

4 files changed

Lines changed: 258 additions & 97 deletions

File tree

Lines changed: 48 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,48 @@
1-
---
2-
title: Preparing your organization for usage-based billing
3-
shortTitle: Prepare your organization for usage-based billing
4-
allowTitleToDifferFromFilename: true
5-
intro: 'Review your estimated costs under usage-based billing and take steps to prepare your organization before the transition.'
6-
permissions: Enterprise owners, organization owners, and billing managers
7-
versions:
8-
feature: copilot
9-
product: '{% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %}'
10-
contentType: how-tos
11-
category:
12-
- Manage Copilot for a team
13-
---
14-
15-
<!-- expires 2026-06-01 -->
16-
17-
On June 1, 2026, {% data variables.product.prodname_copilot_short %} is moving to usage-based billing with {% data variables.product.prodname_ai_credits %}. Use the tool below to understand how this change affects your organization and prepare before the transition takes effect.
18-
19-
<!-- end expires 2026-06-01 -->
20-
21-
## Download the usage report
22-
23-
From the announcement banner on your enterprise home page, billing overview page, or premium request analytics page, click **Preview your usage** to see your options. From the dialog, click **{% octicon "download" aria-hidden="true" %}** to request a detailed usage report. You can also request the report from the premium request analytics page or via the API. The report is generated asynchronously and delivered via email to the requesting admin.
24-
25-
The report includes one row per user, per model, per day. Alongside the existing columns for your current billing data, two additional columns show the estimated equivalent under usage-based billing:
26-
27-
* `aic_quantity`: The number of {% data variables.product.prodname_ai_credits_short %} consumed
28-
* `aic_gross_amount`: The estimated cost in USD under usage-based billing
29-
30-
## See projected spend
31-
32-
For a detailed breakdown, you can upload your CSV to the [billing preview tool](https://copilot-billing-preview.github.com/). The tool gives you a view of your estimated costs, including:
33-
34-
* A side-by-side comparison of your current billing (PRUs) and projected AI Credits (AICs), including total costs with additional usage.
35-
* A detailed breakdown of licenses, consumed units, included discounts, and additional usage for each billing model.
36-
37-
> [!NOTE]
38-
> The billing preview tool provides estimated projections for illustrative purposes only. Actual usage may differ. Charges are calculated from actual usage emissions processed by the billing platform, separate from the preview data pipeline.
39-
40-
Your data stays in your browser; nothing is uploaded to a server.
41-
42-
## Take action before the transition
43-
44-
Based on what you've learned from the billing preview and usage report, you can take steps to prepare:
45-
46-
* **Review and adjust your budgets**. Existing enterprise-level budgets for premium requests will automatically carry over to {% data variables.product.prodname_ai_credits_short %}. Review them in your enterprise billing settings to make sure they still reflect the limits you want.
47-
* **Plan for pooled {% data variables.product.prodname_ai_credits_short %}**. Under usage-based billing, each license comes with a monthly amount of included {% data variables.product.prodname_ai_credits_short %}, which are pooled across your organization. Consider how this changes your cost structure. Teams with uneven usage patterns may benefit.
48-
* **Communicate the change internally**. Let your teams know that billing is changing and what it means for their day-to-day use of {% data variables.product.prodname_copilot_short %}.
1+
---
2+
title: Preparing your organization for usage-based billing
3+
shortTitle: Prepare your organization for usage-based billing
4+
allowTitleToDifferFromFilename: true
5+
intro: 'Review your estimated costs under usage-based billing and take steps to prepare your organization before the transition.'
6+
permissions: Enterprise owners, organization owners, and billing managers
7+
versions:
8+
feature: copilot
9+
product: '{% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %}'
10+
contentType: how-tos
11+
category:
12+
- Manage Copilot for a team
13+
---
14+
15+
<!-- expires 2026-06-01 -->
16+
17+
On June 1, 2026, {% data variables.product.prodname_copilot_short %} is moving to usage-based billing with {% data variables.product.prodname_ai_credits %}. Use the tool below to understand how this change affects your organization and prepare before the transition takes effect.
18+
19+
<!-- end expires 2026-06-01 -->
20+
21+
## Download the usage report
22+
23+
From the announcement banner on your enterprise home page, billing overview page, or premium request analytics page, click **Preview your usage** to see your options. From the dialog, click **{% octicon "download" aria-hidden="true" %}** to request a detailed usage report. You can also request the report from the premium request analytics page or via the API. The report is generated asynchronously and delivered via email to the requesting admin.
24+
25+
The report includes one row per user, per model, per day. Alongside the existing columns for your current billing data, two additional columns show the estimated equivalent under usage-based billing:
26+
27+
* `aic_quantity`: The number of {% data variables.product.prodname_ai_credits_short %} consumed
28+
* `aic_gross_amount`: The estimated cost in USD under usage-based billing
29+
30+
## See projected spend
31+
32+
For a detailed breakdown, you can upload your CSV to the [billing preview tool](https://copilot-billing-preview.github.com/). The tool gives you a view of your estimated costs, including:
33+
34+
* A side-by-side comparison of your current billing (PRUs) and projected AI Credits (AICs), including total costs with additional usage.
35+
* A detailed breakdown of licenses, consumed units, included discounts, and additional usage for each billing model.
36+
37+
> [!NOTE]
38+
> The billing preview tool provides estimated projections for illustrative purposes only. Actual usage may differ. Charges are calculated from actual usage emissions processed by the billing platform, separate from the preview data pipeline.
39+
40+
Your data stays in your browser; nothing is uploaded to a server.
41+
42+
## Take action before the transition
43+
44+
Based on what you've learned from the billing preview and usage report, you can take steps to prepare:
45+
46+
* **Review and adjust your budgets**. Existing enterprise-level budgets for premium requests will automatically carry over to {% data variables.product.prodname_ai_credits_short %}. Review them in your enterprise billing settings to make sure they still reflect the limits you want.
47+
* **Plan for pooled {% data variables.product.prodname_ai_credits_short %}**. Under usage-based billing, each license comes with a monthly amount of included {% data variables.product.prodname_ai_credits_short %}, which are pooled across your organization. Consider how this changes your cost structure. Teams with uneven usage patterns may benefit.
48+
* **Communicate the change internally**. Let your teams know that billing is changing and what it means for their day-to-day use of {% data variables.product.prodname_copilot_short %}.
Lines changed: 48 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,49 @@
1-
---
2-
title: Preparing for your move to usage-based billing
3-
shortTitle: Preparing for usage-based billing
4-
allowTitleToDifferFromFilename: true
5-
intro: 'If you''re on a {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan, review your estimated costs under usage-based billing and take steps to prepare before the transition.'
6-
versions:
7-
feature: copilot
8-
product: '{% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %}'
9-
contentType: how-tos
10-
category:
11-
- Configure Copilot
12-
---
13-
14-
<!-- expires 2026-06-01 -->
15-
16-
On June 1, 2026, {% data variables.product.prodname_copilot_short %} is moving to usage-based billing with {% data variables.product.prodname_ai_credits %}. Use the tool below to understand how this change affects you before the transition takes effect.
17-
18-
<!-- end expires 2026-06-01 -->
19-
20-
## Download the usage report
21-
22-
From the announcement banner on the premium request analytics page, click **Preview your usage** to see your options. From the dialog, click **{% octicon "download" aria-hidden="true" %} Download CSV** to request a detailed usage report. You can also request the report directly from the premium request analytics page, by clicking **Get usage report**. The report is generated asynchronously and delivered to you via email.
23-
24-
Alongside the existing columns for your current billing data, two additional columns show the estimated equivalent under usage-based billing:
25-
26-
* `aic_quantity`: The number of {% data variables.product.prodname_ai_credits_short %} consumed
27-
* `aic_gross_amount`: The estimated cost in USD under usage-based billing
28-
29-
## See projected spend
30-
31-
For a detailed breakdown, you can upload your CSV to the [billing preview tool](https://copilot-billing-preview.github.com/). The tool gives you a view of your estimated costs, including:
32-
33-
* A side-by-side comparison of your current billing (PRUs) and projected AI Credits (AICs), including total costs with additional usage.
34-
* A detailed breakdown of consumed units, included discounts, and additional usage for each billing model.
35-
36-
> [!NOTE]
37-
> The billing preview tool provides estimated projections for illustrative purposes only. Actual usage may differ. Charges are calculated from actual usage emissions processed by the billing platform, separate from the preview data pipeline.
38-
39-
Your data stays in your browser; nothing is uploaded to a server.
40-
41-
## Prepare for the transition
42-
43-
* **Understand what consumes credits**. {% data variables.copilot.copilot_chat_short %}, {% data variables.copilot.copilot_cli_short %}, {% data variables.copilot.copilot_cloud_agent %}, {% data variables.copilot.copilot_spaces %}, {% data variables.product.prodname_spark_short %}, and third-party coding agents consume {% data variables.product.prodname_ai_credits_short %}. Code completions and {% data variables.copilot.next_edit_suggestions %} remain unlimited for all paid plans.
44-
* **Consider your model usage**. Frontier models consume more credits per interaction than lightweight models. Switching to a lighter model for routine tasks can stretch your included usage further.
45-
46-
## Further reading
47-
48-
* [AUTOTITLE](/copilot/concepts/billing/usage-based-billing-for-individuals)
1+
---
2+
title: Preparing for your move to usage-based billing
3+
shortTitle: Preparing for usage-based billing
4+
allowTitleToDifferFromFilename: true
5+
intro: 'If you''re on a {% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %} plan, review your estimated costs under usage-based billing and take steps to prepare before the transition.'
6+
versions:
7+
feature: copilot
8+
product: '{% data variables.copilot.copilot_pro_short %} or {% data variables.copilot.copilot_pro_plus_short %}'
9+
contentType: how-tos
10+
category:
11+
- Configure Copilot
12+
---
13+
14+
<!-- expires 2026-06-01 -->
15+
16+
On June 1, 2026, {% data variables.product.prodname_copilot_short %} is moving to usage-based billing with {% data variables.product.prodname_ai_credits %}. Use the tool below to understand how this change affects you before the transition takes effect.
17+
18+
<!-- end expires 2026-06-01 -->
19+
20+
## Download the usage report
21+
22+
From the announcement banner on the premium request analytics page, click **Preview your usage** to see your options. From the dialog, click **{% octicon "download" aria-hidden="true" %} Download CSV** to request a detailed usage report. You can also request the report directly from the premium request analytics page, by clicking **Get usage report**. The report is generated asynchronously and delivered to you via email.
23+
24+
Alongside the existing columns for your current billing data, two additional columns show the estimated equivalent under usage-based billing:
25+
26+
* `aic_quantity`: The number of {% data variables.product.prodname_ai_credits_short %} consumed
27+
* `aic_gross_amount`: The estimated cost in USD under usage-based billing
28+
29+
## See projected spend
30+
31+
For a detailed breakdown, you can upload your CSV to the [billing preview tool](https://copilot-billing-preview.github.com/). The tool gives you a view of your estimated costs, including:
32+
33+
* A side-by-side comparison of your current billing (PRUs) and projected AI Credits (AICs), including total costs with additional usage.
34+
* A detailed breakdown of consumed units, included discounts, and additional usage for each billing model.
35+
36+
> [!NOTE]
37+
> The billing preview tool provides estimated projections for illustrative purposes only. Actual usage may differ. Charges are calculated from actual usage emissions processed by the billing platform, separate from the preview data pipeline.
38+
39+
Your data stays in your browser; nothing is uploaded to a server.
40+
41+
## Prepare for the transition
42+
43+
* **Understand what consumes credits**. {% data variables.copilot.copilot_chat_short %}, {% data variables.copilot.copilot_cli_short %}, {% data variables.copilot.copilot_cloud_agent %}, {% data variables.copilot.copilot_spaces %}, {% data variables.product.prodname_spark_short %}, and third-party coding agents consume {% data variables.product.prodname_ai_credits_short %}. Code completions and {% data variables.copilot.next_edit_suggestions %} remain unlimited for all paid plans.
44+
* **Consider your model usage**. Frontier models consume more credits per interaction than lightweight models. Switching to a lighter model for routine tasks can stretch your included usage further.
45+
46+
## Further reading
47+
48+
* [AUTOTITLE](/copilot/concepts/billing/usage-based-billing-for-individuals)
4949
* [AUTOTITLE](/copilot/reference/copilot-billing/models-and-pricing)

content/copilot/tutorials/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,7 @@ children:
3030
- /vibe-coding
3131
- /upgrade-projects
3232
- /copilot-cli-hooks
33+
- /use-an-ai-sme
3334
redirect_from:
3435
- /copilot/using-github-copilot/guides-on-using-github-copilot
3536
contentType: tutorials
@@ -54,4 +55,3 @@ includedCategories:
5455
- Modernize applications
5556
- Roll Copilot out at scale
5657
---
57-

0 commit comments

Comments
 (0)