Skip to content

Commit b65b056

Browse files
isaacmbrownCopilot
andauthored
Utility models (#61281)
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
1 parent 5f91b48 commit b65b056

9 files changed

Lines changed: 79 additions & 21 deletions

File tree

content/copilot/concepts/index.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,14 @@ children:
1313
- /prompting
1414
- /context
1515
- /tools
16-
- /auto-model-selection
16+
- /models
1717
- /usage-limits
1818
- /billing
1919
- /about-enterprise-accounts-for-copilot-business
2020
- /policies
2121
- /mcp-management
22-
- /fedramp-models
2322
- /network-settings
24-
- /fallback-and-lts-models
2523
- /preparing-for-new-features-and-models
2624
contentType: concepts
2725
---
26+

content/copilot/concepts/auto-model-selection.md renamed to content/copilot/concepts/models/auto-model-selection.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,8 +7,10 @@ product: '{% data variables.copilot.copilot_auto_model_selection_short_cap_a %}
77
versions:
88
feature: copilot
99
contentType: concepts
10-
category:
10+
category:
1111
- Learn about Copilot
12+
redirect_from:
13+
- /copilot/concepts/auto-model-selection
1214
---
1315

1416
## Overview
@@ -17,14 +19,14 @@ More than just a model picker, {% data variables.copilot.copilot_auto_model_sele
1719

1820
### Auto with task optimization
1921

20-
> [!NOTE] {% data variables.copilot.copilot_auto_model_selection_short_cap_a %} with task optimization is generally available in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %}.
22+
> [!NOTE] {% data variables.copilot.copilot_auto_model_selection_short_cap_a %} with task optimization is generally available in {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %}.
2123
2224
{% data variables.copilot.copilot_auto_model_selection_short_cap_a %} with task optimization combines two systems to provide high quality results and better reliability. One system tracks real-time system health and availability, while the other evaluates task complexity. Putting these together, {% data variables.copilot.copilot_auto_model_selection_short %} routes the task to the optimal model.
2325

24-
Routing occurs along natural cache boundaries to avoid additional cache related costs. Switching models mid-session has shown increased cost without ample improvements in quality.
26+
Routing occurs along natural cache boundaries to avoid additional cache related costs. Switching models mid-session has shown increased cost without ample improvements in quality.
2527
This helps you get more value from {% data variables.product.prodname_copilot_short %} since it matches each task to the model that can solve it most efficiently. That means reserving higher-cost reasoning models for problems that truly need it, while routing straightforward tasks to faster, lower-cost models that still deliver great results.
2628

27-
Benefits of using {% data variables.copilot.copilot_auto_model_selection_short %} include:
29+
Benefits of using {% data variables.copilot.copilot_auto_model_selection_short %} include:
2830
* Matching each task to the model that can solve it most efficiently.
2931
* Model choice based on real-time system health and availability.
3032
* Language invariance: Routing decisions depend on what you are trying to do, not what language you're asking in.
@@ -46,36 +48,36 @@ When you select **Auto**, {% data variables.copilot.copilot_auto_model_selection
4648
* Models not available in your plan.
4749
* Models excluded by administrator policies. See [AUTOTITLE](/copilot/how-tos/copilot-on-github/set-up-copilot/configure-access-to-ai-models).
4850
* Models excluded by policies restricting {% data variables.product.prodname_copilot_short %} to data-resident or FedRAMP-compliant models.
49-
* Models with premium request multipliers greater than one.
51+
* Models with premium request multipliers greater than one.
5052

5153
### Multiplier discounts
5254

5355
{% data reusables.copilot.auto-model-multiplier-discount %} See [AUTOTITLE](/copilot/concepts/billing/copilot-requests#model-multipliers).
5456

5557
## {% data variables.copilot.copilot_auto_model_selection_short_cap_a %} in {% data variables.product.prodname_copilot_short %}
5658

57-
{% data variables.copilot.copilot_auto_model_selection_short_cap_a %}, optimized for model reliability and availability, is available in these {% data variables.product.prodname_copilot_short %} products:
59+
{% data variables.copilot.copilot_auto_model_selection_short_cap_a %}, optimized for model reliability and availability, is available in these {% data variables.product.prodname_copilot_short %} products:
5860
* {% data variables.copilot.copilot_chat_short %}
5961
* {% data variables.copilot.copilot_cli_short %}
60-
* {% data variables.copilot.copilot_cloud_agent %}
62+
* {% data variables.copilot.copilot_cloud_agent %}
6163

6264
> [!TIP]
6365
> You can see which model was used for each {% data variables.product.prodname_copilot_short %} response.
6466
> * In **{% data variables.copilot.copilot_chat_short %}**, hover over the response.
6567
> * In **{% data variables.copilot.copilot_cli_short %}**, the model used for each response displays in the terminal.
66-
> * In **{% data variables.copilot.copilot_cloud_agent %}**, the model used for each response displays at the end of the response.
68+
> * In **{% data variables.copilot.copilot_cloud_agent %}**, the model used for each response displays at the end of the response.
6769
6870
### {% data variables.copilot.copilot_chat_short %} in IDEs
6971

70-
{% data variables.copilot.copilot_auto_model_selection_short_cap_a %}, with task optimization, is generally available in the following IDEs:
72+
{% data variables.copilot.copilot_auto_model_selection_short_cap_a %}, with task optimization, is generally available in the following IDEs:
7173
* {% data variables.product.prodname_vscode_shortname %}
7274

7375
{% data variables.copilot.copilot_auto_model_selection_short_cap_a %}, optimized for model reliability and availability, is generally available in the following IDEs:
7476
* JetBrains IDEs
7577
* Eclipse
7678
* Xcode
7779

78-
{% data variables.copilot.copilot_auto_model_selection_short_cap_a %}, optimized for model reliability and availability, is in public preview in the following IDEs:
80+
{% data variables.copilot.copilot_auto_model_selection_short_cap_a %}, optimized for model reliability and availability, is in public preview in the following IDEs:
7981
* {% data variables.product.prodname_vs %}
8082

8183
#### Enabling access during {% data variables.release-phases.public_preview %}
@@ -88,15 +90,15 @@ When you select **Auto** in the {% data variables.product.prodname_openai_codex
8890

8991
### {% data variables.product.prodname_openai_codex %} supported models
9092

91-
These models are available for {% data variables.copilot.copilot_auto_model_selection_short_cap_a %} in the {% data variables.product.prodname_openai_codex %} coding agent.
93+
These models are available for {% data variables.copilot.copilot_auto_model_selection_short_cap_a %} in the {% data variables.product.prodname_openai_codex %} coding agent.
9294

9395
{% data reusables.copilot.openai-codex-agent-models %}
9496

9597
For more information, see [AUTOTITLE](/copilot/concepts/agents/openai-codex).
9698

9799
### {% data variables.product.prodname_anthropic_claude %} supported models
98100

99-
These models are available for {% data variables.copilot.copilot_auto_model_selection_short_cap_a %} in the {% data variables.product.prodname_anthropic_claude %} coding agent.
101+
These models are available for {% data variables.copilot.copilot_auto_model_selection_short_cap_a %} in the {% data variables.product.prodname_anthropic_claude %} coding agent.
100102

101103
{% data reusables.copilot.anthropic-claude-agent-models %}
102104

content/copilot/concepts/fallback-and-lts-models.md renamed to content/copilot/concepts/models/fallback-and-lts-models.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,15 @@
11
---
22
title: Base and long-term support (LTS) models
33
shortTitle: Base and LTS models
4-
intro: 'Learn about base models, long-term support (LTS) models, and how they affect model availability for enterprises using {% data variables.product.prodname_copilot %}.'
4+
intro: Learn about base models, long-term support (LTS) models, and how they affect model availability for enterprises using {% data variables.product.prodname_copilot %}.
55
versions:
66
feature: copilot
77
allowTitleToDifferFromFilename: true
88
contentType: concepts
99
category:
1010
- Manage Copilot for a team
11+
redirect_from:
12+
- /copilot/concepts/fallback-and-lts-models
1113
---
1214

1315
## About base models

content/copilot/concepts/fedramp-models.md renamed to content/copilot/concepts/models/fedramp-models.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
---
22
title: FedRAMP-compliant models for GitHub Copilot
33
shortTitle: FedRAMP models
4-
intro: "Restrict users to models with FedRAMP Moderate certification."
4+
intro: Restrict users to models with FedRAMP Moderate certification.
55
versions:
66
feature: copilot
77
product: '{% data variables.enterprise.data_residency %}'
88
contentType: concepts
9+
redirect_from:
10+
- /copilot/concepts/fedramp-models
911
---
1012

1113
If your enterprise uses {% data variables.enterprise.data_residency %} in the US, you can enable a policy to ensure that users on your {% data variables.product.prodname_copilot_short %} plan can only use models with **FedRAMP Moderate** certification.
@@ -34,4 +36,4 @@ Enabling the FedRAMP policy restricts users to the following models:
3436

3537
To enable this policy, use the **Restrict {% data variables.product.prodname_copilot_short %} to FedRAMP models** policy in the "Features" section of your enterprise's {% data variables.product.prodname_copilot_short %} policies. This policy is disabled by default, and enabling it will affect your pricing for {% data variables.product.prodname_copilot_short %} requests.
3638

37-
For instructions on finding your policies page, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies).
39+
For instructions on finding your policies page, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies).
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
---
2+
title: Models for GitHub Copilot
3+
shortTitle: Models
4+
intro: Learn about the AI models available for {% data variables.product.prodname_copilot %}.
5+
versions:
6+
feature: copilot
7+
contentType: concepts
8+
children:
9+
- /utility-models
10+
- /auto-model-selection
11+
- /fedramp-models
12+
- /fallback-and-lts-models
13+
---
14+
Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
title: Utility models
3+
intro: 'Utility models power background {% data variables.product.prodname_copilot_short %} features.'
4+
versions:
5+
feature: copilot
6+
contentType: concepts
7+
---
8+
9+
Utility models are a small set of models that are automatically enabled for all {% data variables.product.prodname_copilot %} users across every plan. They power background features such as the generation of commit messages or chat session titles, and they apply across {% data variables.product.prodname_copilot_short %} surfaces: in IDEs, on {% data variables.product.github %}, and in {% data variables.copilot.copilot_cli_short %}.
10+
11+
## How do utility models work?
12+
13+
Utility models:
14+
15+
* Are **not** visible in the model picker and cannot be selected by users directly.
16+
* **Cannot** be disabled by organization or enterprise administrators, except by disabling {% data variables.product.prodname_copilot_short %} completely.
17+
* Do **not** consume premium request units or tokens for usage-based billing, and do **not** appear as a billed line item in usage reports.
18+
* **Are** subject to per-user rate limits.
19+
20+
These characteristics ensure that {% data variables.product.prodname_copilot_short %} features work smoothly regardless of your model policies and billing controls.
21+
22+
## List of utility models
23+
24+
Utility models are typically selected for being fast and lightweight. {% data reusables.copilot.utility-models %}

content/copilot/concepts/preparing-for-new-features-and-models.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,18 +54,21 @@ You can find information about the models available and upcoming models in the f
5454
* **Model comparison**: To compare model capabilities side by side, see [AUTOTITLE](/copilot/reference/ai-models/model-comparison).
5555
* **Changelog**: Model updates are announced in the [{% data variables.product.prodname_copilot_short %} changelog](https://github.blog/changelog/label/copilot/).
5656

57-
To plan for model transitions and set user expectations, track which models {% data variables.product.github %} designates as base or long-term support (LTS):
57+
#### Special categories
58+
59+
{% data variables.product.company_short %} categorizes certain types of model, allowing you to plan for model transitions and set user expectations.
5860

5961
{% rowheaders %}
6062

6163
| Model type | Description | Why it matters |
6264
| --- | --- | --- |
65+
| Utility model | A small set of models that power background {% data variables.product.company_short %} features across surfaces. | Your enterprise cannot disable these models. Monitor these to ensure they are compliant. |
6366
| Base model | The default model when no other models are enabled. | Automatically enabled within 60 days of designation. |
6467
| LTS model | A model supported for one year from designation. | Allows enterprises to build workflows around a stable model. |
6568

6669
{% endrowheaders %}
6770

68-
For more information, see [AUTOTITLE](/copilot/concepts/fallback-and-lts-models).
71+
For more information, see [AUTOTITLE](/copilot/concepts/models/utility-models) and [AUTOTITLE](/copilot/concepts/models/fallback-and-lts-models).
6972

7073
## Considering different release stages
7174

content/copilot/reference/ai-models/supported-models.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ Some {% data variables.product.prodname_copilot_short %} models require minimum
107107
{% endrowheaders %}
108108

109109
> [!NOTE]
110-
>
110+
>
111111
> * For {% data variables.copilot.copilot_gpt_53_codex %} in {% data variables.product.prodname_vscode %}, `v1.108` and later provide improved prompting and response quality.
112112
> * "No minimum listed" means the reviewed changelog or release guidance did not specify a minimum version, not that all older versions are supported.
113113
> * Even when a model appears in the model picker on older supported versions, prompting and model behavior may work best with the latest IDE and {% data variables.product.prodname_copilot_short %} extension or plugin versions.
@@ -154,6 +154,12 @@ For more information about fallback and LTS models, see [AUTOTITLE](/copilot/con
154154
155155
Evaluation models may be added, updated, or removed without notice. Availability and rate limits may differ from generally available models.
156156

157+
## Utility models
158+
159+
Utility models power background features across surfaces, and cannot be disabled or selected in the model picker. See [AUTOTITLE](/copilot/concepts/models/utility-models).
160+
161+
{% data reusables.copilot.utility-models %}
162+
157163
## Next steps
158164

159165
* For task-based guidance on selecting a model, see [AUTOTITLE](/copilot/reference/ai-models/model-comparison).
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
The following models are currently used as utility models:
2+
3+
* {% data variables.copilot.copilot_gpt_4o_mini %}
4+
* {% data variables.copilot.copilot_gpt_4o %}
5+
* {% data variables.copilot.copilot_gpt_41 %}
6+
* {% data variables.copilot.copilot_gpt_54_nano %}

0 commit comments

Comments
 (0)