From 4f1b56ecf2368cc6c43c2cf859f7f5628d4c0554 Mon Sep 17 00:00:00 2001 From: hubwriter Date: Tue, 29 Oct 2024 16:10:10 +0000 Subject: [PATCH] Tented content (#52900) Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com> Co-authored-by: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com> Co-authored-by: Vanessa Co-authored-by: isaacmbrown Co-authored-by: Christopher Nguyen <91625426+nguyen-dows@users.noreply.github.com> Co-authored-by: Sophie <29382425+sophietheking@users.noreply.github.com> Co-authored-by: Felicity Chapman Co-authored-by: Andrew Eisenberg Co-authored-by: Ben Ahmady <32935794+subatoi@users.noreply.github.com> Co-authored-by: Sam Browning <106113886+sabrowning1@users.noreply.github.com> Co-authored-by: David Staheli <1767415+davidstaheli@users.noreply.github.com> Co-authored-by: Sarita Iyer <66540150+saritai@users.noreply.github.com> Co-authored-by: sunbrye Co-authored-by: Tim Rogers Co-authored-by: Felix Guntrip Co-authored-by: Sunbrye Ly <56200261+sunbrye@users.noreply.github.com> Co-authored-by: James Fletcher <42464962+jf205@users.noreply.github.com> Co-authored-by: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Co-authored-by: Jules <19994093+jules-p@users.noreply.github.com> Co-authored-by: Hector Alfaro Co-authored-by: Laura Coursen Co-authored-by: Jules Porter Co-authored-by: Devraj Mehta Co-authored-by: Kate Studwell Co-authored-by: Katherine Oelsner <49968061+octokatherine@users.noreply.github.com> Co-authored-by: Rachael Sewell Co-authored-by: jc-clark Co-authored-by: Tim Rogers Co-authored-by: Matthew Isabel --- ...ot-policies-as-an-individual-subscriber.md | 15 ++--- ...features-for-copilot-in-your-enterprise.md | 5 ++ ...licies-for-copilot-in-your-organization.md | 2 +- ...king-github-copilot-questions-in-github.md | 4 +- content/copilot/using-github-copilot/index.md | 1 + .../using-claude-sonnet-in-github-copilot.md | 55 +++++++++++++++++++ data/reusables/copilot/chat-dotcom-beta.md | 1 - .../copilot/copilot-chat-models-list.md | 11 ++-- .../copilot/model-picker-enable-o1-models.md | 2 +- .../user-settings/copilot-settings.md | 2 +- data/variables/copilot.yml | 3 + 11 files changed, 84 insertions(+), 17 deletions(-) create mode 100644 content/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot.md delete mode 100644 data/reusables/copilot/chat-dotcom-beta.md diff --git a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-policies-as-an-individual-subscriber.md b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-policies-as-an-individual-subscriber.md index 76271ff8bd33..4cb9f3fa62ed 100644 --- a/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-policies-as-an-individual-subscriber.md +++ b/content/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-policies-as-an-individual-subscriber.md @@ -26,10 +26,8 @@ Your personal settings for {% data variables.product.prodname_copilot %} include If you choose to allow suggestions matching public code, and you accept a suggestion for which one or more matches were found, you can click through from an entry in the {% data variables.product.prodname_copilot %} log to view a list of references on {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions)." -{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.copilot-settings %} -1. Under **Suggestions matching public code**, select the dropdown menu, then click **Allow** to allow suggestions matching public code, or **Block** to block suggestions matching public code. -{% data reusables.copilot.save-settings %} +1. To the right of **Suggestions matching public code**, select the dropdown menu, then click **Allow** to allow suggestions matching public code, or **Block** to block suggestions matching public code. {% ifversion fpt %} @@ -37,18 +35,21 @@ If you choose to allow suggestions matching public code, and you accept a sugges You can choose whether your prompts and {% data variables.product.prodname_copilot_short %}'s suggestions are collected and retained by {% data variables.product.prodname_dotcom %}, and further processed and shared with Microsoft. For more information about data that {% data variables.product.prodname_copilot %} may collect depending on your settings, see "[AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)" and the [{% data variables.product.prodname_copilot %} privacy FAQ](https://github.com/features/copilot/#faq-privacy-copilot-for-business). -{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.copilot-settings %} 1. To allow or prevent {% data variables.product.prodname_dotcom %} using your data, select or deselect **Allow {% data variables.product.prodname_dotcom %} to use my code snippets from the code editor for product improvements**. -{% data reusables.copilot.save-settings %} + +## Enabling or disabling {% data variables.copilot.copilot_claude_sonnet %} + +You can choose whether to allow use of Anthropic's {% data variables.copilot.copilot_claude_sonnet %} model as an alternative to {% data variables.product.prodname_copilot_short %}'s default model. For more information, see "[AUTOTITLE](/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot)." + +{% data reusables.user-settings.copilot-settings %} +1. To the right of **Anthropic {% data variables.copilot.copilot_claude_sonnet %} in {% data variables.product.prodname_copilot_short %}**, select the dropdown menu, then click **Enabled** or **Disabled**. ## Enabling or disabling web search for {% data variables.product.prodname_copilot_chat %} You can enable web search for {% data variables.product.prodname_copilot_chat %}. This setting is disabled by default. If you enable this setting, {% data variables.product.prodname_copilot_chat_short %} will use Bing to search the internet for information related to a question. Bing search is particularly helpful when discussing new technologies or highly specific subjects. -{% data reusables.user-settings.access_settings %} {% data reusables.user-settings.copilot-settings %} 1. To the right of **{% data variables.product.prodname_copilot_short %} access to Bing**, select the dropdown menu, and then click **Enabled** or **Disabled**. -{% data reusables.copilot.save-settings %} {% endif %} diff --git a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise.md b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise.md index 5af929b67ac4..ed3510926ca6 100644 --- a/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise.md +++ b/content/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise.md @@ -33,6 +33,7 @@ You can configure any of the following policies for your enterprise: * [{% data variables.product.prodname_copilot_extensions %}](#github-copilot-extensions) * [Suggestions matching public code](#suggestions-matching-public-code) * [Give {% data variables.product.prodname_copilot_short %} access to Bing](#give-copilot-access-to-bing) +* [{% data variables.product.prodname_copilot_short %} access to {% data variables.copilot.copilot_claude_sonnet %}](#copilot-access-to-claude-35-sonnet) * [{% data variables.product.prodname_copilot_short %} access to the o1 family of models](#copilot-access-to-the-o1-family-of-models) ### {% data variables.product.prodname_copilot_short %} in {% data variables.product.prodname_dotcom_the_website %} @@ -74,6 +75,10 @@ You can chat with {% data variables.product.prodname_copilot %} in your IDE to g {% data variables.product.prodname_copilot_chat %} can use Bing to provide enhanced responses by searching the internet for information related to a question. Bing search is particularly helpful when discussing new technologies or highly specific subjects. +### {% data variables.product.prodname_copilot_short %} access to {% data variables.copilot.copilot_claude_sonnet %} + +If you grant access to **Anthropic {% data variables.copilot.copilot_claude_sonnet %} in {% data variables.product.prodname_copilot_short %}**, members of your enterprise can choose to use this model rather than the default `GPT 4o` model. For more information, see "[AUTOTITLE](/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot)." + ### {% data variables.product.prodname_copilot_short %} access to the o1 family of models {% data reusables.models.o1-models-preview-note %} diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization.md index b5abf4cfb4f3..ec44bce8585c 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization.md @@ -28,7 +28,7 @@ Organization owners can set policies to govern how {% data variables.product.pro * {% data variables.product.prodname_copilot_mobile_short %} * {% data variables.product.prodname_copilot_cli_short %} and {% data variables.product.prodname_windows_terminal %} * Suggestions matching public code -* {% data variables.product.prodname_copilot_short %} access to the o1 family of models +* Access to alternative models for {% data variables.product.prodname_copilot_short %} The policy settings selected by an organization owner determine the behavior of {% data variables.product.prodname_copilot %} for all organization members that have been granted access to {% data variables.product.prodname_copilot_short %} through the organization. diff --git a/content/copilot/using-github-copilot/asking-github-copilot-questions-in-github.md b/content/copilot/using-github-copilot/asking-github-copilot-questions-in-github.md index 41514bee7d9a..ce4d578fe456 100644 --- a/content/copilot/using-github-copilot/asking-github-copilot-questions-in-github.md +++ b/content/copilot/using-github-copilot/asking-github-copilot-questions-in-github.md @@ -13,7 +13,7 @@ redirect_from: - /copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom --- -> [!NOTE] {% data reusables.copilot.chat-dotcom-beta %} +> [!NOTE] {% data variables.product.prodname_copilot_chat_dotcom %} is currently in {% data variables.release-phases.public_preview %} and is subject to change. ## Overview @@ -75,7 +75,7 @@ The skills you can use in {% data variables.product.prodname_copilot_chat_dotcom ### Changing your AI model > [!NOTE] -> * The `o1-preview` and `o1-mini` models do not have access to skills {% ifversion ghec %}or knowledge bases {% endif %}in {% data variables.product.prodname_copilot_chat_dotcom %}. If you want to use skills {% ifversion ghec %}or knowledge bases {% endif %}on {% data variables.product.github %}, you must use the `gpt-4o` model. +> * If you want to use the skills listed in the table above{% ifversion ghec %}, or knowledge bases{% endif %}, on the {% data variables.product.github %} website, you must use the `gpt-4o` model. > * If you use {% data variables.product.prodname_copilot_extensions_short %}, they may override the model you select. > * Experimental pre-release versions of the models may not interact with all filters correctly, including the duplication detection filter. diff --git a/content/copilot/using-github-copilot/index.md b/content/copilot/using-github-copilot/index.md index 7bc478a12faf..abcf9f43add9 100644 --- a/content/copilot/using-github-copilot/index.md +++ b/content/copilot/using-github-copilot/index.md @@ -18,6 +18,7 @@ children: - /using-github-copilot-in-the-command-line - /prompt-engineering-for-github-copilot - /using-extensions-to-integrate-external-tools-with-copilot-chat + - /using-claude-sonnet-in-github-copilot - /finding-public-code-that-matches-github-copilot-suggestions - /using-github-copilot-for-pull-requests - /example-use-cases diff --git a/content/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot.md b/content/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot.md new file mode 100644 index 000000000000..3e34fe1af9d3 --- /dev/null +++ b/content/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot.md @@ -0,0 +1,55 @@ +--- +title: Using Claude 3.5 Sonnet in GitHub Copilot +allowTitleToDifferFromFilename: true +shortTitle: 'Use {% data variables.copilot.copilot_claude_sonnet %}' +intro: 'Learn how to enable {% data variables.copilot.copilot_claude_sonnet %} for {% ifversion fpt %}yourself or{% endif %} your organization{% ifversion ghec %} or enterprise{% endif %}.' +versions: + feature: copilot +topics: + - Copilot +--- + +> [!NOTE] {% data variables.copilot.copilot_claude_sonnet %} is in {% data variables.release-phases.public_preview %} and subject to change. The "[AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms)" apply to your use of this product. + +## {% data variables.copilot.copilot_claude_sonnet %} announcement and rollout + +{% data variables.copilot.copilot_claude_sonnet %} availability in {% data variables.product.prodname_copilot %} was announced on October 29th at GitHub Universe 2024. Access to the model will roll out progressively over an estimated two-week period to all {% data variables.product.prodname_copilot_short %} plans. This new model will initially be available in {% data variables.product.prodname_copilot_chat_short %} for {% data variables.product.prodname_vscode %} and in immersive chat on the {% data variables.product.github %} website. + +To know if you or your organization has access to enable {% data variables.copilot.copilot_claude_sonnet %}, you can check whether the policy is present at the bottom of [your personal {% data variables.product.prodname_copilot_short %} policy settings](https://github.com/settings/copilot). If you don't see a policy for **Anthropic {% data variables.copilot.copilot_claude_sonnet %} for {% data variables.product.prodname_copilot_short %}**, you have not yet received access via the rollout. + +## About {% data variables.copilot.copilot_claude_sonnet %} on GitHub + +{% data variables.copilot.copilot_claude_sonnet %} excels at coding tasks across the entire software development lifecycle, from initial design to bug fixes, maintenance to optimizations. Learn more about the [model's capabilities](https://www.anthropic.com/claude/sonnet) or read the [model card](https://assets.anthropic.com/m/61e7d27f8c8f5919/original/Claude-3-Model-Card.pdf). + +{% data variables.product.prodname_copilot %} uses {% data variables.copilot.copilot_claude_sonnet %} hosted on Amazon Web Services. When using {% data variables.copilot.copilot_claude_sonnet %}, prompts and metadata are sent to Amazon's Bedrock service, which makes the [following data commitments](https://docs.aws.amazon.com/bedrock/latest/userguide/data-protection.html): _Amazon Bedrock doesn't store or log your prompts and completions. Amazon Bedrock doesn't use your prompts and completions to train any AWS models and doesn't distribute them to third parties_. + +When using {% data variables.copilot.copilot_claude_sonnet %}, input prompts and output completions continue to run through {% data variables.product.prodname_copilot %}'s content filters for public code matching, when applied, along with those for harmful, offensive, or off-topic content. + +## Configuring access + +You must enable access to {% data variables.copilot.copilot_claude_sonnet %} before you can use the model. + +{% ifversion fpt %} + +### Setup for individual use + +If you have a {% data variables.product.prodname_copilot_individuals_short %} subscription, you can enable {% data variables.copilot.copilot_claude_sonnet %} in two ways: + +* The first time you choose to use {% data variables.copilot.copilot_claude_sonnet %} with {% data variables.product.prodname_copilot_chat_short %} in {% data variables.product.prodname_vscode %}, or in the immersive view of {% data variables.product.prodname_copilot_chat_short %}, you will be prompted to allow access to the model. + + Clicking **Allow** enables you to use {% data variables.copilot.copilot_claude_sonnet %} and updates the policy in your personal settings on {% data variables.product.github %}. + +* You can enable the model directly in your personal settings on the {% data variables.product.github %} website. See "[AUTOTITLE](/copilot/managing-copilot/managing-copilot-as-an-individual-subscriber/managing-copilot-policies-as-an-individual-subscriber#enabling-or-disabling-claude-35-sonnet)." + +{% endif %} + +### Setup for organization {% ifversion ghec %}and enterprise{% endif %} use + +As an {% ifversion ghec %}enterprise or{% endif %} organization owner, you can enable or disable {% data variables.copilot.copilot_claude_sonnet %} for everyone who has been assigned a {% ifversion ghec %}{% data variables.product.prodname_copilot_enterprise_short %} or {% endif %}{% data variables.product.prodname_copilot_business_short %} seat through your {% ifversion ghec %}enterprise or {% endif %}organization. See "[AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization){% ifversion ghec %}" and "[AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% endif %}." + +## Using {% data variables.copilot.copilot_claude_sonnet %} + +For details of how to change the model for {% data variables.product.prodname_copilot_chat_short %}, see: + +* "[AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#changing-your-ai-model)" +* "[AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide#changing-your-ai-model)" diff --git a/data/reusables/copilot/chat-dotcom-beta.md b/data/reusables/copilot/chat-dotcom-beta.md deleted file mode 100644 index 3d11b9ce0804..000000000000 --- a/data/reusables/copilot/chat-dotcom-beta.md +++ /dev/null @@ -1 +0,0 @@ -{% data variables.product.prodname_copilot_chat %} is currently in {% data variables.release-phases.public_preview %} for users with a {% data variables.product.prodname_copilot_individuals_short %} or {% data variables.product.prodname_copilot_business_short %} subscription. diff --git a/data/reusables/copilot/copilot-chat-models-list.md b/data/reusables/copilot/copilot-chat-models-list.md index 91b33c6f3f46..d5b89de8cb58 100644 --- a/data/reusables/copilot/copilot-chat-models-list.md +++ b/data/reusables/copilot/copilot-chat-models-list.md @@ -1,7 +1,10 @@ The following models are currently available through multi-model {% data variables.product.prodname_copilot_chat_short %}: -* `gpt-4o`: This is the default {% data variables.product.prodname_copilot_chat_short %} model. It is a versatile, multimodal model that excels in both text and image processing and is designed to provide fast, reliable responses. It also has superior performance in non-English languages. -* `o1-preview`: This model is focused on advanced reasoning and solving complex problems, in particular in math and science. It responds more slowly than the `gpt-4o` model. You can make 10 requests to this model per day. -* `o1-mini`: This is the faster version of the `o1-preview` model, balancing the use of complex reasoning with the need for faster responses. It is best suited for code generation and small context operations. You can make 50 requests to this model per day. +* **GPT 4o**: This is the default {% data variables.product.prodname_copilot_chat_short %} model. It is a versatile, multimodal model that excels in both text and image processing and is designed to provide fast, reliable responses. It also has superior performance in non-English languages. Learn more about the [model's capabilities](https://platform.openai.com/docs/models/gpt-4o) and review the [model card](https://openai.com/index/gpt-4o-system-card/). Gpt-4o is hosted on Azure. +* **{% data variables.copilot.copilot_claude_sonnet %}**: This model excels at coding tasks across the entire software development lifecycle, from initial design to bug fixes, maintenance to optimizations. Learn more about the [model's capabilities](https://www.anthropic.com/claude/sonnet) or read the [model card](https://assets.anthropic.com/m/61e7d27f8c8f5919/original/Claude-3-Model-Card.pdf). {% data variables.product.prodname_copilot %} uses {% data variables.copilot.copilot_claude_sonnet %} hosted on Amazon Web Services. +* **o1-preview**: This model is focused on advanced reasoning and solving complex problems, in particular in math and science. It responds more slowly than the `gpt-4o` model. You can make 10 requests to this model per day. Learn more about the [model's capabilities](https://platform.openai.com/docs/models/o1) and review the [model card](https://openai.com/index/openai-o1-system-card/). o1-preview is hosted on Azure. +* **o1-mini**: This is the faster version of the `o1-preview` model, balancing the use of complex reasoning with the need for faster responses. It is best suited for code generation and small context operations. You can make 50 requests to this model per day. Learn more about the [model's capabilities](https://platform.openai.com/docs/models/o1) and review the [model card](https://openai.com/index/openai-o1-system-card/). o1-mini is hosted on Azure. -For more information on these models, see [Models](https://platform.openai.com/docs/models/models) in the OpenAI Platform documentation. +For more information about the o1 models, see [Models](https://platform.openai.com/docs/models/models) in the OpenAI Platform documentation. + +For more information about the {% data variables.copilot.copilot_claude_sonnet %} model from Anthropic, see "[AUTOTITLE](/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot)." diff --git a/data/reusables/copilot/model-picker-enable-o1-models.md b/data/reusables/copilot/model-picker-enable-o1-models.md index 15ae91086087..65a247ddec4c 100644 --- a/data/reusables/copilot/model-picker-enable-o1-models.md +++ b/data/reusables/copilot/model-picker-enable-o1-models.md @@ -1 +1 @@ -1. If you access {% data variables.product.prodname_copilot_chat_short %} through a {% data variables.product.prodname_copilot_business_short %}{% ifversion ghec %} or {% data variables.product.prodname_copilot_enterprise_short %}{% endif %} subscription, your organization{% ifversion ghec %} or enterprise{% endif %} must grant members access to the o1 family of models. See "[AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization){% ifversion ghec %}" or "[AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% endif %}." +1. If you access {% data variables.product.prodname_copilot_chat_short %} through a {% data variables.product.prodname_copilot_business_short %}{% ifversion ghec %} or {% data variables.product.prodname_copilot_enterprise_short %}{% endif %} subscription, your organization{% ifversion ghec %} or enterprise{% endif %} must grant members the ability to switch to a different model. See "[AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/setting-policies-for-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization){% ifversion ghec %}" or "[AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-policies-and-features-for-copilot-in-your-enterprise){% endif %}." diff --git a/data/reusables/user-settings/copilot-settings.md b/data/reusables/user-settings/copilot-settings.md index 5d9eae91dfba..6af5224a5e21 100644 --- a/data/reusables/user-settings/copilot-settings.md +++ b/data/reusables/user-settings/copilot-settings.md @@ -1 +1 @@ -1. In the left sidebar, click **{% octicon "copilot" aria-hidden="true" %} Copilot**. +1. In the upper-right corner of any page on {% data variables.product.prodname_dotcom %}, click your profile photo, then click **{% octicon "copilot" aria-hidden="true" %} Your Copilot**. diff --git a/data/variables/copilot.yml b/data/variables/copilot.yml index 3c5f9a71dc4d..77963d6dc451 100644 --- a/data/variables/copilot.yml +++ b/data/variables/copilot.yml @@ -26,3 +26,6 @@ chat_completions_api: 'https://api.githubcopilot.com/chat/completions' ## Copilot code review - e.g. {% data variables.copilot.copilot_code-review %} copilot_code-review: 'GitHub Copilot code review' copilot_code-review_short: 'Copilot code review' + +## LLM models for Copilot +copilot_claude_sonnet: 'Claude 3.5 Sonnet'