Skip to content

Update docs for UBB#9830

Draft
ntrogh wants to merge 15 commits into
mainfrom
ntrogh/ubb
Draft

Update docs for UBB#9830
ntrogh wants to merge 15 commits into
mainfrom
ntrogh/ubb

Conversation

@ntrogh
Copy link
Copy Markdown
Collaborator

@ntrogh ntrogh commented May 26, 2026

This pull request updates the Copilot documentation and related configuration to reflect the transition from "premium requests" to "AI credits" for usage-based billing and model consumption.

The changes clarify how AI credits are consumed, provide practical tips for optimizing credit usage, and update references and terminology throughout the docs.

Additionally, new guidance and links are added to help users manage and reduce AI credit consumption.

Key changes include:

Documentation terminology and billing updates:

  • Replaced references to "premium requests" with "AI credits" across multiple documentation files, including details on how credits are consumed, how different models and features affect credit usage, and links to usage-based billing documentation.

Guidance on optimizing AI credit usage:

  • Added new documentation links and tips throughout the docs to help users optimize and manage AI credit consumption, including context compaction, tool selection, and session management strategies.

Other documentation improvements:

  • Clarified language and updated examples in best practices and feature guides, including the impact of context management and tool usage on credit consumption.

Implements #9774, #9775

@ntrogh ntrogh assigned bhavyaus and unassigned bhavyaus May 26, 2026
@ntrogh ntrogh requested a review from bhavyaus May 26, 2026 11:16
Comment thread docs/copilot/agents/agent-tools.md Outdated
Comment thread docs/copilot/chat/copilot-chat.md
Comment thread docs/copilot/guides/optimize-usage.md Outdated
Comment thread docs/copilot/guides/optimize-usage.md Outdated
Comment thread docs/copilot/guides/optimize-usage.md Outdated

For more information, see [context compaction](/docs/copilot/chat/copilot-chat-context.md#context-compaction).

## Monitor your usage
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can also add a nudge to the new chronicle cost tips command microsoft/vscode#317809

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot Add a cross-link to the session-insights article and /chronicle:cost-tips

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implemented in 0b9b6e5.

### AI credits and model costs

Different models consume premium requests at different rates, expressed as a multiplier. For example, a model with a 2x multiplier uses two premium requests per interaction. When you use auto model selection, VS Code applies a variable [model multiplier](https://docs.github.com/en/copilot/concepts/billing/copilot-requests#model-multipliers) based on the selected model. If you are on a paid Copilot plan, auto applies a 10% multiplier discount.
Each Copilot plan includes a monthly allowance of [AI credits](https://docs.github.com/en/copilot/concepts/billing/usage-based-billing-for-individuals). Different models consume AI credits at different rates, based on the model and the number of tokens processed. More capable models cost more per token, while lighter models extend your usage further. When you use auto model selection, VS Code routes each request to an efficient model that balances quality and cost.
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@cwebster-99 Did you mean to say "cost more per tokens"? Sounds weird.

ntrogh and others added 2 commits May 26, 2026 16:27
Co-authored-by: Courtney Webster <60238438+cwebster-99@users.noreply.github.com>
Copilot finished work on behalf of ntrogh May 26, 2026 14:50
Comment thread docs/copilot/chat/copilot-chat.md Outdated
> [!IMPORTANT]
> **Starting April 20, 2026**, new sign-ups for Copilot Pro, Copilot Pro+, and student plans are temporarily paused. Additionally, we are tightening weekly usage limits. See [GitHub Copilot usage limits](https://docs.github.com/copilot/concepts/usage-limits).
> [!IMPORTANT]
> **Starting April 20, 2026**, new sign-ups for Copilot Pro, Copilot Pro+, and student plans are temporarily paused. Additionally, we are tightening weekly usage limits. See [GitHub Copilot usage limits](https://docs.github.com/copilot/concepts/usage-limits).
Copy link
Copy Markdown
Member

@cwebster-99 cwebster-99 May 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Upgrades will be unblocked June 1 for existing users in case we want to call that out but new sign ups are still disabled. They also plan to remove the weekly limits.

Suggested change
> **Starting April 20, 2026**, new sign-ups for Copilot Pro, Copilot Pro+, and student plans are temporarily paused. Additionally, we are tightening weekly usage limits. See [GitHub Copilot usage limits](https://docs.github.com/copilot/concepts/usage-limits).
> **Starting April 20, 2026**, new sign-ups for Copilot Pro, Copilot Pro+, Max, and Student plans are temporarily paused.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot Update other occurrences of this text and apply the same update.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot Update other occurrences of this text and apply the same update.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Implemented in 9b6f765.

Co-authored-by: Courtney Webster <60238438+cwebster-99@users.noreply.github.com>
Copilot finished work on behalf of ntrogh May 27, 2026 21:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants