diff --git a/assets/images/help/copilot/vsc-manage-models-list.png b/assets/images/help/copilot/vsc-manage-models-list.png new file mode 100644 index 0000000000..4144779f53 Binary files /dev/null and b/assets/images/help/copilot/vsc-manage-models-list.png differ diff --git a/assets/images/help/copilot/vsc-manage-models-option.png b/assets/images/help/copilot/vsc-manage-models-option.png new file mode 100644 index 0000000000..bcc1d114b7 Binary files /dev/null and b/assets/images/help/copilot/vsc-manage-models-option.png differ diff --git a/content/copilot/how-tos/use-ai-models/change-the-chat-model.md b/content/copilot/how-tos/use-ai-models/change-the-chat-model.md index aa1d180d15..b73c0e3d0d 100644 --- a/content/copilot/how-tos/use-ai-models/change-the-chat-model.md +++ b/content/copilot/how-tos/use-ai-models/change-the-chat-model.md @@ -61,7 +61,47 @@ These instructions are for {% data variables.product.prodname_vscode %}. For ins {% data reusables.copilot.chat-model-limitations-ide %} {% data reusables.copilot.open-chat-vs-code %} -1. In the bottom right of the chat view, select the **CURRENT-MODEL** {% octicon "chevron-down" aria-hidden="true" aria-label="chevron-down" %} dropdown menu, then click the AI model of your choice. +1. At the bottom of the chat view, select the **CURRENT-MODEL** {% octicon "chevron-down" aria-hidden="true" aria-label="chevron-down" %} dropdown menu, then click the AI model of your choice. + +## Adding more models + +You can expand the model options that are available to power {% data variables.copilot.copilot_chat_short %}. You can add models from: + +* **A model provider**—such as Anthropic, Gemini, OpenAI, and others. +* **The AI Toolkit for {% data variables.product.prodname_vscode %}**. + +> [!NOTE] Using the AI Toolkit for {% data variables.product.prodname_vscode_shortname %} is in {% data variables.release-phases.public_preview %} and subject to change. + +### Prerequisites + +* Depending on the provider or model you choose, you may need to supply an API key, or model ID, from the provider, or a {% data variables.product.github %} {% data variables.product.pat_generic %} (PAT). +* To add models from the AI Toolkit for {% data variables.product.prodname_vscode %}, you must install the AI Toolkit extension. + +### Adding models + +1. In the {% data variables.product.prodname_copilot_short %} chat view, click the **CURRENT-MODEL** {% octicon "chevron-down" aria-hidden="true" aria-label="chevron-down" %} dropdown menu. +1. Click **Manage Models**. + + ![Screenshot of the 'Manage Models' option, highlighted with a dark orange outline.](/assets/images/help/copilot/vsc-manage-models-option.png) + + A list of providers is displayed. + + If you have installed the AI Toolkit, then additional providers, added via the AI Toolkit, are also listed. + + ![Screenshot of the 'Manage Language Models' list.](/assets/images/help/copilot/vsc-manage-models-list.png) + +1. Click the provider whose model(s) you want to add. +1. Depending on which provider you selected, you may be prompted to enter a {% data variables.product.github %} PAT, an API key for the provider, or a model ID for a specific model. + + Enter the required information, then press Enter. + + A list of available models is displayed. + +1. Select the model(s) you want to add, then click **OK**. + +The models you selected are now available in the model picker in the chat view. + +If you added a model from a provider via the AI Toolkit then the first time you use the model, you will be prompted to download it. You may also be prompted to authenticate with the provider. > [!TIP] If you're already using chat with {% data variables.copilot.copilot_auto_model_selection_short %}, you'll need to start a new chat session to switch models. To start a new session, in the top right of the chat view, click {% octicon "plus" aria-label="new chat" %} new chat. @@ -137,3 +177,9 @@ To use multi-model {% data variables.copilot.copilot_chat_short %}, you must ins * [AUTOTITLE](/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-code-completion) * [AUTOTITLE](/copilot/reference/ai-models/model-comparison) + +{% vscode %} + +* [AI language models in VS Code](https://code.visualstudio.com/docs/copilot/language-models#_bring-your-own-language-model-key) in the {% data variables.product.prodname_vscode %} documentation. + +{% endvscode %} diff --git a/content/copilot/reference/ai-models/supported-models.md b/content/copilot/reference/ai-models/supported-models.md index fa988d5505..e152ddca4e 100644 --- a/content/copilot/reference/ai-models/supported-models.md +++ b/content/copilot/reference/ai-models/supported-models.md @@ -25,9 +25,11 @@ contentType: reference Depending on your {% data variables.product.prodname_copilot_short %} plan and where you're using it—such as {% data variables.product.prodname_dotcom_the_website %} or an IDE—you may have access to different models. ->[!NOTE] Model availability is subject to change. Some models may be replaced or updated over time. +> [!NOTE] +> * Model availability is subject to change. Some models may be replaced or updated over time. +> * In {% data variables.product.prodname_vscode %} you can add more models than those that are available by default with your {% data variables.product.prodname_copilot_short %} subscription. See [AUTOTITLE](/copilot/how-tos/use-ai-models/change-the-chat-model?tool=vscode#adding-more-models). -For all AI models, input prompts and output completions run through {% data variables.product.prodname_copilot %}'s content filters for harmful, offensive, or off-topic content, and for public code matching when enabled. +For all of the default AI models, input prompts and output completions run through {% data variables.product.prodname_copilot %}'s content filters for harmful, offensive, or off-topic content, and for public code matching when enabled. ## Supported AI models in {% data variables.product.prodname_copilot_short %} diff --git a/data/reusables/copilot/editor-preview-settings.md b/data/reusables/copilot/editor-preview-settings.md index 2ab1fe6877..d048c77e05 100644 --- a/data/reusables/copilot/editor-preview-settings.md +++ b/data/reusables/copilot/editor-preview-settings.md @@ -1 +1 @@ -If you're using a {% data variables.copilot.copilot_business_short %}{% ifversion ghec %} or {% data variables.copilot.copilot_enterprise_short %}{% endif %} plan, the organization{% ifversion ghec %} or enterprise{% endif %} that provides your plan must enable the **Editor preview features** setting. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization){% ifversion ghec %} or [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#configuring-policies-for-github-copilot){% endif %}. +If you're using a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} plan, the organization or enterprise that provides your plan must enable the **Editor preview features** setting. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization) or [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise#configuring-policies-for-github-copilot).