Differentiate Copilot BYOK features (#62095)

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Sophie <29382425+sophietheking@users.noreply.github.com>

Author: 3 people

content/copilot/concepts/models/bring-your-own-key.md

@@ -0,0 +1,42 @@
+---
+title: Bring your own key for GitHub Copilot
+shortTitle: Bring your own key
+intro: 'Use your existing LLM provider with {% data variables.product.prodname_copilot %} to save costs or consolidate billing.'
+versions:
+  feature: copilot
+contentType: concepts
+---
+
+{% data reusables.copilot.byok-two-mechanisms %}
+
+## Local BYOK
+
+Various {% data variables.product.prodname_copilot_short %} clients allow users to configure custom LLM keys locally.
+
+These keys are only handled client-side: they are stored locally and the associated models aren't available to other users. This mechanism removes dependency on {% data variables.product.github %}'s {% data variables.product.prodname_copilot_short %} API, making it suitable for air-gapped environments or users without {% data variables.product.prodname_copilot_short %} subscriptions.
+
+Local BYOK is available in the following clients.
+
+| Client | More information |
+| --- | --- |
+| {% data variables.product.prodname_vscode_shortname %} | [Add a model from a built in provider](https://code.visualstudio.com/docs/agent-customization/language-models#_add-a-model-from-a-built-in-provider) in the {% data variables.product.prodname_vscode_shortname %} documentation |
+| JetBrains | [Bring your own key (BYOK) support for JetBrains IDEs and Xcode](https://github.blog/changelog/2025-09-11-bring-your-own-key-byok-support-for-jetbrains-ides-and-xcode-in-public-preview/#try-it-out) on {% data variables.product.prodname_blog %} |
+| Xcode | [Bring your own key (BYOK) support for JetBrains IDEs and Xcode](https://github.blog/changelog/2025-09-11-bring-your-own-key-byok-support-for-jetbrains-ides-and-xcode-in-public-preview/#try-it-out) on {% data variables.product.prodname_blog %} |
+| {% data variables.copilot.copilot_cli_short %} | [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models) |
+| {% data variables.copilot.github_copilot_app %} | [AUTOTITLE](/copilot/how-tos/github-copilot-app/use-byok-models) |
+| {% data variables.copilot.copilot_sdk_short %} | [AUTOTITLE](/copilot/how-tos/copilot-sdk/auth/byok) |
+
+For users on a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, the ability to use local BYOK in IDEs can be disabled by an enterprise or organization policy.
+
+## Enterprise BYOK
+
+>[!NOTE]
+>{% data reusables.copilot.byok-preview-note %}
+
+Enterprise owners can add keys for custom models in their enterprise settings. They can also allow organization owners to do the same in their organization settings, by enabling the **Enable custom models** policy.
+
+Custom models are available in {% data variables.copilot.copilot_byok_supported_features %}, and apply to users on the enterprise's {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan. Users can select them in the same way they would select a {% data variables.product.github %}-hosted model.
+
+Enterprise BYOK is handled server-side and affects the models served to users by the {% data variables.product.prodname_copilot_short %} API. Users must have a {% data variables.product.prodname_copilot_short %} license and internet access to use the custom models.
+
+For more information, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models).

content/copilot/concepts/models/index.md

@@ -6,6 +6,7 @@ versions:
   feature: copilot
 contentType: concepts
 children:
+  - /bring-your-own-key
   - /utility-models
   - /auto-model-selection
   - /fedramp-models

…-for-enterprise/use-your-own-api-keys.md …e-for-enterprise/enable-custom-models.mdcontent/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys.md renamed to content/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models.md content/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys.md renamed to content/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models.md

@@ -1,21 +1,20 @@
 ---
-title: Using your LLM provider API keys with Copilot
-shortTitle: Use your own API keys
-intro: 'Learn how to integrate your preferred custom models with {% data variables.product.prodname_copilot %} by using your own LLM API keys, and make them available for organizations in your enterprise account.'
+title: Enabling custom models for GitHub Copilot in your enterprise
+shortTitle: Enable custom models
+intro: Integrate your preferred custom models with {% data variables.product.prodname_copilot %} by using your own LLM API keys, and make them available for organizations in your enterprise account.
 versions:
   feature: copilot-byok
 contentType: how-tos
 allowTitleToDifferFromFilename: true
 category:
   - Configure Copilot
   - Manage Copilot for a team
+redirect_from:
+  - /copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys
 ---
 
 {% data reusables.copilot.byok-intro %}
 
-> [!NOTE]
-> This article covers custom models configured by enterprise owners. {% data variables.copilot.copilot_cli_short %} and {% data variables.product.prodname_vscode_shortname %} users can also use their own LLM keys locally. See [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models) and [Add a model from a built in provider](https://code.visualstudio.com/docs/agent-customization/language-models#_add-a-model-from-a-built-in-provider) in the {% data variables.product.prodname_vscode_shortname %} documentation.
-
 ## Why bring your own API keys?
 
 As an enterprise owner, you may have specific requirements for governance, data security, and compliance. Setting up your own API keys allows you to address:
@@ -28,8 +27,6 @@ As an enterprise owner, you may have specific requirements for governance, data
 
 After you've added your key and selected one or more models, you and members of your organizations will be able to use them with {% data variables.copilot.copilot_byok_supported_features %}. Your models will appear at the bottom of the model picker, under the enterprise name.
 
-> [!NOTE] For members of your organizations to use third-party models in {% data variables.product.prodname_vscode %}, the **Bring Your Own Language Model Key in {% data variables.product.prodname_vscode_shortname %}** policy must be enabled. For more information, see the [{% data variables.product.prodname_copilot_short %} settings page](https://github.com/settings/copilot/features) in {% data variables.product.prodname_dotcom_the_website %}.
-
 {% data reusables.enterprise-accounts.access-enterprise %}
 {% data reusables.enterprise-accounts.ai-controls-tab %}
 1. In the sidebar, click **{% octicon "copilot" aria-hidden="true" aria-label="copilot" %} {% data variables.product.prodname_copilot_short %}**.
@@ -58,4 +55,4 @@ You can choose whether the models you have added are available to organizations
 
 * [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys) in our documentation for organizations.
 * [AUTOTITLE](/copilot/concepts/chat)
-* [AUTOTITLE](/copilot/reference/supported-surfaces-for-policies)
+* [AUTOTITLE](/copilot/reference/supported-surfaces-for-policies)

content/copilot/how-tos/administer-copilot/manage-for-enterprise/index.md

@@ -11,7 +11,7 @@ children:
   - /manage-agents
   - /manage-spark
   - /manage-availability-of-default-models
-  - /use-your-own-api-keys
+  - /enable-custom-models
   - /review-audit-logs
 redirect_from:
   - /copilot/managing-copilot/managing-copilot-for-your-enterprise

…or-organization/use-your-own-api-keys.md …for-organization/enable-custom-models.mdcontent/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys.md renamed to content/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models.md content/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys.md renamed to content/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models.md

@@ -1,27 +1,30 @@
 ---
-title: Using your LLM provider API keys with Copilot
-shortTitle: Use your own API keys
-intro: 'Learn how to integrate your preferred custom models with {% data variables.product.prodname_copilot %} by using your own LLM API keys, and make them available to your organization members.'
+title: Enabling custom models for GitHub Copilot in your organization
+shortTitle: Enable custom models
+intro: Integrate your preferred custom models with {% data variables.product.prodname_copilot %} by using your own LLM API keys, and make them available to your organization members.
 versions:
   feature: copilot-byok
 contentType: how-tos
 allowTitleToDifferFromFilename: true
 category:
   - Configure Copilot
   - Manage Copilot for a team
+redirect_from:
+  - /copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys
 ---
 
 {% data reusables.copilot.byok-intro %}
 
-> [!NOTE]
-> This article covers custom models configured by organization owners. {% data variables.copilot.copilot_cli_short %} and {% data variables.product.prodname_vscode_shortname %} users can also configure their own LLM provider locally, without any administrator setup. See [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models) and [Add a model from a built in provider](https://code.visualstudio.com/docs/agent-customization/language-models#_add-a-model-from-a-built-in-provider) in the {% data variables.product.prodname_vscode_shortname %} documentation.
-
 ## Why bring your own API keys?
 
 As an organization owner, you may have specific requirements for governance, data security, and compliance. Setting up your own API keys allows you to address:
 
 {% data reusables.copilot.byok-why %}
 
+## Prerequisites
+
+An enterprise owner must have enabled the **Enable custom models** policy.
+
 ## Adding your key to an organization account
 
 > [!IMPORTANT] We highly recommend adhering to the principle of least privilege by assigning only the minimum necessary scopes to your API keys.
@@ -38,4 +41,4 @@ After you've added your key and selected one or more models, you and your organi
 
 * [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys) in our documentation for enterprise accounts.
 * [AUTOTITLE](/copilot/concepts/chat)
-* [AUTOTITLE](/copilot/reference/supported-surfaces-for-policies)
+* [AUTOTITLE](/copilot/reference/supported-surfaces-for-policies)

content/copilot/how-tos/administer-copilot/manage-for-organization/index.md

@@ -1,7 +1,7 @@
 ---
 title: Managing GitHub Copilot in your organization
 shortTitle: Manage for organization
-intro: 'Organization owners can subscribe to {% data variables.product.prodname_copilot_short %}, manage {% data variables.product.prodname_copilot_short %} for their organization, and control {% data variables.product.prodname_copilot_short %} policies.'
+intro: Organization owners can subscribe to {% data variables.product.prodname_copilot_short %}, manage {% data variables.product.prodname_copilot_short %} for their organization, and control {% data variables.product.prodname_copilot_short %} policies.
 versions:
   feature: copilot
 redirect_from:
@@ -19,6 +19,7 @@ children:
   - /prepare-for-custom-agents
   - /manage-default-models
   - /review-activity
-  - /use-your-own-api-keys
+  - /enable-custom-models
 contentType: how-tos
 ---
+

content/copilot/how-tos/copilot-on-github/set-up-copilot/configure-access-to-ai-models.md

@@ -23,23 +23,19 @@ Your access to {% data variables.product.prodname_copilot %} models depends on:
 
 For a list of available AI models, see [AUTOTITLE](/copilot/reference/ai-models/supported-models). For information on how {% data variables.copilot.copilot_chat_short %} serves different AI models, see [AUTOTITLE](/copilot/reference/ai-models/model-hosting).
 
-## Setup for individual use
+## Setup for individual plans
 
 For individual {% data variables.product.prodname_copilot_short %} plans, you can use AI models directly within {% data variables.product.prodname_copilot_short %} without configuring access or managing policies. {% data variables.copilot.copilot_free_short %} and {% data variables.copilot.copilot_student_short %} only have access to {% data variables.copilot.copilot_auto_model_selection_short %}.
 
 > [!NOTE]
 > Models available depend on your plan. See [AUTOTITLE](/copilot/reference/ai-models/supported-models#supported-ai-models-per-copilot-plan).
 
-## Setup for organization and enterprise use
+## Setup for organization and enterprise plans
 
 As an enterprise or organization owner, you can enable or disable access to AI models for members with a {% data variables.copilot.copilot_enterprise_short %} or {% data variables.copilot.copilot_business_short %} seat. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies) and [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies).
 
-> [!NOTE]
-> * Models available in {% data variables.copilot.copilot_auto_model_selection %} will follow the policies set for an organization or enterprise. See [AUTOTITLE](/copilot/concepts/models/auto-model-selection).
-> * {% data reusables.copilot.byok-no-subscription-required %}
-
-{% ifversion copilot-byok %}
+## Custom models
 
-You can also integrate your preferred custom models from supported LLM providers by bringing your own API keys. Organization owners can make custom models available for members of their organization and enterprise owners can add custom models and choose which organizations can make use of them. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys) for organizations and [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys) for enterprise accounts.
+{% data reusables.copilot.byok-two-mechanisms %}
 
-{% endif %}
+For more information, see [AUTOTITLE](/copilot/concepts/models/bring-your-own-key).

content/copilot/tutorials/roll-out-at-scale/govern-at-scale/resources-for-approval.md

@@ -53,7 +53,7 @@ These teams need to know how {% data variables.product.prodname_copilot_short %}
 
 * The allowlist required for a firewall or proxy to ensure {% data variables.product.prodname_copilot_short %} works as expected. See [AUTOTITLE](/copilot/reference/copilot-allowlist-reference).
 * The network protocol that {% data variables.product.prodname_copilot_short %} operates on by default, and your company's options for routing traffic through a proxy server and intercepting traffic. See [AUTOTITLE](/copilot/concepts/network-settings).
-* The option to use {% data variables.product.prodname_copilot_short %} in air-gapped environments by bringing your own API keys in {% data variables.product.prodname_vscode_shortname %} or {% data variables.copilot.copilot_cli_short %}. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys).
+* The option to use {% data variables.product.prodname_copilot_short %} in air-gapped environments by configuring API keys locally. See [AUTOTITLE](/copilot/concepts/models/bring-your-own-key#local-byok).
 * The clients where users will be using {% data variables.product.prodname_copilot_short %}.
   * Your enterprise can enable or disable {% data variables.product.prodname_copilot_short %} in IDEs, on {% data variables.product.prodname_mobile %}, in the CLI, and on the {% data variables.product.github %} website.
   * If your company distributes approved software for users, IT teams may need to approve the supported versions of IDEs. See [AUTOTITLE](/copilot/reference/copilot-feature-matrix).

data/reusables/copilot/byok-intro.md

@@ -1,7 +1,7 @@
 >[!NOTE]
 >{% data reusables.copilot.byok-preview-note %}
 
-You can bring your own API keys to {% data variables.product.prodname_copilot %}, and enable teams to use your preferred large language model (LLM) providers with {% data variables.copilot.copilot_byok_supported_features %}.
+You can add custom models to your enterprise or organization by providing your own API keys. This enables teams to use your preferred large language model (LLM) providers with {% data variables.copilot.copilot_byok_supported_features %}.
 
 API keys from the following providers are supported:
 
@@ -13,4 +13,6 @@ API keys from the following providers are supported:
 * OpenAI-compatible providers
 * xAI
 
-Fine-tuned models are also supported, but functionality and quality of results can vary depending on the fine-tuning setup. You should test your model and review its outputs carefully before using it in production.
+Fine-tuned models are also supported, but functionality and quality of results can vary depending on the fine-tuning setup. You should test your model and review its outputs carefully before using it in production.
+
+>[!NOTE] A separate feature allows users to configure their own LLM keys locally in various clients. See [AUTOTITLE](/copilot/concepts/models/bring-your-own-key).

data/reusables/copilot/byok-preview-note.md

@@ -1 +1 @@
-The ability to bring your own API keys to {% data variables.product.prodname_copilot %} is in {% data variables.release-phases.public_preview %} and subject to change.
+This feature is in {% data variables.release-phases.public_preview %} and subject to change.